Skip to content
Draft
Changes from all commits
Commits
Show all changes
56 commits
Select commit Hold shift + click to select a range
0511073
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
8cf3d1f
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
000c87a
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
0641056
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
7fe8597
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
bb2753f
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
9bafd7c
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
91a728e
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
066f992
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
20367dc
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
ce51bfb
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
141b74f
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
c1611c7
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
845671b
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
7e48096
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
8519934
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
73e6e7c
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
d210a55
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
8a75004
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
8508516
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
ca8fd23
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
9a8463d
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
b9a8cfa
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
4357250
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
b7a4764
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
78825cd
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
61ddfb9
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
3fce642
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
d8d2318
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
38d0555
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
b511cd2
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
6da2089
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
31c71ac
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
2f79512
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
ba4d4af
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
5f5b694
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
e67e475
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
95b2602
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
7362b62
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
71d2d2b
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
bada125
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
d02e527
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
b7bfe6d
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
117090c
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
0093604
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
36c0478
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
83a1b41
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
b07e9b4
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
246bc69
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
cf534f3
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
56ab542
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
554d6bf
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
69327da
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
6ef235f
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
1a0b284
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
a9d4d90
πŸ’Ύ Change 'README.md'
chronoFS Feb 23, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 7 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,15 @@

### Meet Legit SDK β€” fail-safe apps made simple.

Legit SDK is built around **two core ideas**: fail-safe by design, and effortlessly simple to use.
Legit SDKasdasdsadfasdaxycxcsasdwasadasdasdddddddddasdasd built around **two core ideas**: fail-safe ddddddasdasfmΓΆklasmdads

Fail-safe means giving your users the same superpowers you know from Git:
asdsasdasdasby design, **aaasdasdasdasdsadsdsdasdasdasdasdasdfasdasdasdasdsadasdsadasdnd** effortlessly simdpldddddddddddddddddasdasdasdasdasdasdassssfasdasdasdsadasdasdfgdsadssadasdasdasdsasdsadasdasdsadasdasdasdasdasdasdasssssssssssssssssssssssssssssssssssssas assdasdadasdasdasdasddddddesimdplddddddddddddddddddasdasdasdasdasdasdasdasddddddesimdplddddddddddddddddddaasdasdasdasdasdasdasdasddddddesimdplddddddddddddddddddasdasdasdasdasdasdasdasddddddesimdplddddddddddddddddddasdasdasdasdasdasdasdasddddddesimdplddddddddddddddddddasdasdasdasdasdasdsadsadsadasdasdasdasdasddddddesimdplddddddddddddddddddasdasdasdasdasdasdasdasdddddde to use.

Fail-safe means giving your a tsdasdasdasdasdasdasdasdasdasdasdasdhe saasdasdasdasdasdme superpowers you know from Git:

- Roll back to any previous state
- Branch off to run experiments safely
- Accept changes when you’re happy with the result

- asdasdasdasdasdasdAccept changes when you’re happy with the result
And it’s easy because you interact through the **file system API** (Legit FS) β€” the same one you learned in your first semesters of computer science.

**Runs everywhere.** Use Legit SDK as an API in the browser, or mount it as a folder on your machine. That means instant compatibility with the stack of your choice: Node.js, Python, Java… you name it.
Expand All @@ -20,15 +21,16 @@ And it’s easy because you interact through the **file system API** (Legit FS)
- [Getting Started](https://legitcontrol.com/docs/quickstart): Minimal example to get your first LegitFS repo up
- [Example Starter](https://legitcontrol.com/docs/examples): See a working editor demo with history tracking
- [Contributing](./CONTRIBUTING.md): How to contribute, including the Contributor License Agreement

### Installation


```bash
npm install @legit-sdk/core
```

### Minimal example


```ts
import { fs } from 'memfs';
import { initLegitFs } from '@legit-sdk/core';
Expand Down Expand Up @@ -56,18 +58,14 @@ main();
- **Branching and history** – Access past states, branch safely, merge confidently
- **Interoperable** – Works with Node.js, browsers, Docker, serverless, and more
- **Extensible API** – Compatible with custom storage backends

### Project Structure

- `packages/sdk/` – Source code of the SDK
- `packages/sdk/dist/` – Bundled outputs for Node.js, browser, and TypeScript
- `packages/sdk/src/compositeFs/` – Core filesystem abstraction
- `packages/sdk/src/compositeFs/subsystems/` – Ephemeral, hidden, pass-through, and Git-backed file systems

### Contributing

Please review the [CLA](./cla/CLA.md) before submitting contributions.

We welcome PRs, issues, and suggestions to make Legit SDK better for everyone.