site: replace fumadocs with powderworks-docs - #32
Open
zmaril wants to merge 5 commits into
Open
Conversation
The site was a Next.js application to render twenty-odd pages of markdown. It is now markdown again, plus three hundred lines of generator: every directory becomes a section index listing its children, breadcrumbs come from the path, and nothing at all runs in the browser. - content/ holds the same twenty-two pages as plain .md with title, description, and order frontmatter; Cards became lists and Callouts became blockquotes in the conversion. - The build calls powderworks-docs (github:PowderworksCode/docs) and emits HTML, per-page markdown twins, sitemap.xml, llms.txt, 404.html, and theme.css wherever a page needs it. - The worker still negotiates: Accept: text/markdown on /docs paths now serves the twin sitting beside the page. - Tests keep their teeth: the rules-manifest suite checks the new content paths against the scanner, and meta.json validation became frontmatter validation. Search, OG images, and the language-tab component are gone with the framework; the first can return as a static index when it earns its complexity back.
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
straitjacket | 896bee9 | Commit Preview URL Branch Preview URL |
Aug 22 2026, 10:59 PM |
powderworks-docs now renders the whole content tree as a sticky sidebar on non-landing pages, current page marked in the accent color; the landing stays a single centered column.
Contributor
Author
|
Added the left-hand index list: the whole tree renders as a static sidebar on every page except the landing — current page marked, group headers for sections, collapses to a flat list on narrow screens. Still zero client JS; the highlight is baked in at build time. Refresh |
The shared generator now renders the index list on every page including the landing, in the body serif with black text: bold group headings, current page underlined, no separate nav palette. The docs' About section is renamed Project so the tree no longer shows two Abouts. Pages carry previous and next links that walk the same order the sidebar shows.
Contributor
Author
|
Three changes from the look-over:
|
The landing carries the Wellcome Collection engraving again, centered above the prose; strait-face.png sits beside the site name at the top of the index list and serves as the favicon. The generator now emits the page title as a single h1 on every page, so leaf pages have a visible heading for the first time and the landing does not double its own.
Contributor
Author
|
All three:
|
The Introduction wrapper section is gone: guides, reference, and getting-started are top-level, so the sidebar no longer buries them. Project keeps philosophy, contributing, and license, and gains Contact; Privacy is removed outright. The landing stops emitting the auto-generated listing of every top-level page, which was the block of four links at its foot. Internal links move with the pages; the worker negotiates markdown twins on any path now that twins sit beside everything.
Contributor
Author
|
Restructure from the look-over:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes the era of rendering twenty-odd pages of markdown with a Next.js application.
What this is
cratebank.io's approach, grown into a multi-page generator: powderworks-docs (PowderworksCode/docs, replacing the
@thepowderworks/fumadocspackage entirely). A directory walk turns the content tree into pages and section indexes — every directory is a section whose index lists its children, breadcrumbs come from the path, and nothing runs in the browser.The site
content/holds the same 22 pages as plain.mdwithtitle/description/orderfrontmatter. Cards became link lists, Callouts became blockquotes.sitemap.xml,llms.txt,404.html, and a 27-line theme (system serif, six color tokens, automatic light/dark) copied beside every page.Accept: text/markdownon/docs/*serves the twin beside each page.What's gone with the framework
Search, OG images, language tabs. The first can come back as a static index when it earns its complexity back; the others were adornment.
Verified
Build clean end-to-end on a machine with no special setup beyond
bun install; wrangler dev serves HTML to browsers and markdown twins to agents (Vary: Accept, real 404s);straitjacketscans its own site clean (26 files).🤖 Generated with Claude Code