🧠 Storage System

Offline-first storage with intelligent adapter selection, auto-persistent signals, and optional backend sync. Session 166.3 added BackendSyncEngine and syncToBackend() for fire-and-forget backend persistence.

🚀 Quick Start

Getting Started ⭐ START HERE

5-minute setup: provider config, autoFlashState, BackendSyncEngine, migration from localStorage/NGXS.

Overview

Architecture diagram, adapter selection, MongoDB + Socket.IO + Yjs, performance table.

Known Issues

Current issues and solutions (e.g. Flash Persistence race condition).

Storage Intelligence Quick Reference

One-page reference for adapter selection and best practices.

📚 Implementation

Implementation Guides

• API Reference — Complete API (BackendSyncEngine, syncToBackend, autoFlashState)
• Common Mistakes — Anti-patterns and best practices
• BackendSyncEngine Guide — Fire-and-forget backend sync (Session 166.3)

🎯 Core Features

• autoFlashState — Auto-persistent signals (0.3ms reads, IndexedDB)
• BackendSyncEngine — Fire-and-forget backend sync with retry queue
• GgStorage — Intelligent adapter selection (OPFS, Dexie, localStorage)
• Cross-tab sync — Automatic state propagation
• 20GB+ capacity — OPFS + IndexedDB + localStorage

📖 Architecture

• Flash Persistence + Conversation Genome — Chat persistence, reusable patterns, anti-patterns

📦 Archive

Deprecated docs (Nov 2025, Session 170 consolidation): archive/

Session 166.3: BackendSyncEngine, syncToBackend(), two-signal pattern.
Session 170: Documentation consolidation (30+ → 7 active files).