locorda_core 0.5.0
locorda_core: ^0.5.0 copied to clipboard
Locorda Core - Platform-agnostic CRDT synchronization engine
locorda_core #
Platform-agnostic CRDT synchronization engine — the runtime that drives offline-first sync, conflict resolution, and index management for Locorda.
This is an internal implementation package. Most applications should depend on
locordaorlocorda_flutter, which re-export the public surface of this package. Addlocorda_coredirectly 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
Further reading #
- locorda — recommended entry point
- Architecture overview