Skip to content

feat(ui): grow the Mosaic Button touch target without growing the button - #9304

Merged
maxyinger merged 2 commits into
mainfrom
max/mobile-button-size
Jul 31, 2026
Merged

feat(ui): grow the Mosaic Button touch target without growing the button#9304
maxyinger merged 2 commits into
mainfrom
max/mobile-button-size

Conversation

@maxyinger

Copy link
Copy Markdown
Collaborator

Description

Under a coarse pointer Button floored at --cl-target-coarse via min-height, which made every
button visibly taller than its size. It now grows an invisible ::after overlay instead — the hit
area reaches the target, the rendered box stays put. Default shape grows on the block axis only;
square and circle grow on both.

touchTarget={false} opts out where neighbors sit close enough that the overlays would overlap.
variant='link' never takes one.

overflow: hidden comes off base: the label span carries its own, and the overlay has to escape
the box to be hit-testable.

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:

Under a coarse pointer the button floored at `--cl-target-coarse` via
`min-height`, which made every button visibly taller than its `size`.
Grow an invisible `::after` overlay instead, so the hit area reaches the
target while the rendered box stays put.

`overflow: hidden` comes off `base` — the label span carries its own, and
the overlay has to escape the box to be hit-testable.

Adds `touchTarget` (default `true`) to opt out where neighbors sit close
enough that the overlays would overlap.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@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)
clerk-js-sandbox Ready Ready Preview Jul 31, 2026 3:58pm
swingset Ready Ready Preview Jul 31, 2026 3:58pm

Request Review

@changeset-bot

changeset-bot Bot commented Jul 31, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 1990ce4

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

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/electron

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

@clerk/electron-passkeys

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

@clerk/eslint-plugin

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

@clerk/expo

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

@clerk/expo-google-signin

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: 1990ce4

@github-actions

github-actions Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

API Changes Report

Generated by Break Check on 2026-07-31T15:59:08.041Z

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 1990ce4.

@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: 4dbecf18-d007-4d23-a9a1-324ccf39d981

📥 Commits

Reviewing files that changed from the base of the PR and between 70c6532 and 1990ce4.

📒 Files selected for processing (1)
  • .changeset/rare-pumas-repeat.md
🔗 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)
  • .changeset/rare-pumas-repeat.md

📝 Walkthrough

Walkthrough

The Mosaic Button component now supports a touchTarget prop enabled by default. Coarse pointers use pseudo-element overlays to expand the tap area without changing layout dimensions. Link variants exclude this behavior. Tests, story controls, documentation, and a changeset describe the feature.

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

Possibly related PRs

Suggested reviewers: alexcarpenter

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: expanding the Mosaic Button touch target without changing its rendered size.
Description check ✅ Passed The description directly explains the touch-target implementation, behavior by shape, opt-out prop, link exclusion, and overflow change.
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/button/button.test.tsx (1)

33-42: 📐 Maintainability & Code Quality | 🔵 Trivial | 🏗️ Heavy lift

Test the touch-target behavior, not only generated class atoms.

These assertions compare className lengths and membership. They do not verify that the overlay works under (pointer: coarse), that default buttons expand only on the block axis, or that square and circle buttons expand on both axes. A regression in the media rule or touchTargetIcon can pass these tests.

Add browser-level integration/E2E coverage or a stable compiled-style assertion. Include square and circle cases. The link test should also verify that the default link has no touch-target styling, not only that touchTarget={false} leaves its class unchanged.

As per coding guidelines, React Testing Library tests must test component behavior rather than implementation details, and new functionality must include edge-case coverage.

Also applies to: 44-56

🤖 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/button/button.test.tsx` around lines 33 -
42, Replace the className atom assertions in the Button touch-target tests with
behavior-focused coverage of the compiled styles or browser-level behavior under
pointer: coarse. Verify default buttons expand only on the block axis, while
square and circle variants expand on both axes, and include the touchTargetIcon
path. Extend the link tests to assert default links have no touch-target styling
as well as preserving the behavior when touchTarget={false}.

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/button/button.test.tsx`:
- Around line 33-42: Replace the className atom assertions in the Button
touch-target tests with behavior-focused coverage of the compiled styles or
browser-level behavior under pointer: coarse. Verify default buttons expand only
on the block axis, while square and circle variants expand on both axes, and
include the touchTargetIcon path. Extend the link tests to assert default links
have no touch-target styling as well as preserving the behavior when
touchTarget={false}.

ℹ️ Review info
⚙️ Run configuration

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

Review profile: CHILL

Plan: Pro Plus

Run ID: bef126b1-b8e0-4ce2-83f2-0f00db654ab4

📥 Commits

Reviewing files that changed from the base of the PR and between 38f347c and 70c6532.

📒 Files selected for processing (6)
  • .changeset/rare-pumas-repeat.md
  • packages/swingset/src/stories/button.mdx
  • packages/swingset/src/stories/button.stories.tsx
  • packages/ui/src/mosaic/components/button/button.styles.ts
  • packages/ui/src/mosaic/components/button/button.test.tsx
  • packages/ui/src/mosaic/components/button/button.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)

@maxyinger
maxyinger requested a review from alexcarpenter July 31, 2026 15:47
Comment thread .changeset/rare-pumas-repeat.md Outdated
@maxyinger
maxyinger merged commit 6b24470 into main Jul 31, 2026
52 checks passed
@maxyinger
maxyinger deleted the max/mobile-button-size branch July 31, 2026 16:20
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