Learn / Foldkit Plus

Go deeper

The root README is the map. The guides teach the architecture and each package README documents its API.

TopicGuide
Agent contracts and adaptersAgents
Server-owned normalized stateServer-derived state
One domain for the cache, the database, forms, and edit screensOne domain declaration
Local-first replication and the durable server logReplicated state
URL and key-value mirrorsMirrored state
Inside-out view compositionView composition
Running a Foldkit app over a replicaRuntime binding
Design lineage and prior artPrior art and design lineage

The 0.7 release post introduces Entity, Form, and Crud. The documentation map gives the full reading order, package references, design notes, and historical material. The release matrix tracks published versions.

Status

Foldkit Plus is 0.x, built against a 0.x Foldkit and Effect 4. APIs are still settling and minor releases may break. The CHANGELOG records what changed and why.

The repository is exercised as a system: package tests run in CI, README-facing examples are type-checked or pinned as deterministic transcripts, and pnpm demo runs the worked examples together.

Contributing and releasing

bash
pnpm install
pnpm format:check
pnpm typecheck
pnpm test
pnpm demo

See CONTRIBUTING.md for the full development workflow and AGENTS.md for repository working agreements and documentation standards. Release mechanics and the package/version matrix live in docs/releases.md.

License

MIT. These are community packages, published unscoped as Foldkit itself is. They are not affiliated with or endorsed by the Foldkit maintainers, and the names are theirs for the asking.

References