Skip to content

Comments

docs(colors): add WCAG AA contrast info and reorder sections#1117

Open
ByronDWall wants to merge 3 commits intomainfrom
CRAFT-2118-color-tokens-wcag-docs
Open

docs(colors): add WCAG AA contrast info and reorder sections#1117
ByronDWall wants to merge 3 commits intomainfrom
CRAFT-2118-color-tokens-wcag-docs

Conversation

@ByronDWall
Copy link
Contributor

@ByronDWall ByronDWall commented Feb 20, 2026

Summary

  • Added a WCAG AA Text Pairing column to the color scale steps table documenting accessible contrast pairings
  • Added explanatory paragraph about Radix color system contrast guarantees (4.5:1 ratio)
  • Added link to Radix color scale documentation
  • Reordered color sections: Semantic → Brand → System → Blacks & Whites (most-used first)

Closes CRAFT-2118

Test plan

  • Verify docs site renders the updated table correctly with the new column
  • Confirm section ordering matches: Semantic Colors, Brand Colors, System Colors, Blacks & Whites
  • Verify the Radix documentation link works

🤖 Generated with Claude Code

Add a "WCAG AA Text Pairing" column to the color scale steps table
documenting which steps are safe to pair for accessible contrast, along
with an explanatory paragraph and a link to the Radix scale docs.

CRAFT-2118

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@changeset-bot
Copy link

changeset-bot bot commented Feb 20, 2026

⚠️ No Changeset found

Latest commit: 1fff9a1

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link

vercel bot commented Feb 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
nimbus-documentation Ready Ready Preview, Comment Feb 20, 2026 6:53pm
nimbus-storybook Ready Ready Preview, Comment Feb 20, 2026 6:53pm

Request Review

Copy link
Contributor

@tylermorrisford tylermorrisford left a comment

Choose a reason for hiding this comment

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

very nice

Move Semantic Colors and Brand Colors above System Colors so the most
commonly used palettes appear first.

CRAFT-2118

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Credit Radix Colors as the underlying system and introduce the
colorPalette term so consumers know how to reference a full scale.

CRAFT-2118

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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