🍪 CRUMB · Guided tours
A tour of the real thing, not a copy of it.
CRUMB is the stack's guided-tour, demo-mode, and AI-review layer. A tour is one markdown file; CRUMB turns it into a walkthrough that highlights real, live surfaces in your running app, one at a time, using GRAIN's own traveling lamp. It never edits your app or your data, it only reads and highlights. The same tour doubles as an AI-review walkthrough when you flip it to dev mode.
Live · the "Tour" entry point on this site runs on this exact packageTours are markdown
One file, minimal frontmatter, then a body where every step heading is a step. No separate steps array to keep in sync with the prose.
Never writes, only reads
CRUMB highlights the live app; it never edits it, and it never writes back to the tour file. Delete CRUMB and the tours stay readable markdown.
Two modes, one component
Demo mode is an onboarding walkthrough. Dev mode is a post-change AI review, review/status/verify added per step. Same tour, one attribute flips.
Reuses, doesn't rebuild
It borrows GRAIN's lamp for the spotlight and MILL's frontmatter parser for the grammar, rather than shipping either again. A thin layer on top of both.
CRUMB depends on GRAIN and MILL, both
already installed and wired into the host app. This site's own guided tour
(content/tours/portfolio.md) is the worked example: the "Tour" entry point on the desk
launches it through the crumb frame. The grammar, the two read-only routes it serves, and the design
law are written up in the CRUMB plan that ships beside the code.
Part of the BREAD stack, alongside BATCH, GRAIN, MILL, PROOF, and PANTRY.
🤖 Built with Claude. I don't prompt and pray, I prompt and prove. Every commit here is co-authored with an AI, on purpose. How I actually work with AI, receipts and all →