Guides
Practical, step-by-step guides to help you implement common patterns and features with TopGun.
Authentication
How to integrate authentication providers (Clerk, Better Auth) and secure your sync channels.
Read GuideSecurity (TLS/mTLS)
Secure your deployment with TLS encryption, mTLS for cluster, and certificate management.
Read GuideLive Queries
Building reactive applications with real-time query subscriptions.
Read GuideIndexing
Accelerate queries with HashIndex, NavigableIndex, and InvertedIndex for O(1) to O(log N) lookups.
Read GuideFull-Text Search
Add fast text search with InvertedIndex and configurable tokenization pipelines.
Read GuideAdaptive Indexing
Auto-suggest or auto-create indexes based on query patterns with the Index Advisor.
Read GuidePub/Sub (Topics)
Using ephemeral topics for real-time messaging and notifications.
Read GuideTime-To-Live (TTL)
Managing data expiration and garbage collection.
Read GuideDeployment
How to deploy and scale the TopGun server cluster using Docker and Kubernetes.
Read GuideClient Cluster Mode
Connect to a multi-node cluster with automatic failover and partition-aware routing.
Read GuideCluster Replication
Server-side replication with consistency levels, anti-entropy repair, and automatic failover.
Read GuideObservability
Monitoring, metrics (Prometheus), and structured logging.
Read GuidePerformance Tuning
Optimize for high throughput, low latency, or balanced production workloads.
Read GuideDistributed Locks
Coordinating processes with locks and fencing tokens.
Read GuideWrite Concern
Configure acknowledgment levels for write operations to balance performance vs durability.
Read GuideEntry Processor
Execute atomic read-modify-write operations on the server to solve race conditions.
Read GuidePN-Counter
Distributed counter supporting increment/decrement with automatic conflict resolution.
Read GuideEvent Journal
Capture all map changes for CDC, audit trails, event replay, and real-time activity feeds.
Read GuideConflict Resolvers
Custom server-side conflict resolution beyond LWW for booking systems, inventory, and business rules.
Read GuideInterceptors
Extend TopGun with custom server-side logic for ML inference, webhooks, and external service integration.
Read GuideMCP Server
Connect AI assistants like Claude Desktop and Cursor to your TopGun database.
Read Guide