Skip to content

site: move guides to top-level /guides route + flesh out Bun migration map#59

Merged
colinhacks merged 1 commit into
mainfrom
guides-toplevel
Jun 21, 2026
Merged

site: move guides to top-level /guides route + flesh out Bun migration map#59
colinhacks merged 1 commit into
mainfrom
guides-toplevel

Conversation

@colinhacks

Copy link
Copy Markdown
Contributor

Moves guides off the docs route onto a dedicated top-level /guides/* route, and expands the Bun-to-nub guide into a comprehensive API migration map.

Route move

  • Adds a separate fumadocs guides content source rooted at site/content/guides/ (source.config.ts + src/lib/source.ts).
  • Adds the /guides/[[...slug]] route segment + layout (src/app/guides/), mirroring the docs route but without the per-command sidebar chips. Guides stay out of the docs sidebar as a distinct top-level section.
  • Moves content/docs/guides/bun-to-nub.mdx to content/guides/bun-to-nub.mdx (/docs/guides/bun-to-nub to /guides/bun-to-nub) and removes the empty content/docs/guides/.
  • Adds a permanent (308) redirect /docs/guides/:path* to /guides/:path* in next.config.mjs so existing links keep working.
  • Wires the guides source into the /llms.txt index and the per-page /llms/*.mdx route so the guide's AI-readable markdown resolves.

Content

  • Expands the Bun-to-nub guide with a full API map: every Bun-specific API (Bun.* globals and bun:* modules) grouped by category (process/shell, FS/glob, HTTP/net, DB, hashing/crypto/compression, build/transpile, testing, FFI, HTML/text, utilities) with its recommended Node or npm-ecosystem replacement. Calls out where the runtime already covers it (Web APIs) and where it's unnecessary under nub (Bun.Transpiler).

Verification

  • pnpm build succeeds; /guides/[[...slug]] prerenders /guides/bun-to-nub, and /llms/guides/bun-to-nub.mdx is emitted.
  • Redirect rule present in routes-manifest.json: /docs/guides/:path* to /guides/:path*, statusCode 308.
  • All in-page cross-reference anchors verified against the rendered heading IDs.

https://claude.ai/code/session_01YRvztkcr4fzfg9rD5edUwa

…n map

Add a separate fumadocs `guides` content source rooted at site/content/guides/
with its own /guides/[[...slug]] route and layout, mirroring the docs route.
Move the Bun-to-nub guide from /docs/guides/bun-to-nub to /guides/bun-to-nub,
add a permanent redirect from /docs/guides/* to /guides/*, and wire the guides
source into the llms.txt index and per-page markdown route. Guides stay out of
the docs sidebar as a distinct top-level section.

Expand the Bun-to-nub guide with a comprehensive API map: every Bun-specific
API (Bun.* globals and bun:* modules) grouped by category with its recommended
Node or npm-ecosystem replacement.

Claude-Session: https://claude.ai/code/session_01YRvztkcr4fzfg9rD5edUwa
Copilot AI review requested due to automatic review settings June 21, 2026 18:31

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@vercel

vercel Bot commented Jun 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
nub Ready Ready Preview, Comment Jun 21, 2026 6:33pm

Request Review

@colinhacks colinhacks merged commit de9692d into main Jun 21, 2026
18 checks passed
@colinhacks

Copy link
Copy Markdown
Contributor Author

Shipped in v0.1.10: https://github.com/nubjs/nub/releases/tag/v0.1.10

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