feat(design-system): add focused component pages and simplify documentation - #7537
Draft
mahanti wants to merge 4 commits into
Draft
feat(design-system): add focused component pages and simplify documentation#7537mahanti wants to merge 4 commits into
mahanti wants to merge 4 commits into
Conversation
Signed-off-by: Arjun Mahanti <arjun@squareup.com>
Signed-off-by: Arjun Mahanti <arjun@squareup.com>
Signed-off-by: Arjun Mahanti <arjun@squareup.com>
Signed-off-by: Arjun Mahanti <arjun@squareup.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Each of the 55 catalog entries links through its category eyebrow (ending in →) to
/design/components/<id>. A focused page contains just its title and live example in a small shared Card. The example retains its working controls and variants, and the container follows the shared theme and Normal/Compact density.Every component is an indented child of All components in the navigation, matching Token table under Color. The navigation list scrolls independently so appearance controls remain available. The catalog shows its live previews without extra exploration links or source disclosures. Direct links and refreshes work with the existing static SPA setup, and invalid component URLs offer recovery.
Across the foundation, catalog, composition, and guide pages, headings lead directly into content. Page introductions, section subtitles, explanatory note boxes, and catalog descriptions are removed. Token values, labels, accessible help, and working example content remain; the open-source guide uses concise reference copy.
Stack 6 of 7: #7522 → #7523 → #7525 → #7533 → #7535 → this PR → #7556. Base:
codex/design-system-density. All remain draft.Validation:
just cirun stopped in the unchangedbuzz-terminal::lifecycle_tests::default_prog_child_observes_the_login_argv0test: the child did not report$0within 10 seconds. This failure was also observed before these UI changes; later repository-wide stages were not reached. This layout refinement was revalidated with the design-system build, checks, and browser suite above.Preview
/design/components/buttons,/design/components/input, or follow a category eyebrow or component navigation link.