DocsGet StartedWelcome

Welcome

Build real-time apps that work offline. Local writes are instant and survive disconnects — reconnecting clients sync automatically without you writing conflict-handling code. Try the live demo to see it in action, or jump straight to the Quickstart to scaffold a working app in under 5 minutes.

What you can build

TopGun is well-suited for collaborative tools, offline-first mobile and desktop web apps, local-first developer tools, and any app where users expect data to survive a flaky connection. You scaffold a React project, drop in a few hooks, and get instant local reads/writes with background sync — no custom sync logic, no conflict resolution ceremony.

When to use TopGun

  • Real-time collaboration — shared docs, whiteboards, live editing
  • Offline-first web and mobile apps — todos, notes, forms that keep working without a signal
  • Local-first developer tools — IDEs, CLI tools, dashboards that feel instant
  • Multi-tab / multi-device sync — changes in one tab appear in another automatically
  • AI-assisted apps — agents can read and mutate live data via the built-in MCP server

When not to use TopGun

  • Pure server-side analytical or reporting workloads where all reads/writes happen server-side
  • Single-writer admin tools where local-first overhead and offline persistence add no value
  • Scenarios requiring strong cross-document ACID transactions across many maps
  • Apps where all clients are always online and eventual consistency is an unacceptable trade-off

Features

Framework Agnostic

Works with React, Vue, Svelte, Solid, or vanilla JS. Zero dependencies on UI frameworks.

Local-First Architecture

The client is the replica. Reads/Writes are instant against local memory.

Offline Capable

Persists to IndexedDB. Queues operations and syncs when online.

Scalable Backend

Server cluster handles partitioning, authority, and durable storage.

Agent-Operable Backend

Built-in MCP server lets Claude, Cursor, and other AI agents query and mutate your live data. See the [AI Builder guide](/docs/guides/building-with-ai) to get started.