SyncKit is a production-ready sync engine that makes building local-first applications trivial.

"Add sync.document() to your app, get real-time sync automatically."

The problem: Building sync from scratch takes months. Existing solutions are complex (Yjs), expensive (Firebase), or don't work offline (Supabase).

The solution: SyncKit gives you production-ready sync in 3 lines of code.

const sync = new SyncKit() await sync.init() const doc = sync.document<Todo>('todo-123') await doc.update({ completed: true }) // ✨ Works offline, syncs automatically, resolves conflicts

Real-time collaboration with offline resilience: Watch tasks sync instantly across tabs—even while offline. The example app demonstrates SyncKit's offline-first capabilities combined with smart browser storage to create a seamless collaborative experience.

True offline-first architecture—not just caching. Your app works perfectly on planes, trains, tunnels, and coffee shops with spotty WiFi.

~59 KB gzipped (10KB SDK + 49KB WASM) - Complete WASM-based sync engine with TypeScript SDK.

Current features (v0.1.0):

• ✅ Offline-first sync (LWW)
• ✅ Real-time collaboration
• ✅ Network protocol support
• ✅ IndexedDB persistence
• ✅ Cross-tab sync (see example)

Coming in v0.2.0:

• 🚧 Text CRDTs (character-level editing)
• 🚧 Counters, Sets (distributed data structures)

Size-critical apps? Use Lite variant (~45 KB gzipped: 1.5KB SDK + 44KB WASM, local-only)

Competitive bundle size: Larger than Yjs (~19KB pure JS), smaller than Automerge (~60-78KB).

Open source and self-hostable. No vendor lock-in, no surprise $2,000/month bills, complete data sovereignty.

• <1ms local operations (~5-20μs single field update)
• <100ms sync latency (10-50ms p95)
• ~59KB bundle (10KB SDK + 49KB WASM), ~45KB lite option
• Sub-200KB total with React

• Zero data loss with automatic conflict resolution (Last-Write-Wins)
• Formal verification with TLA+ (3 bugs found and fixed)
• 700+ comprehensive tests across TypeScript and Rust (unit, integration, chaos, load)

TL;DR:

