Local-First Architecture

About

This skill guides the development of applications following the "Breath of Now" local-first architecture. It mandates that all user data is stored and managed within the browser's IndexedDB (using Dexie.js), making it the definitive source of truth. This approach guarantees full offline functionality, enhances performance with instant local data access, and prioritizes user privacy by making cloud synchronization an optional, premium feature. Use this skill when implementing data models, CRUD operations, state management, or sync features to ensure a robust, privacy-first user experience.

Key Features

• Ensures applications are fully functional offline by default.
• Defines a strict separation between persistent data (IndexedDB) and UI state (Zustand).
• Mandates IndexedDB (Dexie.js) as the single source of truth for all application data.
• Implements cloud synchronization as an optional, premium feature.
• 1 GitHub stars
• Provides standardized CRUD patterns for local data management, including soft deletes for sync.

Use Cases

• Implementing new data models or CRUD operations for application features.
• Building or extending the cloud synchronization engine for premium users.
• Refactoring existing features to comply with offline-first and privacy-by-default principles.