[PR #4154] [MERGED] chore: update to Fumadocs 15.7 #30826

Closed
opened 2026-04-17 21:50:36 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/better-auth/better-auth/pull/4154
Author: @fuma-nama
Created: 8/22/2025
Status: Merged
Merged: 8/23/2025
Merged by: @himself65

Base: canaryHead: canary


📝 Commits (9)

📊 Changes

32 files changed (+6407 additions, -4526 deletions)

View changed files

📝 docs/app/blog/[[...slug]]/page.tsx (+16 -3)
📝 docs/app/changelogs/[[...slug]]/page.tsx (+16 -3)
📝 docs/app/docs/[[...slug]]/page.tsx (+53 -114)
📝 docs/app/docs/layout.tsx (+2 -21)
📝 docs/app/docs/lib/get-llm-text.ts (+3 -2)
📝 docs/app/global.css (+1 -2)
📝 docs/app/layout.config.tsx (+1 -20)
📝 docs/app/reference/route.ts (+2 -4)
docs/components/docs/docs.client.tsx (+49 -0)
docs/components/docs/docs.tsx (+57 -0)
docs/components/docs/layout/nav.tsx (+93 -0)
docs/components/docs/layout/theme-toggle.tsx (+87 -0)
docs/components/docs/layout/toc-thumb.tsx (+73 -0)
docs/components/docs/layout/toc.tsx (+345 -0)
docs/components/docs/page.client.tsx (+254 -0)
docs/components/docs/page.tsx (+298 -0)
docs/components/docs/shared.tsx (+24 -0)
docs/components/docs/ui/button.tsx (+22 -0)
docs/components/docs/ui/collapsible.tsx (+39 -0)
docs/components/docs/ui/popover.tsx (+32 -0)

...and 12 more files

📄 Description

  1. forked the corresponding version of Fumadocs UI using customise command.

  2. I found BetterAuth uses a very different way for sidebar items. We have our built-in routing structure which should be able to suffice the needs of BetterAuth.

To avoid making too many changes, I made a custom sidebar items -> page tree function, so Fumadocs' page tree functionality works, removing some hacks around Fumadocs.


Summary by cubic

Upgraded the docs app to Fumadocs 15.7 and replaced Fumadocs UI usage with local, customized components to integrate our BetterAuth-style sidebar while preserving Fumadocs’ page tree, TOC, and navigation behavior. This removes hacks, unifies sidebar/page navigation, and updates MDX plugins.

  • Refactors

    • Forked and localized DocsLayout/DocsPage/Sidebar/TOC/Nav components; switched docs pages to these imports.
    • Built PageTree from existing sidebar-content (contents/examples) and attached it to source.pageTree for consistent sidebar, root tabs, and prev/next Footer.
    • Simplified blog/changelog pages to use prose wrappers; removed ad-hoc next/prev link logic.
    • Switched MDX docgen plugin from remarkInstall to remarkNpm; cleaned global CSS @source usage.
    • Simplified Scalar ApiReference route and minor layout/config tweaks.
  • Dependencies

    • Bumped fumadocs-core/ui to 15.7.1 and refreshed Radix, cmdk, motion, next-themes, jotai, sonner, etc.; lockfile updated.
    • Dev script now uses next dev --turbopack.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/better-auth/better-auth/pull/4154 **Author:** [@fuma-nama](https://github.com/fuma-nama) **Created:** 8/22/2025 **Status:** ✅ Merged **Merged:** 8/23/2025 **Merged by:** [@himself65](https://github.com/himself65) **Base:** `canary` ← **Head:** `canary` --- ### 📝 Commits (9) - [`f965090`](https://github.com/better-auth/better-auth/commit/f965090dceac233dcd030fa6ad0ac80b6d08fc4c) update to Fumadocs 15.7 - [`184b7d9`](https://github.com/better-auth/better-auth/commit/184b7d9ca3801d1de7e567deae2b9bc451fa5f26) inherit page tree from custom sidebar items - [`70b947a`](https://github.com/better-auth/better-auth/commit/70b947a07db33519d31a93e7d5ed052904c23e03) remove unused files - [`e89ee76`](https://github.com/better-auth/better-auth/commit/e89ee7644876ef2dd2d3a22629e69a258e7abdda) remove unused files - [`a54d601`](https://github.com/better-auth/better-auth/commit/a54d60151054a8be0b8c89260cfb6a1856d9f410) Merge branch 'canary' into canary - [`81791cd`](https://github.com/better-auth/better-auth/commit/81791cd4bdedb2adfedbb3aa5209b67207ed6f1c) lint - [`e31a4bb`](https://github.com/better-auth/better-auth/commit/e31a4bbfc557ce46a675046b52769b9645929566) lint - [`fd88eee`](https://github.com/better-auth/better-auth/commit/fd88eeeb510111803dfe10b3e3a16d230e877a37) update - [`72e6d3f`](https://github.com/better-auth/better-auth/commit/72e6d3f949b6989dfaef45c125c3c5fafff8c8bc) depricated update ### 📊 Changes **32 files changed** (+6407 additions, -4526 deletions) <details> <summary>View changed files</summary> 📝 `docs/app/blog/[[...slug]]/page.tsx` (+16 -3) 📝 `docs/app/changelogs/[[...slug]]/page.tsx` (+16 -3) 📝 `docs/app/docs/[[...slug]]/page.tsx` (+53 -114) 📝 `docs/app/docs/layout.tsx` (+2 -21) 📝 `docs/app/docs/lib/get-llm-text.ts` (+3 -2) 📝 `docs/app/global.css` (+1 -2) 📝 `docs/app/layout.config.tsx` (+1 -20) 📝 `docs/app/reference/route.ts` (+2 -4) ➕ `docs/components/docs/docs.client.tsx` (+49 -0) ➕ `docs/components/docs/docs.tsx` (+57 -0) ➕ `docs/components/docs/layout/nav.tsx` (+93 -0) ➕ `docs/components/docs/layout/theme-toggle.tsx` (+87 -0) ➕ `docs/components/docs/layout/toc-thumb.tsx` (+73 -0) ➕ `docs/components/docs/layout/toc.tsx` (+345 -0) ➕ `docs/components/docs/page.client.tsx` (+254 -0) ➕ `docs/components/docs/page.tsx` (+298 -0) ➕ `docs/components/docs/shared.tsx` (+24 -0) ➕ `docs/components/docs/ui/button.tsx` (+22 -0) ➕ `docs/components/docs/ui/collapsible.tsx` (+39 -0) ➕ `docs/components/docs/ui/popover.tsx` (+32 -0) _...and 12 more files_ </details> ### 📄 Description 1. forked the corresponding version of Fumadocs UI using `customise` command. 2. I found BetterAuth uses a very different way for sidebar items. We have our built-in [routing](https://fumadocs.dev/docs/ui/page-conventions) structure which should be able to suffice the needs of BetterAuth. To avoid making too many changes, I made a custom sidebar items -> page tree function, so Fumadocs' page tree functionality works, removing some hacks around Fumadocs. <!-- This is an auto-generated description by cubic. --> --- ## Summary by cubic Upgraded the docs app to Fumadocs 15.7 and replaced Fumadocs UI usage with local, customized components to integrate our BetterAuth-style sidebar while preserving Fumadocs’ page tree, TOC, and navigation behavior. This removes hacks, unifies sidebar/page navigation, and updates MDX plugins. - **Refactors** - Forked and localized DocsLayout/DocsPage/Sidebar/TOC/Nav components; switched docs pages to these imports. - Built PageTree from existing sidebar-content (contents/examples) and attached it to source.pageTree for consistent sidebar, root tabs, and prev/next Footer. - Simplified blog/changelog pages to use prose wrappers; removed ad-hoc next/prev link logic. - Switched MDX docgen plugin from remarkInstall to remarkNpm; cleaned global CSS @source usage. - Simplified Scalar ApiReference route and minor layout/config tweaks. - **Dependencies** - Bumped fumadocs-core/ui to 15.7.1 and refreshed Radix, cmdk, motion, next-themes, jotai, sonner, etc.; lockfile updated. - Dev script now uses next dev --turbopack. <!-- End of auto-generated description by cubic. --> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-04-17 21:50:36 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/better-auth#30826