• vs Firebase: No vendor lock-in, true offline, predictable costs
• vs Supabase: Actually works offline (their #1 issue for 4+ years)
• vs Yjs: WASM-based for multi-language server support, simpler API for structured data
• vs Automerge: Smaller bundle, faster performance, production-ready

See detailed migration guides →

npm install @synckit-js/sdk

import { SyncKit } from '@synckit-js/sdk' import { SyncProvider, useSyncDocument } from '@synckit-js/sdk/react' // Initialize (works offline-only, no server needed!) const sync = new SyncKit() await sync.init() function App() { return ( <SyncProvider synckit={sync}> <TodoApp /> </SyncProvider> ) } function TodoApp() { const [todo, { update }] = useSyncDocument<Todo>('todo-1') if (!todo || !todo.text) return <div>Loading...</div> return ( <div> <input type="checkbox" checked={todo.completed} onChange={(e) => update({ completed: e.target.checked })} /> <span>{todo.text}</span>  </div> ) }

That's it! Your app now:

• ✅ Works 100% offline
• ✅ Syncs across tabs automatically
• ✅ Persists data in IndexedDB
• ✅ Resolves conflicts automatically

Bundle: SyncKit (~59 KB gzipped) + React (~130 KB) = ~189 KB total

Size-critical? import { SyncKit } from '@synckit-js/sdk/lite' (~45 KB gzipped, local-only)

Full tutorial (5 minutes) →

• 🔄 Real-Time Sync - WebSocket-based instant sync across devices
• 📴 Offline-First - Works perfectly with zero connectivity
• 🗄️ Local Persistence - IndexedDB storage, unlimited capacity
• 🔀 Conflict Resolution - Automatic Last-Write-Wins (LWW) merge
• ⚡ Fast Operations - <1ms local updates, <100ms sync latency
• 📦 Compact Bundle - ~59KB gzipped (10KB SDK + 49KB WASM)
• 🔐 Secure - JWT authentication, RBAC permissions

• ⚛️ React Hooks - useSyncDocument, useSyncField, SyncProvider
• 🌐 TypeScript Server - Bun + Hono reference implementation
• 📦 Multi-Variant - Default (~59KB gzipped) or Lite (~45KB gzipped) builds

• ✍️ Text CRDTs - Collaborative text editing (character-level sync)
• 🔢 Counters - Conflict-free increment/decrement
• 📋 Sets & Lists - Observed-Remove Sets for collections
• 🎨 Framework Adapters - Vue composables, Svelte stores
• 🌐 Multi-Language Servers - Python, Go, Rust implementations

graph TD A[Your Application<br/>React/Vue/Svelte] --> B[SyncKit SDK<br/>TypeScript] B -->|Simple API| B1[document, text, counter] B -->|Framework adapters| B2[React/Vue/Svelte hooks] B -->|Offline queue| B3[Storage adapters] B --> C[Rust Core Engine<br/>WASM + Native] C -->|80% of use cases| C1[LWW Sync] C -->|Collaborative editing| C2[Text CRDTs] C -->|Advanced features| C3[Custom CRDTs<br/>counters, sets] C --> D[IndexedDB Storage<br/>Your local source of truth] D -.->|Optional| E[SyncKit Server<br/>TypeScript/Python/Go/Rust] E -->|Real-time sync| E1[WebSocket] E -->|Persistence| E2[PostgreSQL/MongoDB] E -->|Security| E3[JWT auth + RBAC] style A fill:#e1f5ff,stroke:#333,stroke-width:2px,color:#1a1a1a style B fill:#fff4e1,stroke:#333,stroke-width:2px,color:#1a1a1a style C fill:#ffe1e1,stroke:#333,stroke-width:2px,color:#1a1a1a style D fill:#e1ffe1,stroke:#333,stroke-width:2px,color:#1a1a1a style E fill:#f0e1ff,stroke:#333,stroke-width:2px,color:#1a1a1a 

Detailed architecture docs →

• 5-Minute Quick Start - Build your first synced app
• Installation Guide - Setup instructions
• API Reference - Complete API documentation

• Offline-First Patterns - True offline architecture
• Conflict Resolution - Automatic LWW merge strategy
• Performance Optimization - Bundle size, memory, sync speed
• Testing Guide - Property-based tests, chaos engineering

• From Firebase/Firestore - Escape vendor lock-in
• From Supabase - Add offline support
• From Yjs/Automerge - Simplify your stack

• Todo App - Simple CRUD with filters
• Collaborative Editor - Real-time text editing with CodeMirror 6
• Project Management - Production-grade kanban app with drag-and-drop

Browse all docs →

Perfect for: Task apps, CRMs, project management, note apps (80% of applications)

// Initialize once const sync = new SyncKit() await sync.init() // Use anywhere const doc = sync.document<Project>('project-123') await doc.update({ status: 'completed' }) // Conflicts resolved automatically with Last-Write-Wins

Perfect for: Collaborative editors, documentation, notes

// Note: Text CRDT API is planned for v0.2.0 const text = sync.text('document-456') await text.insert(0, 'Hello ') text.subscribe(content => editor.setValue(content)) // Character-level sync, conflict-free convergence

Perfect for: Whiteboards, design tools, specialized apps

// Note: Counter API is planned for v0.2.0 const counter = sync.counter('likes-789') await counter.increment() // Conflict-free counter (additions never conflict)

• @synckit-js/sdk - Core SDK (TypeScript) + WASM engine
• @synckit-js/sdk/react - React hooks and components (export from SDK)
• @synckit-js/sdk/lite - Lightweight version (local-only, 45KB gzipped)

• @synckit-js/server - Bun + Hono reference server (production-ready)

Current Version: v0.1.0 Production Ready: Core sync engine, React hooks, TypeScript server ✅

• ✅ Core Rust Engine - LWW sync engine with CRDT foundation
• ✅ WASM Compilation - 59KB gzipped (45KB lite), optimized performance
• ✅ TypeScript SDK - Document API, IndexedDB storage, offline queue
• ✅ Cross-Tab Sync - Server-mediated sync with operation buffering for multi-tab coordination
• ✅ React Integration - useSyncDocument, useSyncField, SyncProvider hooks
• ✅ TypeScript Server - WebSocket sync server with Bun + Hono
• ✅ Example Applications - Todo app, collaborative editor, project management demos
• ✅ Documentation - Comprehensive guides and API reference
• ✅ Build System - Complete toolchain with benchmarks and CI

• 🚧 Text CRDTs - Collaborative text editing (useText hook) for character-level sync
• 🚧 Counter CRDTs - Distributed counters (useCounter hook) for conflict-free increments
• 🚧 BroadcastChannel Cross-Tab - Direct client-to-client sync without server (offline multi-tab)
• 🚧 Framework Adapters - Vue composables (@synckit-js/sdk/vue), Svelte stores (@synckit-js/sdk/svelte)
• 🚧 Multi-Language Servers - Python, Go, Rust server implementations (TypeScript complete)
• 🚧 Advanced Storage - OPFS (Origin Private File System), SQLite adapter
• 🚧 Conflict UI - Visual conflict resolution interface for complex merge scenarios

Full roadmap →

We welcome contributions from the community!

Ways to contribute:

• 🐛 Bug Reports - Open an issue
• 📚 Documentation - Improve guides, fix typos
• 🧪 Tests - Add test coverage
• 🌐 Servers - Implement Python/Go/Rust servers
• 💡 Features - Propose new features in discussions

Contributing guide →

Need enterprise support?

• 🎯 Managed Hosting - We host SyncKit servers for you
• 🔒 Priority Support - 24/7 support, SLA guarantees
• 📊 Monitoring & Analytics - Dashboard, alerts, insights
• 🎓 Training & Consulting - Onboarding, architecture review

Contact: danbitengo@gmail.com

Yjs: ~19 KB ████ SyncKit (lite): ~45 KB █████████ SyncKit (default): ~59 KB ████████████ Automerge: ~60-78 KB ████████████████ Firebase: ~150 KB ████████████████████████████████ 

Local update: <1 ms ████ Cross-tab sync: <1 ms ████ Network sync: 10-50 ms ████████ Firebase (cold): 2-30 s ████████████████████████████████ 

SyncKit: 3 MB ████ Yjs: 8 MB █████████ Automerge: 180 MB ████████████████████████████████████████ 

Detailed benchmarks →

Built with inspiration from:

• Yjs - YATA algorithm and performance optimization
• Automerge - CRDT theory and formal verification
• Linear - Pragmatic approach to sync
• Figma - Custom sync architecture patterns
• RxDB - Local-first database patterns

Special thanks to the local-first community for pioneering this movement.

MIT License - see LICENSE for details.

Copyright (c) 2025 Daniel Bitengo

• Documentation - Complete guides and API reference
• GitHub - Source code
• Issues - Bug reports and features
• Roadmap - Development timeline
• Discussions - Community discussions
• LinkedIn - Connect and follow updates