Repository navigation
docs: move the documentation to FrontLit - #239
Merged
Merged
Conversation
Convert the 17 Fumadocs pages in apps/docs into FrontLit Markdown under frontlit/docs/, one folder per sidebar section, keeping every slug so old URLs map 1:1 to /docs/<slug>. - Callouts, Tabs, Steps, Cards and TypeTables keep their MDX syntax. - npm install fences become a Code group with npm, pnpm, yarn and bun. - Internal links point at /docs/... and API links at /docs/api/<op>. - Self-hosting screenshots now come from the FrontLit media library. Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude <noreply@anthropic.com>
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.
Moves the MediaLit docs from the Fumadocs app (
apps/docs) to FrontLit. FrontLit already syncsfrontlit/docs/frommain(set up in #238), and the API reference is live atmedialit.cloud/docs/api.Merging this publishes the docs at
https://medialit.cloud/docs.docs.medialit.cloudkeeps serving the old Fumadocs site until the redirect cutover, so merge when you're ready for both to exist for a short while.What changed
frontlit/docs/, one folder per old sidebar section, with_sections.jsonfor the section names and order.docs.medialit.cloud/<slug>maps tomedialit.cloud/docs/<slug>. The old home page (index.mdx) becomes/docs/introduction.npm installfences become a Code group with npm, pnpm, yarn and bun, as Fumadocs showed them./docs/..., and API links at/docs/api/<operation>(for example/docs/api/upload-media).cdn.medialit.cloud.#two-step-upload-flow-drafts--sealingis now#two-step-upload-flow-drafts-sealing, because FrontLit's heading IDs collapse repeated hyphens.apps/docsis untouched. It goes away in the cutover PR.Checks
I ran FrontLit's own Git importer and publish validation on these files, with the API reference mounted at
api: 17 docs and 7 sections parse, with no broken links or anchors. The FrontLit check on this PR runs the same validation against MediaLit's real setup.Still to do after merging
docs.medialit.cloudas a redirect domain (prefix/docs, plus rules for/→/docs/introduction, the 11/api/<operationId>pages and/rest-api), then point its DNS at FrontLit.apps/docsand its GitHub Pages workflow, and update links todocs.medialit.cloudin the README and the web app.