Skip to content

docs: move the documentation to FrontLit - #239

Merged
s3rot0n1n merged 3 commits into
mainfrom
frontlit-docs-content
Oct 31, 2026
Merged

s3rot0n1n merged 3 commits into
mainfrom
frontlit-docs-content

Conversation

@clbotdev

Copy link
Copy Markdown
Contributor

Moves the MediaLit docs from the Fumadocs app (apps/docs) to FrontLit. FrontLit already syncs frontlit/docs/ from main (set up in #238), and the API reference is live at medialit.cloud/docs/api.

Merging this publishes the docs at https://medialit.cloud/docs. docs.medialit.cloud keeps 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

  • 17 pages in frontlit/docs/, one folder per old sidebar section, with _sections.json for the section names and order.
  • Every page keeps its old slug: docs.medialit.cloud/<slug> maps to medialit.cloud/docs/<slug>. The old home page (index.mdx) becomes /docs/introduction.
  • Callouts, Tabs, Steps, Cards and TypeTables keep their MDX syntax; FrontLit renders the same components.
  • npm install fences become a Code group with npm, pnpm, yarn and bun, as Fumadocs showed them.
  • Internal links now point at /docs/..., and API links at /docs/api/<operation> (for example /docs/api/upload-media).
  • The 7 self-hosting screenshots are in the FrontLit media library on cdn.medialit.cloud.
  • One anchor changed: #two-step-upload-flow-drafts--sealing is now #two-step-upload-flow-drafts-sealing, because FrontLit's heading IDs collapse repeated hyphens.

apps/docs is 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

  1. Release FrontLit's redirect domains (frontlit#82) to production.
  2. Add docs.medialit.cloud as a redirect domain (prefix /docs, plus rules for / → /docs/introduction, the 11 /api/<operationId> pages and /rest-api), then point its DNS at FrontLit.
  3. Retire apps/docs and its GitHub Pages workflow, and update links to docs.medialit.cloud in the README and the web app.

s3rot0n1n and others added 3 commits October 31, 2026 20:39
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>
@s3rot0n1n
s3rot0n1n merged commit 915debe into main Oct 31, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants