Automerge Repo is a wrapper for the Automerge CRDT library which provides facilities to support working with many documents at once, as well as pluggable networking and storage.
After cloning this repo, run pnpm install and pnpm build.
This is a monorepo containing the following packages:
- automerge-repo: The core library. Handles dispatch of events and provides shared functionality such as deciding which peers to connect to or when to write data out to storage. Start here.
- automerge-repo-demo-todo: A React-based to-do list.
- automerge-repo-demo-counter: A React-based demonstration application.
- automerge-repo-demo-counter-svelte: A Svelte-based example project.
- sync-server: A very simple sync server which the other examples can use
- Please note this is different from automerge-repo-sync-server
- automerge-repo-react-hooks: Example hooks for use with React.
- automerge-repo-svelte-store: A custom store for use with Svelte.
- automerge-repo-storage-indexeddb: A storage adapter to persist data in a browser
- automerge-repo-storage-nodefs: A storage adapter to write changes to the filesystem
- automerge-repo-network-websocket: Network adapters for both sides of a client/server configuration over websocket
- automerge-repo-network-messagechannel: A network adapter that uses the MessageChannel API to communicate between tabs
- automerge-repo-network-broadcastchannel: Likely only useful for experimentation, but allows simple (inefficient) tab-to-tab data synchronization
Please note that a reference sync-server peer which demonstrates the use of automerge-repo-network-websocket is available at automerge-repo-sync-server (this is different from sync-server).