feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

feat(ui): fade Mosaic Button icons until hover - #9307

Merged
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color
Jul 31, 2026
Merged

feat(ui): fade Mosaic Button icons until hover#9307
alexcarpenter merged 2 commits into
mainfrom
carp/mosaic-button-icon-color

Conversation

@alexcarpenter

@alexcarpenteralexcarpenter commented Jul 31, 2026

Copy link
Copy Markdown
Member

Description

An icon inside a Button now rests a step below its label and comes up to it on hover, so the label leads and the icon reads as supporting.

Preview:

Each variant × color cell sets --_cl-icon-color to an opaque faded form of that cell's own text color, and lifts it to the full text color on hover and while a disclosure trigger is open. Icon reads the var with a currentColor fallback, so an icon outside a button is unchanged. StyleX can't emit a descendant rule, so the value crosses the element boundary as a custom property; it sits per cell rather than once in base because StyleX resolves a property to the last style that declares it, and a cell would otherwise drop the base hover branch wholesale.

The faded steps are opaque rather than an alpha of the label color: a translucent icon picks up whatever sits behind the button and drifts per surface. The achromatic foregrounds share the house faded gray; the two that carry hue fade toward the tint that belongs to them; the light-on-fill pairs fade toward their own fill, which is the only backdrop they can sit on.

MenuTrigger was rendering the raw registry glyph rather than the Icon component, so its ellipsis stayed full-strength next to icons that faded. It now renders <Icon name='ellipsis' />, which also makes that glyph swappable via appearance.icons. Its triggerIcon atom is gone — it was space['4'] square, exactly what Icon's default md size gives.

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • (If applicable) JSDoc comments have been added or updated for any package exports
  • (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

@vercel

vercelBot commented Jul 31, 2026

Copy link
Copy Markdown

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

ProjectDeploymentActionsUpdated (UTC)
swingsetReadyReadyPreviewJul 31, 2026 6:38pm
1 Skipped Deployment
ProjectDeploymentActionsUpdated (UTC)
clerk-js-sandboxSkippedSkippedJul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-botBot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 7578b25

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

Each variant x color cell sets --_cl-icon-color to an opaque faded form of its
own text color, lifting to the full color on hover and while a disclosure
trigger is open. Icon reads the var with a currentColor fallback, and
MenuTrigger renders the Icon component instead of the raw registry glyph so its
ellipsis participates.
@pkg-pr-new

pkg-pr-newBot commented Jul 31, 2026

Copy link
Copy Markdown

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9307

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9307

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9307

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9307

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9307

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9307

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9307

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9307

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9307

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9307

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9307

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9307

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9307

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9307

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9307

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9307

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9307

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9307

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9307

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9307

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9307

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9307

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9307

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9307

commit: 7578b25

@github-actions

github-actionsBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T18:39:35.007Z

Summary

MetricCount
Packages analyzed19
Packages with changes0
🔴 Breaking changes0
🟡 Non-breaking changes0
🟢 Additions0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitaiBot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: d2de7497-0909-438e-b8f5-77fedb7718a2

📥 Commits

Reviewing files that changed from the base of the PR and between 154f9b3 and 7578b25.

📒 Files selected for processing (1)
  • packages/swingset/src/stories/button.stories.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)

📝 Walkthrough

Walkthrough

The PR adds faded, hover, and open-state icon colors across Mosaic button variants. The shared Icon style inherits --_cl-icon-color and transitions color changes. MenuTrigger now renders the ellipsis through Icon. The Shapes story replaces inline SVG icons with Icon. A Changesets metadata file is also added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Possibly related PRs

Suggested reviewers:maxyinger, kylemac

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Title check✅ PassedThe title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check✅ PassedThe description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage✅ PassedNo functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check✅ PassedCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes check✅ PassedCheck skipped because no linked issues were found for this pull request.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹 Nitpick comments (1)
packages/ui/src/mosaic/components/icon/icon.styles.ts (1)

7-8: 📐 Maintainability & Code Quality | 🔵 Trivial | ⚡ Quick win

Use one terse rationale for each new comment block.

The same minimal-comment guideline is violated at all three sites.

  • packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8: replace the two-line fallback explanation with one short rationale.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45: replace the design discussion with one short rationale for opaque faded colors.
  • packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168: replace the StyleX implementation discussion with one short rationale for per-variant declarations.

As per coding guidelines, comments must be minimal, and warranted comments must be one terse line.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts` around lines 7 - 8,
Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

Source: Coding guidelines

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Nitpick comments:
In `@packages/ui/src/mosaic/components/icon/icon.styles.ts`:
- Around line 7-8: Shorten the comments at
packages/ui/src/mosaic/components/icon/icon.styles.ts#L7-L8,
packages/ui/src/mosaic/components/button/button.styles.ts#L39-L45, and
packages/ui/src/mosaic/components/button/button.styles.ts#L164-L168 to one terse
rationale per block: preserve the icon fallback behavior, explain the need for
opaque faded colors, and explain the per-variant declarations respectively.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: 70b1235a-a9ad-4c76-811f-d1ca1bf4532d

📥 Commits

Reviewing files that changed from the base of the PR and between a601cd7 and 154f9b3.

📒 Files selected for processing (5)
  • .changeset/mosaic-button-icon-color.md
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/icon/icon.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.styles.ts
  • packages/ui/src/mosaic/components/menu/menu.tsx
🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

  • clerk/clerk_go(manual)
  • clerk/dashboard(manual)
  • clerk/accounts(manual)
  • clerk/backoffice(manual)
  • clerk/clerk(manual)
  • clerk/clerk-docs(manual)
  • clerk/cloudflare-workers(manual)
💤 Files with no reviewable changes (1)
  • packages/ui/src/mosaic/components/menu/menu.styles.ts

@maxyingermaxyinger left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I must not be using a custom svg in this story or something. mind updating it to use icon so it picks up on these style changes. other than that looks great

Image

The shape story inlined a raw plus glyph, so it sat outside the icon color contract and stayed full-strength while every other icon in the story faded.
@vercel
vercelBottemporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into mainJul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@alexcarpenter@maxyinger