Stop building "dumb" clients. TopGun turns your client into a replica. Zero-latency reads/writes, offline-first reliability, and real-time sync powered by CRDTs and Merkle Trees.
import { TopGun } from '@topgunbuild/client';
// 1. Initialize Local-First DB
const db = new TopGun({
sync: 'wss://api.topgun.build',
persist: 'indexeddb'
});
// 2. Zero-Latency Write (Optimistic)
await db.todos.set({
id: 'task-1',
text: 'Ship v2',
status: 'pending'
}); // Resolves in ~0.5msTwo devices, one session — watch CRDT conflict resolution happen in real time. Open in a new tab for multi-tab sync.
TopGun bridges the gap between scalable In-Memory Data Grids and Offline-First Client Databases.
Reads and writes happen locally against an in-memory CRDT. The UI updates in <16ms (one frame) using Optimistic UI patterns by default. No spinners, no waiting.
The network is optional. Data is automatically persisted to IndexedDB (Browser) or SQLite (Mobile/Desktop) and synced when connectivity returns.
Efficient bandwidth usage. We only exchange the modified leaves of the Merkle Tree, drastically reducing data transfer costs compared to REST/GraphQL.
A server-authoritative cluster that coordinates HLC (Hybrid Logical Clocks) and persists to standard databases like PostgreSQL or Mongo. You own your data.
Automatic convergence via CRDTs. No manual conflict resolution code required for standard operations.
Pessimistic locking with fencing tokens prevents split-brain scenarios. Essential for critical operations like payments or inventory updates.
Push-based architecture via WebSockets ensures all active clients receive updates instantly.
TopGun inverts the traditional model. The client is the primary source of truth for the UI, while the server ensures eventual consistency and persistence.
The only solution that combines the speed of an In-Memory Data Grid with robust Offline-First capabilities.
| Feature | TopGun | ElectricSQL | Firebase | RxDB |
|---|---|---|---|---|
| Primary Model | Local-First IMDG | Postgres Sync | Cloud Doc DB | Local-First DB |
| Offline Support | First-Class | Good | Good | Excellent |
| Latency | ~0ms (In-Memory) | ~5-10ms (SQLite) | Network Dependent | ~5-10ms (IndexedDB) |
| Backend Control | Self-Hosted Cluster | Sync Service | Proprietary | CouchDB / Custom |
| Consistency | HLC + CRDT | Rich CRDTs | LWW (Server) | Revision Trees |
| Distributed Locks | Fencing Tokens | Not Supported | Not Supported | Not Supported |
| License | Open Source | Open Source | Proprietary | Open Source |