Skip to content

docs: fix dead links in the docs site nav and landing page#21

Open
0xNeit wants to merge 1 commit into
mainfrom
docs/fix-dead-nav-links
Open

docs: fix dead links in the docs site nav and landing page#21
0xNeit wants to merge 1 commit into
mainfrom
docs/fix-dead-nav-links

Conversation

@0xNeit
Copy link
Copy Markdown
Contributor

@0xNeit 0xNeit commented May 18, 2026

What

A scan of every internal link in the docs app (apps/docs) turned up 12 occurrences pointing at routes that don't exist. None were in page content — all 200+ markdown links, anchors, and external URLs in content/ check out. The dead links were all in the site chrome and landing page:

Where Was Now
TopNav / Footer — "Guides" /guides/design-system /guides/performance
TopNav / Footer — "Recipes" (×3) /recipes/buttons /recipes/dark-mode-toggle
BentoFeatures — "Universal by design" /getting-started/web-and-native /getting-started/cross-platform
ComponentGallery — Buttons /recipes/buttons /components/interactive/button
ComponentGallery — Inputs /recipes/forms /components/forms
ComponentGallery — Cards /recipes/layouts /components/layout
ComponentGallery — Toggles /recipes/forms /headless/selection/switch
ComponentGallery — Progress /recipes/animation /headless/numeric/progress
ComponentGallery — Toasts /recipes/animation /headless/feedback/toast

Gallery cards were repointed at the component doc page each one depicts — consistent with the cards already correct ("Badges" → /concepts/variants, "Tabs" → /concepts/composition). The "Recipes"/"Guides" nav items land on the first page of each section.

Follow-up (not in this PR)

/recipes and /guides have no index page (no index.mdx). The nav works now, but a dedicated section landing page would be the cleaner long-term fix.

A scan of internal links in the docs app found 12 occurrences pointing
at routes that don't exist. None were in page content — all were in the
site chrome and landing page:

- TopNav / Footer "Guides" -> /guides/design-system (no such guide);
  now /guides/performance.
- TopNav / Footer "Recipes" -> /recipes/buttons (no such recipe);
  now /recipes/dark-mode-toggle.
- BentoFeatures "Universal by design" -> /getting-started/web-and-native;
  now /getting-started/cross-platform.
- ComponentGallery cards -> /recipes/{buttons,forms,layouts,animation},
  none of which exist. Repointed each card at the component doc page it
  depicts, matching the cards that were already correct.
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