locorda_core

Platform-agnostic CRDT sync engine — the runtime that drives offline-first conflict resolution, sharded index management, and sync state across BYOB backends (Google Drive, Solid Pods, local directory, and more).

This is an internal implementation package. Most applications should depend on locorda or locorda_flutter, which re-export the public surface of this package. Add locorda_core directly only when building a custom integration (e.g. a new storage backend) without Flutter.

What it contains

Area	Key types
Sync engine	`SyncEngine`, `EngineParams`
CRDT merge	Property-level merge algorithms (LWW, OR-Set, Immutable, G-Register)
Hybrid Logical Clocks	Causality-aware timestamps combining logical and physical time
Index management	Full and Group index sync — sharded, with O(1) change detection
Vocabularies	Generated Dart constants for `algo:`, `crdt:`, `idx:`, `sync:` vocabularies
Layout types	`FilePerResource`, `ShardDataset`, `SingleFile`, `RemoteStorageLayout`

Dependency

dart pub add locorda_core

Only needed for custom backend integrations. For typical app development:

flutter pub add locorda          # Flutter app
dart pub add locorda             # Pure-Dart app

locorda_core

What it contains

Dependency

Further reading

Libraries

locorda_core package