Skip to content

docs: add storage backend blueprint landing pages - #42

Merged
bjacobso merged 1 commit into
mainfrom
bjacobso/triplex-blueprint-landing-pages
Oct 8, 2026
Merged

bjacobso merged 1 commit into
mainfrom
bjacobso/triplex-blueprint-landing-pages

Conversation

@bjacobso

@bjacobso bjacobso commented Oct 8, 2026 •

Copy link
Copy Markdown
Owner

Triplex's site explains custom runtimes but has no backend-specific path from storage primitives to a working adapter. Add landing pages at /sqlite, /foundationdb, /datomic, and /xtdb, plus a /backends index linked from the homepage, navigation, and custom runtime guide.

Each blueprint maps storage, transactions, temporal reads, journal/receipts, and query execution to the Triplex contract, with a concrete correction scenario and implementation or conformance steps. SQLite is labeled supported, FoundationDB experimental/private, and Datomic and XTDB proposed with no existing adapters. The proposals explicitly cover the mismatch between Triplex's Effect transaction callback and native declarative/non-interactive writes. The homepage now describes current XTDB's SQL/XTQL model accurately.

Includes shared responsive styling, checked SQLite and FoundationDB examples, agent-readable Markdown exports through the existing documentation pipeline, and refreshed homepage visual snapshots.

Validation:

  • pnpm check passed (formatting, lint, typechecks, checked docs, default tests, package and docs builds).
  • pnpm test:e2e passed: 13 tests, including the refreshed light/dark homepage snapshots.
  • Final production docs build passed; all five routes and Markdown/LLM exports checked in light/dark mode at desktop and mobile widths, including status labels, anchors, valid exported card links, and no page overflow or errors.
  • Executed the SQLite example and verified persistence, duplicate-command rejection, and recovery of the original receipt.

Documentation only; no storage adapters are added or promoted. FoundationDB's example is type-checked but native integration was not run.


Open workspace in Conductor

@bjacobso
bjacobso merged commit 4ce51b9 into main Oct 8, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant