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 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

Further reading

Libraries

locorda_core
Core CRDT synchronization logic for Solid Pods.