Skip to content

Replace Docusaurus with Fumadocs v10.1.2#414

Open
Copilot wants to merge 2 commits intomasterfrom
copilot/replace-docusaurus-with-fumadocs-again
Open

Replace Docusaurus with Fumadocs v10.1.2#414
Copilot wants to merge 2 commits intomasterfrom
copilot/replace-docusaurus-with-fumadocs-again

Conversation

Copy link
Contributor

Copilot AI commented Dec 28, 2025

Migrated the Casbin documentation site from Docusaurus to Fumadocs v10.1.2 as a Next.js 14 application.

Changes

Core Framework

  • Removed: Docusaurus 3.9.2 and all related dependencies
  • Added: Fumadocs v10.1.2 (fumadocs-ui@10.1.2, fumadocs-core@10.1.2)
  • Added: Next.js 14.2.0 with App Router
  • Added: Tailwind CSS 3.4 with Fumadocs preset

Configuration

  • next.config.mjs - Next.js config with @next/mdx support
  • tailwind.config.js - Tailwind with Fumadocs UI preset
  • tsconfig.json - TypeScript configuration for Next.js
  • eslint.config.mjs - ESLint 9.0 flat config (replaces legacy .eslintrc)
  • Updated package.json scripts: dev, build, serve now use Next.js

Application Structure

app/
├── layout.tsx          # Root layout with RootProvider
├── page.tsx            # Home page
├── global.css          # Tailwind base styles
└── docs/
    ├── layout.tsx      # Docs layout with DocsLayout component
    ├── overview/       # Sample doc page
    └── get-started/    # Sample doc page

Preserved Files

  • Old Docusaurus files renamed with .backup or moved to src.docusaurus.backup/
  • Original docs/ content intact for future migration
  • Static assets, blog, and i18n folders preserved

Screenshots

Home Page:
Home Page

Documentation Page with Sidebar:
Docs Overview

What Works

  • Build succeeds: yarn build generates static output
  • Dev server: yarn dev runs on localhost:3000
  • Fumadocs UI: Navigation, sidebar, theme toggle, search UI
  • Two sample documentation pages demonstrate the pattern

Remaining Work

  • Migrate 60+ MDX files from docs/ to app/ structure
  • Port sidebar configuration from sidebars.js
  • Recreate custom components and styling
  • Add blog, ecosystem, editor, gallery, help pages
  • Configure i18n for 17 languages
Original prompt

This section details on the original issue you should resolve

<issue_title>[feature] replace Docusaurus with Fumadocs v10.1.2</issue_title>
<issue_description>https://www.fumadocs.dev/</issue_description>

<agent_instructions>migrating from Docusaurus to Fumadocs </agent_instructions>

Comments on the Issue (you are @copilot in this section)


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@netlify
Copy link

netlify bot commented Dec 28, 2025

Deploy Preview for casbin failed.

Name Link
🔨 Latest commit b590f19
🔍 Latest deploy log https://app.netlify.com/projects/casbin/deploys/6950c5c9dae7f1000825b069

@CLAassistant
Copy link

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Co-authored-by: tjyyy3 <97741063+tjyyy3@users.noreply.github.com>
Copilot AI changed the title [WIP] Migrate from Docusaurus to Fumadocs v10.1.2 Replace Docusaurus with Fumadocs v10.1.2 Dec 28, 2025
Copilot AI requested a review from tjyyy3 December 28, 2025 05:56
@hsluoyz hsluoyz marked this pull request as ready for review December 28, 2025 07:30
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.

[feature] replace Docusaurus with Fumadocs v10.1.2

3 participants