chore(ui,shared,localizations): UX improvements for `<ConfigureSSO />` by LauraBeatris · Pull Request #8601 · clerk/javascript

LauraBeatris · 2026-05-20T13:15:20Z

Description

Moves verify domain step as the first one, to clarify which domain the user is setting up the enterprise connection
Update select provider step, to only include header title/description
Add UI descriptors to each step
Improve test step structure (new empty CTA, open test URL button)

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

vercel · 2026-05-20T13:15:28Z

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

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	May 25, 2026 7:49pm

changeset-bot · 2026-05-20T13:15:42Z

🦋 Changeset detected

Latest commit: e64ecc6

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

This PR includes changesets to release 20 packages

Name	Type
@clerk/localizations	Patch
@clerk/shared	Patch
@clerk/ui	Patch
@clerk/react	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/chrome-extension	Patch
@clerk/clerk-js	Patch
@clerk/expo-passkeys	Patch
@clerk/expo	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/hono	Patch
@clerk/msw	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/vue	Patch

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 · 2026-05-20T22:25:38Z

Open in StackBlitz

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@8601

@clerk/expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/hono

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/react

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

@clerk/react-router

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

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/ui

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

@clerk/upgrade

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

@clerk/vue

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

commit: e64ecc6

coderabbitai · 2026-05-20T22:27:32Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

📝 Walkthrough

Walkthrough

This PR updates Configure SSO end-to-end: many locale files now reference Single Sign-On (SSO) and simplify the select-provider localization shape; shared localization types were adjusted (selectProviderStep, testUrl action label, testResults.empty, provider-specific saml attributeMapping); UI changes include rehydrating provider selection, removing enterprise-connection creation from verify-domain, conditional mounting of select-provider, changing the permission key to org:sys_entconns:manage, refactoring ConfigureStep to provider-driven attribute mapping, adding an Open test URL flow and test-results empty state, instrumenting UI with elementDescriptor/elementId keys, and adding a primary-email-domain footer in the navbar. Tests were updated to reflect copy and permission-key changes.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Possibly related PRs

clerk/javascript#8586: Overlapping changes to SAML/attribute-mapping UI and provider-specific mapping handling.
clerk/javascript#8520: Related verify-domain flow changes and verify/add-email steps.
clerk/javascript#8544: Related updates to TestConfigurationStep, test URL/actions, and test-results UI.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main change: UX improvements to the ConfigureSSO component affecting the ui, shared, and localizations packages.
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.
Description check	✅ Passed	The PR description clearly relates to the changeset, detailing UX improvements for the ConfigureSSO component including step reordering, UI descriptors, and test step enhancements.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

iagodahlem · 2026-05-25T18:50:20Z

-      <Text
-        as='p'
-        colorScheme='secondary'
-        localizationKey={localizationKeys('configureSSO.configureStep.attributeMapping.paragraph')}
-      />


Noticed this paragraph here was removed, but it is still on the new designs:

I'll refactor this one on a next PR where I'll introduce better support for UI per IdP!

iagodahlem · 2026-05-25T18:52:28Z

+        <Th>
+          <Text
+            sx={theme => ({ fontSize: theme.fontSizes.$xs })}
+            localizationKey={config.columns.second}


In the designs, this column is now "Expression", currently as Value, but I think we can update it later, not sure if it is intended.

iagodahlem · 2026-05-25T18:54:38Z

-  );
-};
+                as='span'
+                colorScheme={config.monoFirst ? undefined : 'secondary'}


Noticed this column is always secondary even with mono in the designs, adding as a note to check what is the right one, we can fix later too.

I recognize this abstraction is bad, so I'll likely remove it on a next PR

Reason why, custom SAML attribute mapping table doesn't have a fixed attribute name to use mono, as it could be anything on the custom provider, so we use labels.

Okta uses the actual attribute name on the first column, therefore mono.

LauraBeatris self-assigned this May 20, 2026

github-actions Bot added the ui label May 20, 2026

github-actions Bot added the localizations label May 20, 2026

vercel Bot deployed to Preview May 20, 2026 14:33 View deployment

LauraBeatris force-pushed the laura/self-serve-sso-improvements branch from ba679b7 to 9774083 Compare May 20, 2026 14:42

vercel Bot deployed to Preview May 20, 2026 14:43 View deployment

vercel Bot deployed to Preview May 20, 2026 15:29 View deployment

vercel Bot deployed to Preview May 20, 2026 15:39 View deployment

vercel Bot deployed to Preview May 20, 2026 18:16 View deployment

vercel Bot deployed to Preview May 20, 2026 20:37 View deployment

vercel Bot deployed to Preview May 20, 2026 21:08 View deployment

vercel Bot deployed to Preview May 20, 2026 22:03 View deployment

LauraBeatris changed the title ~~chore(ui): UI improvements for self-serve SSO flow~~ chore(ui): UX improvements for self-serve SSO flow May 20, 2026

LauraBeatris force-pushed the laura/self-serve-sso-improvements branch from 1279e85 to 23d3243 Compare May 20, 2026 22:10

