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

@alexcarpenter alexcarpenter 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

vercel Bot commented Jul 31, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
swingset Ready Ready Preview Jul 31, 2026 6:38pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
clerk-js-sandbox Skipped Skipped Jul 31, 2026 6:38pm

Request Review

@changeset-bot

changeset-bot Bot 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-new Bot 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-actions Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

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

Summary

Metric Count
Packages analyzed 19
Packages with changes 0
🔴 Breaking changes 0
🟡 Non-breaking changes 0
🟢 Additions 0

No API Changes Detected

All packages have stable APIs with no detected changes.


Report generated by Break Check

Last ran on 7578b25.

@coderabbitai

coderabbitai Bot 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 name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: Mosaic Button icons fade until hover.
Description check ✅ Passed The description directly explains the icon color behavior, implementation details, and related MenuTrigger changes.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check 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.

@coderabbitai coderabbitai Bot 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

@maxyinger maxyinger 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
vercel Bot temporarily deployed to Preview – clerk-js-sandbox July 31, 2026 18:36 Inactive
@alexcarpenter
alexcarpenter merged commit 66d5431 into main Jul 31, 2026
52 checks passed
@alexcarpenter
alexcarpenter deleted the carp/mosaic-button-icon-color branch July 31, 2026 18:58
Sign up for free to 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