Guides

Make reads instant and writes survive a flight without network — the default behaviour, made explicit.

Two users editing the same record at the same time, conflict-free, with the React hooks.

Fire-and-forget topic messages for chat, presence, and ephemeral signals.

Define maps with Zod, get end-to-end TypeScript inference on reads, writes, and queries.

BM25 full-text search, filtered + sorted queries, and how live subscriptions keep results fresh.

PN-Counter for distributed counts and single-node distributed locks with TTL-based expiry.

Clerk, Better Auth, Firebase, or custom JWT — wiring auth providers and validating tokens server-side.

TLS termination at the proxy, client-side encrypted storage, and credential hygiene.

Connect Claude Desktop, Cursor, or any MCP client to a running TopGun database.

Prompt patterns, AGENTS.md / CLAUDE.md guidance, and the hook-first canonical app shape.

Realtime Database / Firestore → TopGun. Maps, queries, presence, offline.

Channels → topics, postgres_changes → queries, RLS context.

Mutators → CRDT writes, pull/push → built-in delta sync.

Document-level merges via HLC LWW, with a note on where character-level OT differs.

Self-host with Docker, Kubernetes, or a bare binary. Backends (redb default, Postgres optional).

RAM ceilings, eviction water marks, write-behind cadence, and how to read the perf-gate output.

Common errors — auth, IndexedDB, WebSocket, sync state — and how to diagnose them.