Skip to content

feat(docs): split the Checkbox page into an overview and a page per layer - #59

Merged
alexgrozav merged 1 commit into
component-sub-pages-uxf-421from
split-checkbox-uxf-426
Oct 22, 2026
Merged

alexgrozav merged 1 commit into
component-sub-pages-uxf-421from
split-checkbox-uxf-426

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What changed

The Checkbox page is now a folder shaped like the Button's, so readers get a page per layer rather than one of about 33,000 tokens. The Overview keeps the intro, At a glance, the Checklist's intro, the reference implementation and the sources, and links each layer from a card. The UI, UX, DX and AX pages hold their sections, then their rules under ## <Layer> Checklist, then their questions. The text moves as it is: agents still read one page at /raw/docs/components/checkbox.md, with the same outline, rules and contract as before, and old links like /docs/components/checkbox#every-state go on to the right part.

Links on the Checkbox's own pages to its own sections now point to the part that holds them. Links to other components' sections, and other pages' links into the Checkbox, are left for the layer that links the split pages to each other.

Each FAQ item went to the layer it answers:

  • User Interface: "Can I make a checkbox look like a toggle switch?"
  • User Experience: "Checkbox or something else?" (with its table), "Can I put a link in a checkbox's label?"
  • Developer Experience: "Why does the Checkbox render its own label, when the Input doesn't?", "Why does an unchecked checkbox send nothing?", "Does the Checkbox work before JavaScript loads?"
  • Agentic Experience: none

The live examples went with their sections: the playground on the Overview, two on User Interface, four on User Experience and one on Developer Experience. The Agentic Experience page has none.

Checklist

  • The title follows Conventional Commits, as in feat(docs): add the focus guideline.
  • pnpm check-types passes.
  • Docs changes: the pages read well on pnpm dev. (Read on the built site served by wrangler dev instead, with Chrome at 1440px and 375px.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category. (No homepage changes. pnpm lighthouse passes the 0.95 budget, with Best Practices at 0.96.)

…ayer

The Checkbox page becomes a folder shaped like the Button's: an Overview
with a card per layer, and a page each for UI, UX, DX and AX, with that
layer's rules and questions. The text moves as it is. Links to the page's
own sections now go to the part that holds them.

Co-authored-by: multica-agent <github@multica.ai>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://split-checkbox-uxf-426-opencomponents.blue-water-0397.workers.dev (commit 60ceb8d)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://0b7adbe3-opencomponents.blue-water-0397.workers.dev 60ceb8d 2026-10-22T12:51:56.469Z Visit the dashboard ↗

@alexgrozav
alexgrozav merged commit e16cd3a into component-sub-pages-uxf-421 Oct 22, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the split-checkbox-uxf-426 branch October 22, 2026 13:01
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