[PR #4168] [MERGED] [cherry-pick] docs update #22133

Closed
opened 2026-04-15 20:50:37 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/better-auth/better-auth/pull/4168
Author: @himself65
Created: 8/23/2025
Status: Merged
Merged: 9/2/2025
Merged by: @himself65

Base: mainHead: himself65/2025/08/22/cherry-pick


📝 Commits (10+)

📊 Changes

45 files changed (+7196 additions, -4571 deletions)

View changed files

📝 demo/nextjs/package.json (+1 -1)
📝 docs/app/blog/[[...slug]]/page.tsx (+16 -3)
📝 docs/app/changelogs/[[...slug]]/page.tsx (+16 -3)
📝 docs/app/docs/[[...slug]]/page.tsx (+55 -118)
📝 docs/app/docs/layout.tsx (+2 -21)
📝 docs/app/docs/lib/get-llm-text.ts (+3 -2)
📝 docs/app/global.css (+9 -4)
📝 docs/app/layout.config.tsx (+1 -20)
📝 docs/app/reference/route.ts (+2 -4)
docs/components/api-method-tabs.tsx (+98 -0)
📝 docs/components/api-method.tsx (+31 -25)
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)

...and 25 more files

📄 Description

Summary by cubic

Cherry-picks the Fumadocs 15.7 update and rebuilds the docs UI with custom layout, TOC, and code blocks for a cleaner, more consistent docs experience. Also bumps Next.js to 15.5 and refreshes related deps.

  • Refactors

    • Replaced fumadocs UI page/layout with custom components: DocsLayout, DocsPage, TOC (sticky + popover), ThemeToggle, Footer, Breadcrumb, and Navbar.
    • Added unified Callout and CodeBlock (tabs, copy button, scroll area) and wired into MDX for docs, blogs, and changelogs.
    • Simplified docs page: removed manual prev/next logic and card UI; use Footer derived from page tree.
    • Built the page tree from sidebar-content and injected into source.pageTree.
    • Switched MDX plugins: remarkInstall → remarkNpm; added remarkAutoTypeTable with generator; updated LLM text processor accordingly.
    • Minor UI/structural tweaks: “prose” wrappers, RTL-safe sidebar positioning, TOC styles, CSS imports, and Popover/Collapsible/ScrollArea utilities.
    • API Reference: inline GET handler via ApiReference(...) call.
  • Dependencies

    • Next.js: docs, demo, and dev deps → 15.5.x; enabled turbopack; set type: module in docs.
    • Fumadocs: core/ui → 15.7.x, mdx → 11.8.x, typescript → 4.x, docgen → 2.1.x.
    • Radix and assorted UI libs bumped; added gray-matter and js-beautify; lockfile updated.

🔄 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/4168 **Author:** [@himself65](https://github.com/himself65) **Created:** 8/23/2025 **Status:** ✅ Merged **Merged:** 9/2/2025 **Merged by:** [@himself65](https://github.com/himself65) **Base:** `main` ← **Head:** `himself65/2025/08/22/cherry-pick` --- ### 📝 Commits (10+) - [`d5e89d0`](https://github.com/better-auth/better-auth/commit/d5e89d0bd8e06a153142cdc61c7753691e637c81) chore: bump `next.js` (#4135) - [`1230bc0`](https://github.com/better-auth/better-auth/commit/1230bc09299462522213717b4e381bc49f40162f) chore: bump fumadocs (#4144) - [`f243314`](https://github.com/better-auth/better-auth/commit/f243314d0a92821e695c529b2eb67de482228434) docs: revert `fumadocs` (#4147) - [`9fb4af2`](https://github.com/better-auth/better-auth/commit/9fb4af2c8402fc23cea0cd68414bf10c8ad4f794) chore: update to Fumadocs 15.7 (#4154) - [`3fae4ab`](https://github.com/better-auth/better-auth/commit/3fae4ab675d880f17b8fb6f3f65280139e87b40e) docs: fix scrolling issue (#4169) - [`dde9f1e`](https://github.com/better-auth/better-auth/commit/dde9f1e50b077d309b2ff0a3436bf7c189309da8) docs: fix kick icon - [`dd16758`](https://github.com/better-auth/better-auth/commit/dd1675855ca9518283e5bc2d75af5b463eff76bf) docs: fix facebook icon color - [`c33f1c9`](https://github.com/better-auth/better-auth/commit/c33f1c9a35c903b2b6d935e5f78bde10d90698ba) docs: add docs for one time token client plugin (#4220) - [`17123a7`](https://github.com/better-auth/better-auth/commit/17123a7da3b8e5c829b7a1c3254363cf2d3ab91b) docs(admin): Fix calculation of total pages using pageSize (#4233) - [`cadd195`](https://github.com/better-auth/better-auth/commit/cadd195583c6f30b5bd3661fe6fa00591f88dde4) docs(email-otp): correct error code (#4234) ### 📊 Changes **45 files changed** (+7196 additions, -4571 deletions) <details> <summary>View changed files</summary> 📝 `demo/nextjs/package.json` (+1 -1) 📝 `docs/app/blog/[[...slug]]/page.tsx` (+16 -3) 📝 `docs/app/changelogs/[[...slug]]/page.tsx` (+16 -3) 📝 `docs/app/docs/[[...slug]]/page.tsx` (+55 -118) 📝 `docs/app/docs/layout.tsx` (+2 -21) 📝 `docs/app/docs/lib/get-llm-text.ts` (+3 -2) 📝 `docs/app/global.css` (+9 -4) 📝 `docs/app/layout.config.tsx` (+1 -20) 📝 `docs/app/reference/route.ts` (+2 -4) ➕ `docs/components/api-method-tabs.tsx` (+98 -0) 📝 `docs/components/api-method.tsx` (+31 -25) ➕ `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) _...and 25 more files_ </details> ### 📄 Description <!-- This is an auto-generated description by cubic. --> ## Summary by cubic Cherry-picks the Fumadocs 15.7 update and rebuilds the docs UI with custom layout, TOC, and code blocks for a cleaner, more consistent docs experience. Also bumps Next.js to 15.5 and refreshes related deps. - **Refactors** - Replaced fumadocs UI page/layout with custom components: DocsLayout, DocsPage, TOC (sticky + popover), ThemeToggle, Footer, Breadcrumb, and Navbar. - Added unified Callout and CodeBlock (tabs, copy button, scroll area) and wired into MDX for docs, blogs, and changelogs. - Simplified docs page: removed manual prev/next logic and card UI; use Footer derived from page tree. - Built the page tree from sidebar-content and injected into source.pageTree. - Switched MDX plugins: remarkInstall → remarkNpm; added remarkAutoTypeTable with generator; updated LLM text processor accordingly. - Minor UI/structural tweaks: “prose” wrappers, RTL-safe sidebar positioning, TOC styles, CSS imports, and Popover/Collapsible/ScrollArea utilities. - API Reference: inline GET handler via ApiReference(...) call. - **Dependencies** - Next.js: docs, demo, and dev deps → 15.5.x; enabled turbopack; set type: module in docs. - Fumadocs: core/ui → 15.7.x, mdx → 11.8.x, typescript → 4.x, docgen → 2.1.x. - Radix and assorted UI libs bumped; added gray-matter and js-beautify; lockfile updated. <!-- 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-15 20:50:37 -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#22133