PrimaDB

PrimaDB is a local-first graph database inspired by Gun, but built around explicit versioned operations, deterministic merge rules, and a transport boundary that stays inspectable.

It is one product with multiple host surfaces:

• Rust crate
• browser WASM runtime
• TypeScript package
• native Node package
• native Python package

The core database model is shared across those targets. Host-specific layers handle browser storage, native storage, relay transport, WebRTC mesh transport, package ergonomics, and callback bridges.

What PrimaDB Already Covers

• graph-shaped documents with nested path traversal
• deterministic merge behavior based on explicit operations and hybrid logical revisions
• query filters, ordering, limits, lexical traversal, and remote watches
• relay-routed replication and relay-signaled mesh replication
• browser and native WebRTC mesh support
• signed values, delegated write certificates, encrypted payloads, and SEA-style browser crypto
• bytes in the graph plus separate blob storage for larger binary payloads
• browser, Node, and Python SDKs with package-local runnable examples

Start Here

• Install and build
• Rust quickstart
• Browser quickstart
• TypeScript package
• Node package
• Python package
• API reference

Core Concepts

• Data model
• Replication and convergence
• Routing and mesh
• Query and watch
• Auth and privacy
• Storage and durability

Examples And Operations

• API reference overview
• Examples overview
• Running examples
• Build targets
• Network hooks
• Versioning and releases
• Verification matrix

Project Status

PrimaDB is still pre-release. The codebase is real and heavily exercised, but the product surface is still moving. That is why the docs site is organized around the current behavior of the repo rather than a frozen public compatibility promise.