Architecture Overview

StrataDB is built as a layered system. Scroll down to explore each layer and understand how the pieces fit together.

API Layer

Executor Layer

Primitives Layer

Transaction Layer

Storage Engine

Durability Layer

API Layer

The public interface — CLI, SDKs, and MCP protocol handlers.

CLI REPL with command parsing
Python and Node.js SDK bindings
MCP (Model Context Protocol) server
Input validation and serialization

Learn more

API Layer

The public interface — CLI, SDKs, and MCP protocol handlers.

Learn more →

Executor Layer

Command routing and orchestration across primitives.

Learn more →

Primitives Layer

The six data structures — KV, Events, State, JSON, Vectors, Branches.

Learn more →

Transaction Layer

Optimistic concurrency control with snapshot isolation.

Learn more →

Storage Engine

ShardedStore with MVCC, versioning, and key structure.

Learn more →

Durability Layer

WAL, snapshots, and three durability modes.

Learn more →

Deep Dive Documentation

Crate Structure

7-crate workspace organization and dependencies.

Storage Engine

ShardedStore, MVCC, and key structure design.

Durability & Recovery

WAL, snapshots, and crash recovery flow.

Concurrency Model

OCC lifecycle and conflict detection.

Concurrency Invariants

Thread-safety guarantees and proof outlines.

Branch Primitive

Copy-on-write branching implementation.

KV Primitive

Key-value store with versioning and scans.

Event Primitive

Append-only log implementation.

Vector Primitive

HNSW index and similarity search.

Error Propagation

Error types and handling strategies.

Boundary Conditions

Edge cases and system limits.

Version Semantics

Version numbering and compatibility.