Skip to main content
// documentation template

Docusaurus Template

A documentation site styled with the Bubbletea TUI design system — ADRs, specifications, and a dual Gitea + GitHub Pages deploy

make docs-install && make docs-serve

Architecture Decisions

MADR-format ADRs rendered with status, date and decision-maker badges, consequence keywords picked out by hue, and a mini-DAG of every relationship declared in frontmatter.

browse ADRs

Specifications

Requirements with RFC 2119 keywords highlighted in place — MUST in coral, SHOULD in gold, MAY in cyan — each one an anchor you can link someone straight to.

browse specs

Artifact Graph

Every supersedes / extends / governs / implements edge across the whole project, drawn as one mermaid graph and kept honest by the build rather than by hand.

view the graph

Design System

The Bubbletea TUI palette, type scale and components — every badge and callout this site can render, on one page, in both themes.

see the components
docs/adrs/ decisionsdocs/specs/ requirementsmake docs build