MamboSite
MamboSite is a Markdown-first static site compiler for Project Mambo. It reads a clean repository-local docs/ tree, uses Rust for parsing and validation, emits typed TypeScript modules and theme CSS, and produces a static Next.js export for deployment to GitHub Pages.
MamboSite does not require Obsidian or prescribe where authors maintain their original notes. Project Mambo uses a separate sync-docs workflow to export selected documents from an Obsidian vault into each repository's docs/ tree.
The initial compiler, React runtime, default theme, Next.js adapter, and check, build, init, and deploy commands are implemented. These documents describe both the current schema-1 behavior and the remaining version-0.1 work; planned features are labeled as such.
Author content
Authoring guide
End-to-end rules and copy-ready patterns for writing MamboSite content.
Content model
Rules for repository content roots, pages, routes, mounts, and metadata.
Markdown and directives
Authoring syntax and component directive contract for MamboSite pages.
Theme and components
Replaceable presentation system using MamboFolio as the initial visual reference.
Configure and operate a site
Documentation sync
Project Mambo's optional Obsidian-to-repository documentation workflow.
Build and deployment
Repository-local content, Rust compilation, Next.js static generation, and GitHub Pages deployment.
Diagnostics and testing
Current error model, validation coverage, tests, and remaining quality gates.
Understand and extend MamboSite
Architecture
System boundaries and repository structure for MamboSite.
Parsing and resolution
Rust parsing pipeline and rules for links, embeds, headings, and assets.
TypeScript output
Generated module schema and the boundary between Rust and the web runtime.
Roadmap
Planned implementation phases, release criteria, non-goals, and open decisions.
The current milestone covers the MamboFolio and MamboWiki integrations, including validated content-asset publication. Fragment transclusion, advanced collection/gallery views, search, and package publication remain planned.