DocsGuides

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 Guide

Security (TLS/mTLS)

Secure your deployment with TLS encryption, mTLS for cluster, and certificate management.

Read Guide

Live Queries

Building reactive applications with real-time query subscriptions.

Read Guide

Indexing

Accelerate queries with HashIndex, NavigableIndex, and InvertedIndex for O(1) to O(log N) lookups.

Read Guide

Full-Text Search

Add fast text search with InvertedIndex and configurable tokenization pipelines.

Read Guide

Adaptive Indexing

Auto-suggest or auto-create indexes based on query patterns with the Index Advisor.

Read Guide

Pub/Sub (Topics)

Using ephemeral topics for real-time messaging and notifications.

Read Guide

Time-To-Live (TTL)

Managing data expiration and garbage collection.

Read Guide

Deployment

How to deploy and scale the TopGun server cluster using Docker and Kubernetes.

Read Guide

Client Cluster Mode

Connect to a multi-node cluster with automatic failover and partition-aware routing.

Read Guide

Cluster Replication

Server-side replication with consistency levels, anti-entropy repair, and automatic failover.

Read Guide

Observability

Monitoring, metrics (Prometheus), and structured logging.

Read Guide

Performance Tuning

Optimize for high throughput, low latency, or balanced production workloads.

Read Guide

Distributed Locks

Coordinating processes with locks and fencing tokens.

Read Guide

Write Concern

Configure acknowledgment levels for write operations to balance performance vs durability.

Read Guide

Entry Processor

Execute atomic read-modify-write operations on the server to solve race conditions.

Read Guide

PN-Counter

Distributed counter supporting increment/decrement with automatic conflict resolution.

Read Guide

Event Journal

Capture all map changes for CDC, audit trails, event replay, and real-time activity feeds.

Read Guide

Conflict Resolvers

Custom server-side conflict resolution beyond LWW for booking systems, inventory, and business rules.

Read Guide

Interceptors

Extend TopGun with custom server-side logic for ML inference, webhooks, and external service integration.

Read Guide

MCP Server

Connect AI assistants like Claude Desktop and Cursor to your TopGun database.

Read Guide