AeroToys
Open foundation · Alpha

DocumentForge

The open, document-native order database under the AeroToys stack. An embedded JSON document store engineered for the shape and scale of airline offers and orders — store JSON, query with SQL, add persistent indexes, then scale the same engine out to replication and sharding. One binary, or a single package.

<1ms
Reads
SQL
Over JSON
Apache 2.0
Open licensed
1
Binary, zero deps

JSON-native, SQL-fluent

Nested paths, arrays, joins, aggregations, composite indexes — store JSON, query it with SQL.

Sub-millisecond lookups

A direct-address location map, mainframe-inspired, for predictable low-latency reads.

Durable by design

Write-ahead log, per-page checksums, crash recovery — built to be trusted with orders.

Scales with you

Logical replication, auto-failover, consistent-hash sharding — when you grow into them, not before.

Embedded or served

Run in-process as a single dependency, or behind an HTTP API via dfdb serve.

Explore the docs Concepts, guides, REST/SQL/SDK reference, migration.
Under the hood

The full capability set.

Everything DocumentForge ships today — from indexing and query through durability, replication, and sharding, to the tooling around them.

01

Persistent B-tree indexes

Unique, composite and nested-path indexes that survive restart — no rebuild on startup, and they self-heal if the catalog is damaged.

02

Nested paths & arrays

Index and query deep structure like passenger.lastName or flights[0].from directly.

03

Joins & aggregations

Query across collections, with COUNT / SUM / AVG / MIN / MAX and GROUP BY.

04

Typed LINQ

Strongly-typed queries over the same documents, with consistent camelCase JSON.

05

Overflow pages

Documents larger than a page are transparently chained — no hard size cliff.

06

Write-ahead recovery

Every change is logged with a CRC32 before pages are touched; uncommitted writes replay on startup.

07

Page checksums

Silent corruption is caught on every read, not months later.

08

Logical replication

Monotonic sequence numbers, catchup on reconnect, heartbeats, and automatic follower promotion.

09

Consistent-hash sharding

Add a shard without re-routing all data; replicated reference collections keep joins local.

10

Multi-database hosting

One process hosts many attached databases, LocalDB-style, each with its own cache, WAL and indexes.

11

One-binary CLI

dfdb does it all: serve, repl, query, seed, router, cluster, health, rebalance.

12

Visual cluster builder

Design a cluster on a canvas, export cluster.json, and spawn the router — without hand-editing config.

A visual control plane — DocumentForge Studio — ships with the engine. Screens and a full Studio guide are on the way.

Part of the open AeroToys stack.

DocumentForge powers the order data layer. Pair it with RuleForge for rules, and the engines above for tax, offers, and stock.