Skip to content

docs(llms.txt): fix 404 and backfill missing routes#10337

Merged
shadcn merged 1 commit intoshadcn-ui:mainfrom
ramonclaudio:docs/llms-txt-drift
Apr 9, 2026
Merged

docs(llms.txt): fix 404 and backfill missing routes#10337
shadcn merged 1 commit intoshadcn-ui:mainfrom
ramonclaudio:docs/llms-txt-drift

Conversation

@ramonclaudio
Copy link
Copy Markdown
Contributor

@ramonclaudio ramonclaudio commented Apr 8, 2026

Audits apps/v4/public/llms.txt against the docs tree and fixes every drift. The file was added in #8460 and hasn't kept up.

Removed

  • Drop About (/docs/about). Returns 404. No about.mdx exists.
  • Drop Form (/docs/components/form). No radix/form.mdx exists post-feat: add docs for base-ui components #9304. The URL redirects to /docs/forms, already listed as Forms Overview in the ## Forms section alongside the real form-library docs.

Added to Overview

  • Add Skills (/docs/skills).
  • Add Directory (/docs/directory).

Added RTL section

Didn't exist before. Same structure as Dark Mode.

  • Add RTL (/docs/rtl).
  • Add RTL - Next.js (/docs/rtl/next).
  • Add RTL - Vite (/docs/rtl/vite).
  • Add RTL - TanStack Start (/docs/rtl/start).

Added to Components

  • Add Direction to Misc.
  • Add Native Select to Form & Input, after Select.
  • Add Sonner to Feedback & Status, after Toast. The existing Toast entry mentions "using Sonner" but Sonner has its own docs page.

Added to Registry

  • Add Namespaces (/docs/registry/namespace).
  • Add Add a Registry (/docs/registry/registry-index).
  • Add Open in v0 (/docs/registry/open-in-v0).
  • Add registry.json (/docs/registry/registry-json).
  • Add registry-item.json (/docs/registry/registry-item-json).

Method: curled every ui.shadcn.com/... URL in llms.txt (97 total) and mapped each to apps/v4/content/docs/. Only /docs/about and /docs/components/form didn't resolve.

Noticed while working on #9484.

@vercel
Copy link
Copy Markdown
Contributor

vercel bot commented Apr 8, 2026

@ramonclaudio is attempting to deploy a commit to the shadcn-pro Team on Vercel.

A member of the Team first needs to authorize it.

@ramonclaudio ramonclaudio force-pushed the docs/llms-txt-drift branch from 4802b15 to 3782827 Compare April 8, 2026 16:25
@ramonclaudio ramonclaudio changed the title docs(llms.txt): add missing direction, native select, sonner components docs(llms.txt): fix 404 and backfill missing routes Apr 8, 2026
llms.txt was added in shadcn-ui#8460 and hasn't kept up with the docs tree.
Audited every URL against apps/v4/content/docs and fixed the drift
in one pass.

Removed:
- About (/docs/about): returns 404, no about.mdx exists
- Form (/docs/components/form): points at a phantom. No radix/form.mdx
  exists post-shadcn-ui#9304. URL only resolves because of a redirect in
  next.config.mjs, which lands at /docs/forms. That page is already
  listed as 'Forms Overview' in the ## Forms section, and the real
  form library docs (React Hook Form, TanStack Form, Next.js) are
  listed there too. The Form component entry is a stale duplicate.

Added to Overview:
- Skills (/docs/skills)
- Directory (/docs/directory)

Added whole RTL section (new since shadcn-ui#8460):
- RTL (/docs/rtl)
- RTL - Next.js
- RTL - Vite
- RTL - TanStack Start

Added to Components:
- Direction (Misc)
- Native Select (Form & Input, after Select)
- Sonner (Feedback & Status, after Toast, since Sonner has its own
  docs page even though Toast already uses it under the hood)

Added to Registry:
- Namespaces
- Add a Registry (open source registry index)
- Open in v0 integration
- registry.json schema docs
- registry-item.json spec docs

Descriptions match the short curated style of the rest of the file.
Noticed while working on shadcn-ui#9484.
@ramonclaudio ramonclaudio force-pushed the docs/llms-txt-drift branch from 3782827 to 1dcbb4c Compare April 8, 2026 16:36
Copy link
Copy Markdown
Collaborator

@shadcn shadcn left a comment

Choose a reason for hiding this comment

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

Thanks so much. Been meaning to do this but never got to it. Super helpful.

@shadcn shadcn merged commit fc62d57 into shadcn-ui:main Apr 9, 2026
1 of 2 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.

2 participants