vercel Bot deployed to Preview May 20, 2026 22:10 View deployment

vercel Bot deployed to Preview May 20, 2026 22:18 View deployment

LauraBeatris requested a review from a team May 20, 2026 22:21

LauraBeatris marked this pull request as ready for review May 20, 2026 22:21

LauraBeatris changed the base branch from laura/add-self-serve-sso-org-profile to main May 20, 2026 22:21

LauraBeatris force-pushed the laura/self-serve-sso-improvements branch from dc5d30e to f1c419e Compare May 20, 2026 22:22

LauraBeatris changed the title ~~chore(ui): UX improvements for self-serve SSO flow~~ chore(ui): UX improvements for <ConfigureSSO /> May 20, 2026

LauraBeatris requested a review from alexcarpenter May 20, 2026 22:22

LauraBeatris changed the title ~~chore(ui): UX improvements for <ConfigureSSO />~~ chore(ui,shared,localizations): UX improvements for <ConfigureSSO /> May 20, 2026

vercel Bot deployed to Preview May 20, 2026 22:23 View deployment

vercel Bot deployed to Preview May 20, 2026 22:28 View deployment

vercel Bot deployed to Preview May 20, 2026 22:43 View deployment

iagodahlem approved these changes May 25, 2026

View reviewed changes

LauraBeatris added 16 commits May 25, 2026 16:46

Move verify domain as first step

2f9b1b0

Update select provider step title

ccf4b94

Display domain as sidebar footer

1319d09

Update permission key according to FAPI changes

5084c98

Add more UI descriptors

77e96e2

Do not allow going back to provider selection

caacc48

Introduce SP labels per provider

4bbcdad

Improve attribute statement mapping per provider

9ff74a1

Refactor button to open test URL

caa2ac6

Improve empty state for test logs

20f0f59

Add changeset

db2544b

Update firstName/lastName attributes to optional

c7fd6f5

Add loading feedback to refresh logs button

965539c

Fix separator to use theme value

126d09d

Simplify navbar to drop email domain

6224a86

Add useSpinDelay hook

c59349b

LauraBeatris force-pushed the laura/self-serve-sso-improvements branch from e60f168 to b04a165 Compare May 25, 2026 19:46

LauraBeatris enabled auto-merge (squash) May 25, 2026 19:46

vercel Bot deployed to Preview May 25, 2026 19:47 View deployment

LauraBeatris disabled auto-merge May 25, 2026 19:47

LauraBeatris force-pushed the laura/self-serve-sso-improvements branch from b04a165 to 7a92e31 Compare May 25, 2026 19:47

Update changeset

e64ecc6

vercel Bot deployed to Preview May 25, 2026 19:48 View deployment

LauraBeatris force-pushed the laura/self-serve-sso-improvements branch from 7a92e31 to e64ecc6 Compare May 25, 2026 19:48

vercel Bot deployed to Preview May 25, 2026 19:49 View deployment

LauraBeatris enabled auto-merge (squash) May 25, 2026 19:50

LauraBeatris merged commit bcf0e77 into main May 25, 2026
43 checks passed

LauraBeatris deleted the laura/self-serve-sso-improvements branch May 25, 2026 19:58

clerk-cookie mentioned this pull request May 25, 2026

ci(repo): Version packages #8635

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

chore(ui,shared,localizations): UX improvements for `<ConfigureSSO />`#8601

chore(ui,shared,localizations): UX improvements for `<ConfigureSSO />`#8601
LauraBeatris merged 17 commits into
mainfrom
laura/self-serve-sso-improvements

LauraBeatris commented May 20, 2026 •

edited

Loading

Uh oh!

vercel Bot commented May 20, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented May 20, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented May 20, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented May 20, 2026 •

edited

Loading

Reviews paused

Walkthrough

Estimated code review effort

Possibly related PRs

Uh oh!

iagodahlem May 25, 2026

Uh oh!

LauraBeatris May 25, 2026

Uh oh!

iagodahlem May 25, 2026

Uh oh!

iagodahlem May 25, 2026

Uh oh!

LauraBeatris May 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

LauraBeatris commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Uh oh!

vercel Bot commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot Bot commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

pkg-pr-new Bot commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented May 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Estimated code review effort

Possibly related PRs

Uh oh!

iagodahlem May 25, 2026

Choose a reason for hiding this comment

Uh oh!

LauraBeatris May 25, 2026

Choose a reason for hiding this comment

Uh oh!

iagodahlem May 25, 2026

Choose a reason for hiding this comment

Uh oh!

iagodahlem May 25, 2026

Choose a reason for hiding this comment

Uh oh!

LauraBeatris May 25, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

LauraBeatris commented May 20, 2026 •

edited

Loading

vercel Bot commented May 20, 2026 •

edited

Loading

changeset-bot Bot commented May 20, 2026 •

edited

Loading

pkg-pr-new Bot commented May 20, 2026 •

edited

Loading

coderabbitai Bot commented May 20, 2026 •

edited

Loading