Skip to content

docs(integrations): group & sort the docs sidebar like the root README#315

Merged
rejifald merged 2 commits into
mainfrom
claude/xenodochial-gauss-aefcd2
Jun 21, 2026
Merged

docs(integrations): group & sort the docs sidebar like the root README#315
rejifald merged 2 commits into
mainfrom
claude/xenodochial-gauss-aefcd2

Conversation

@rejifald

Copy link
Copy Markdown
Owner

What

Reorganizes the Integrations section of the docs site so it is sorted and grouped exactly like the package table in the root README.

Both surfaces that present integrations were realigned to the README's grouping — same group titles, same group order, and alphabetical-by-package within each group:

Sidebarapps/docs/content/docs/integrations/meta.json was a flat 21-item list. It now uses Fumadocs ---Group--- separators in README order:

  1. Server frameworks — elysia, express, fastify, hono, nestjs, next
  2. Client & UI bindings — angular, expo, react, react-native, solid, svelte, vue
  3. Data-fetching libraries — rtk-query, swr, tanstack-query
  4. State stores — stores
  5. Auth — aws-sigv4
  6. AI — vercel-ai
  7. Observability — pino, sentry

Landing pageapps/docs/content/docs/integrations/index.mdx card sections were retitled/reordered to match, with cards alphabetical within each section.

Why

The docs sidebar ordering was ad-hoc and the landing page used a different information architecture ("Backend frameworks" / "Frontend" / "Mobile" / …) than the README. This makes the two consistent — readers see the same grouping wherever they look.

Notable IA changes to match the README:

  • The old separate Frontend + Mobile sections are folded into Client & UI bindings (the README groups React Native/Expo there).
  • Data-fetching libraries (RTK Query, SWR, TanStack Query) are split out of the old Frontend group.
  • Observability moves to last, matching README order.

Reviewer notes

  • This also surfaces Express, Elysia, and Solid on the landing page — they had docs pages and sidebar entries but were missing landing cards (18 → 21 cards).
  • Content-only change. Verified: ---Name--- separators are valid for the installed fumadocs-core@16.10.0 (matched against its loader regex); all 21 sidebar slugs and all 21 landing-card hrefs resolve to existing pages; both files are Prettier-clean.
  • Heads-up (filed as a separate task, not in this PR): apps/docs/content.manifest.ts still only lists integrations/nestjs, so pnpm gen:docs would currently clobber this hand-maintained grouped meta.json. Worth fixing the generator/manifest divergence on its own.

🤖 Generated with Claude Code

rejifald and others added 2 commits June 21, 2026 13:38
The integrations sidebar (meta.json) was a flat, ad-hoc list and the
landing page (index.mdx) used a different IA ("Backend frameworks",
"Frontend", "Mobile", …). Realign both with the root README's package
table: same group titles, same group order, alphabetical by package
within each group.

- meta.json: add Fumadocs `---Group---` separators in README order —
  Server frameworks · Client & UI bindings · Data-fetching libraries ·
  State stores · Auth · AI · Observability.
- index.mdx: retitle/reorder card sections to match; fold the old
  Frontend+Mobile split into "Client & UI bindings" (React Native/Expo
  live there in the README) and split data-fetching libraries out.
- Surface Express, Elysia, and Solid on the landing page — they had
  pages and sidebar entries but no landing card (18 → 21 cards).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@rejifald rejifald merged commit 9de6ee2 into main Jun 21, 2026
9 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.

1 participant