Awesome Local-First

Overview

Awesome Local-First provides a comprehensive collection of tools and resources for building local-first software. Local-first software prioritizes keeping user data on the user's device while providing seamless synchronization and collaboration capabilities, ensuring apps work offline and respect data ownership.

Features

• Offline-First Databases: PouchDB, RxDB, WatermelonDB, Gun.js
• Sync Frameworks: Electric SQL, Triplit, PowerSync
• CRDT Libraries: Yjs, Automerge, y-crdt
• Real-Time Collaboration: Libraries for multiplayer experiences
• Data Ownership: User-controlled data storage
• Conflict Resolution: Automatic merging of concurrent edits
• Cross-Device Sync: Seamless data synchronization
• Privacy-Focused: Data stays local by default

Core Concepts

Local-First Principles

• No spinners: App responds immediately to user actions
• Your work is not trapped: Data is accessible and exportable
• Network optional: Full functionality offline
• Seamless collaboration: Multi-device and multi-user support
• Long-term preservation: Data outlives the application
• Security and privacy: End-to-end encryption options
• User control: Users own their data

Databases and Storage

Embedded Databases

• PouchDB: JavaScript database that syncs with CouchDB
• RxDB: Reactive, offline-first database for JavaScript
• WatermelonDB: High-performance reactive database for React and React Native
• SQLite: Embedded SQL database engine
• IndexedDB: Browser-native structured storage

Distributed Databases

• Gun.js: Decentralized graph database
• OrbitDB: Peer-to-peer database for the decentralized web
• IPFS: Content-addressed distributed file system

Sync and Replication

Sync Engines

• Electric SQL: Local-first sync layer for Postgres
• Triplit: Sync engine for building local-first apps
• PowerSync: Postgres sync engine for mobile and web
• Replicache: SDK for building local-first applications
• Zero: Local-first sync layer

Protocols

• CRDTs: Conflict-free Replicated Data Types
• Operational Transformation: Real-time collaborative editing
• Event Sourcing: State reconstruction from events
• Vector Clocks: Distributed system ordering

CRDT Libraries

JavaScript/TypeScript

• Yjs: High-performance CRDT framework
• Automerge: JSON-like data structure for collaborative apps
• y-crdt: Rust port of Yjs
• SyncedStore: Easy-to-use Yjs wrapper

Multi-Language

• Automerge: Rust implementation with WASM bindings
• Diamond Types: High-performance CRDT library
• Loro: Next-generation CRDT framework

Frameworks and Tools

Application Frameworks

• TinyBase: Reactive data store for local-first apps
• Jazz: Toolkit for building local-first apps
• Braid: Protocol for synchronization
• Livestore: Real-time database for local-first

Real-Time Collaboration

• Liveblocks: Platform for collaborative experiences
• PartyKit: Multiplayer infrastructure
• Drifting in Space: Collaborative application platform

Editor Integration

• ProseMirror: Collaborative rich-text editing
• CodeMirror: Code editor with collaboration
• Quill: Rich text editor with delta sync
• Slate: Customizable framework for rich text editors

Use Cases

Productivity Apps

• Note-taking applications
• Task managers
• Document editors
• Spreadsheets
• Mind mapping tools

Collaboration Tools

• Real-time document editing
• Whiteboarding applications
• Code collaboration
• Design tools

Mobile Applications

• Offline-capable mobile apps
• Field data collection
• Healthcare applications
• Point-of-sale systems

Best Practices

Architecture

• Cache local data aggressively
• Sync in background
• Handle conflicts gracefully
• Design for offline-first
• Implement optimistic updates

Performance

• Lazy load data
• Index for fast queries
• Minimize sync payload
• Use incremental updates
• Batch operations

Security

• End-to-end encryption
• Authentication and authorization
• Data validation
• Secure sync protocols

Resources

• Local-First Web Development (localfirstweb.dev)
• Ink & Switch research
• Martin Kleppmann's work on CRDTs
• CRDT.tech resources

Pricing

Primarily free and open-source tools, with some commercial sync services.