Repository navigation
Migrate the docs to the docs.dev template - #4
Open
avb-dev-docs wants to merge 1 commit into
Open
avb-dev-docs wants to merge 1 commit into
avb-dev-docs wants to merge 1 commit into
Conversation
Replace the Mintlify starter scaffold with the docs.dev template (Fumadocs + pretext + Cloudflare Workers) so these docs get all the features we ship in the template: the pretext reading experience, the /admin editor with review-before-publish drafts, Ask AI, .md/llms.txt agent routes, the OG/MCP endpoints, and push-to-deploy Workers Builds. Content is ported 1:1 from the Mintlify pages into content/docs/ (Mintlify components mapped to Fumadocs equivalents), with sidebar groups mirroring the old docs.json navigation. Keyboard branding replaces docs.dev branding (logo, titles, favicon, landing copy), / redirects to /docs since keyboard.dev is the marketing site, and worker.js 308-redirects the old Mintlify-era URLs to their /docs equivalents so existing links keep working. Co-Authored-By: Claude Fable 5 <[email protected]> Claude-Session: https://claude.ai/code/session_014t4t29GCH4iWKUcgJHKN8T
avb-is-me
marked this pull request as ready for review
July 20, 2026 13:42
This branch has not been deployed
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
2 participants
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.
What
Replaces the Mintlify starter scaffold with our own docs.dev template, so the Keyboard docs get every feature we've been shipping in the template instead of lagging behind it:
/adminin-site editor with review-before-publish shared drafts.mdto any page,/llms.txt,/llms-full.txt, and the/mcpendpointCLAUDE.md+/new-pageand/draft-pageskills so coding agents are productive here out of the boxwrangler.jsonc, worker namekeyboard-docs)Content
All nine Mintlify pages are ported 1:1 into
content/docs/with the same group structure (Getting started / Guides / How it works). Mintlify components are mapped to Fumadocs equivalents (Info/Tip/Note→Callout,AccordionGroup→Accordions, MintlifyTabs→ FumadocsTabs), images moved topublic/images/, and cross-page links converted to site-relative/docs/...paths (this also fixes a few links that already pointed at nonexistent paths).guides/app_builderis renamed toguides/app-builderto satisfy the template's kebab-case slug rule; one typo fixed ("vonnections").Branding & URLs
/redirects to/docs(HOME_REDIRECT_TO_DOCS=true) since keyboard.dev is the marketing site — flip the var inwrangler.jsoncto serve the landing page insteadworker.jspermanently redirects the old Mintlify-era URLs (/getting-started/…,/guides/…,/how-it-works/…) to their/docs/…equivalents so existing inbound links keep workingVerification
pnpm types:checkandpnpm lintpasspnpm dev(checked markers and screenshots: sidebar groups, tabs, callouts, accordions, theme-aware architecture SVGs and logo)/llms.txtand.mdroutes serve the ported contentDeploy notes (post-merge)
This changes hosting from Mintlify to Cloudflare Workers: the repo needs to be connected to Workers Builds and the
docs.keyboard.devDNS pointed at the Worker before/when merging. Requires the Workers Paid plan (bundle > 1 MiB). Secrets (GITHUB_PATor team sign-in viaDOCSDEV_SITE_TOKEN,ADMIN_PIN/ADMIN_SECRET) are only needed for the/admineditor.🤖 Generated with Claude Code
https://claude.ai/code/session_014t4t29GCH4iWKUcgJHKN8T
Generated by Claude Code