Repository navigation
Move docs hosting from GitBook to VitePress on Cloudflare Workers - #150
Merged
Merged
Conversation
GitBook is locking down free accounts. The docs are now a VitePress site served by Workers static assets (the devicecloud-docs Worker), already live at docs.devicecloud.dev. - Content stays where it is. GitBook hints and tabs become VitePress containers; the four screenshots move to assets/ with alt text. - SUMMARY.md still drives the sidebar, and now also each page's URL, using GitBook's scheme, so every existing URL keeps working. - public/_redirects keeps the old redirects; repo-path redirects are generated at build time. - scripts/check-links.mjs fails the build on a broken page link or #anchor. - Branding (logo, colours, fonts, icons) from devicecloud.dev. - deploy.yml builds and checks PRs, and deploys main and each IP sync. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
finalerock44
added a commit
that referenced
this pull request
Nov 2, 2026
main moved the docs from GitBook to VitePress (#150) after this branch was cut. getting-started/devices-configuration.md conflicted in four places; each resolves to this branch's text (iPhone 16 / iOS 26 default, iOS 17 and the iPhone 16 Pros deprecated until 9 November, the three removed devices). The three hint blocks this branch adds are converted from GitBook's {% hint %} to VitePress's ::: containers. npm run build and npm run check pass.
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
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.
GitBook is locking down free accounts, so this moves the docs to VitePress on Cloudflare Workers (static assets, the
devicecloud-docsWorker in the Moropo account).Important
docs.devicecloud.dev already serves this branch. I switched the domain with a manual
wrangler deploy. Please merge soon: until then,mainis behind the live site, and the daily IP-address sync won't reach it.What changed
::: info/::: warning, and the 4 tab groups became::::tabs. The 4 screenshots moved toassets/with alt text, and 2 unused images are deleted.SUMMARY.mdstill sets the sidebar, and it now also sets each page's URL the way GitBook did (/<section>/<title>). All 67 URLs from GitBook's sitemap return 200 on the new site.public/_redirectsand include the existing/cli-reference/mcp-serverone. Redirects from repo paths (e.g./cli/dcd-login) are generated at build time.npm run checkfails on any broken page link or#anchor. It runs on every PR.#0A506F, Inter and Fragment Mono, and the favicons and social image..github/workflows/deploy.ymlbuilds and checks PRs. It deploys on every push tomainand after each IP sync. (That sync's commits useGITHUB_TOKEN, so they can't trigger workflows themselves.) It uses theCLOUDFLARE_API_TOKENrepo secret.CONTRIBUTING.mdcovers local preview, adding pages, callouts and tabs.For reviewers
SUMMARY.mdnow changes its URL. Add a line topublic/_redirectswhen you do.workers.devURL is off now that the custom domain is attached.docs CNAME da914f4c1d-hosting.gitbook.io(DNS only), and remove the Worker's custom domain.Testing
npm run buildandnpm run check: all internal links and anchors pass across 66 pages.docs.devicecloud.dev.🤖 Generated with Claude Code