feat(clerk-js,ui): Introduce setup MFA session task #7626

octoper · 2026-01-20T20:40:25Z

Description

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

changeset-bot · 2026-01-20T20:40:29Z

⚠️ No Changeset found

Latest commit: b41bd37

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

This PR includes no changesets

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

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

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

vercel · 2026-01-20T20:40:30Z

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

Project	Deployment	Review	Updated (UTC)
clerk-js-sandbox	Ready	Preview, Comment	Jan 23, 2026 6:22pm

octoper · 2026-01-21T10:44:06Z

!snapshot

clerk-cookie · 2026-01-21T10:46:15Z

Hey @octoper - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.2.9-snapshot.v20260121104441
@clerk/astro	3.0.0-snapshot.v20260121104441
@clerk/backend	3.0.0-snapshot.v20260121104441
@clerk/chrome-extension	3.0.0-snapshot.v20260121104441
@clerk/clerk-js	6.0.0-snapshot.v20260121104441
@clerk/dev-cli	1.0.0-snapshot.v20260121104441
@clerk/expo	3.0.0-snapshot.v20260121104441
@clerk/expo-passkeys	1.0.0-snapshot.v20260121104441
@clerk/express	2.0.0-snapshot.v20260121104441
@clerk/fastify	2.6.9-snapshot.v20260121104441
@clerk/localizations	4.0.0-snapshot.v20260121104441
@clerk/msw	0.0.1-snapshot.v20260121104441
@clerk/nextjs	7.0.0-snapshot.v20260121104441
@clerk/nuxt	2.0.0-snapshot.v20260121104441
@clerk/react	6.0.0-snapshot.v20260121104441
@clerk/react-router	3.0.0-snapshot.v20260121104441
@clerk/shared	4.0.0-snapshot.v20260121104441
@clerk/tanstack-react-start	1.0.0-snapshot.v20260121104441
@clerk/testing	2.0.0-snapshot.v20260121104441
@clerk/ui	1.0.0-snapshot.v20260121104441
@clerk/upgrade	2.0.0-snapshot.v20260121104441
@clerk/vue	2.0.0-snapshot.v20260121104441

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.2.9-snapshot.v20260121104441 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.0-snapshot.v20260121104441 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.0-snapshot.v20260121104441 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.0.0-snapshot.v20260121104441 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.0-snapshot.v20260121104441 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@1.0.0-snapshot.v20260121104441 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.0-snapshot.v20260121104441 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.0-snapshot.v20260121104441 --save-exact

@clerk/express

npm i @clerk/express@2.0.0-snapshot.v20260121104441 --save-exact

@clerk/fastify

npm i @clerk/fastify@2.6.9-snapshot.v20260121104441 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.0-snapshot.v20260121104441 --save-exact

@clerk/msw

npm i @clerk/msw@0.0.1-snapshot.v20260121104441 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.0-snapshot.v20260121104441 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.0-snapshot.v20260121104441 --save-exact

@clerk/react

npm i @clerk/react@6.0.0-snapshot.v20260121104441 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.0-snapshot.v20260121104441 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.0-snapshot.v20260121104441 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.0-snapshot.v20260121104441 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.0-snapshot.v20260121104441 --save-exact

@clerk/ui

npm i @clerk/ui@1.0.0-snapshot.v20260121104441 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.0-snapshot.v20260121104441 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.0-snapshot.v20260121104441 --save-exact

octoper · 2026-01-22T11:04:44Z

!snapshot

clerk-cookie · 2026-01-22T11:06:56Z

Hey @octoper - the snapshot version command generated the following package versions:

Package	Version
@clerk/agent-toolkit	0.2.9-snapshot.v20260122110524
@clerk/astro	3.0.0-snapshot.v20260122110524
@clerk/backend	3.0.0-snapshot.v20260122110524
@clerk/chrome-extension	3.0.0-snapshot.v20260122110524
@clerk/clerk-js	6.0.0-snapshot.v20260122110524
@clerk/dev-cli	1.0.0-snapshot.v20260122110524
@clerk/expo	3.0.0-snapshot.v20260122110524
@clerk/expo-passkeys	1.0.0-snapshot.v20260122110524
@clerk/express	2.0.0-snapshot.v20260122110524
@clerk/fastify	2.6.9-snapshot.v20260122110524
@clerk/localizations	4.0.0-snapshot.v20260122110524
@clerk/msw	0.0.1-snapshot.v20260122110524
@clerk/nextjs	7.0.0-snapshot.v20260122110524
@clerk/nuxt	2.0.0-snapshot.v20260122110524
@clerk/react	6.0.0-snapshot.v20260122110524
@clerk/react-router	3.0.0-snapshot.v20260122110524
@clerk/shared	4.0.0-snapshot.v20260122110524
@clerk/tanstack-react-start	1.0.0-snapshot.v20260122110524
@clerk/testing	2.0.0-snapshot.v20260122110524
@clerk/ui	1.0.0-snapshot.v20260122110524
@clerk/upgrade	2.0.0-snapshot.v20260122110524
@clerk/vue	2.0.0-snapshot.v20260122110524

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/agent-toolkit

npm i @clerk/agent-toolkit@0.2.9-snapshot.v20260122110524 --save-exact

@clerk/astro

npm i @clerk/astro@3.0.0-snapshot.v20260122110524 --save-exact

@clerk/backend

npm i @clerk/backend@3.0.0-snapshot.v20260122110524 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@3.0.0-snapshot.v20260122110524 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@6.0.0-snapshot.v20260122110524 --save-exact

@clerk/dev-cli

npm i @clerk/dev-cli@1.0.0-snapshot.v20260122110524 --save-exact

@clerk/expo

npm i @clerk/expo@3.0.0-snapshot.v20260122110524 --save-exact

@clerk/expo-passkeys

npm i @clerk/expo-passkeys@1.0.0-snapshot.v20260122110524 --save-exact

@clerk/express

npm i @clerk/express@2.0.0-snapshot.v20260122110524 --save-exact

@clerk/fastify

npm i @clerk/fastify@2.6.9-snapshot.v20260122110524 --save-exact

@clerk/localizations

npm i @clerk/localizations@4.0.0-snapshot.v20260122110524 --save-exact

@clerk/msw

npm i @clerk/msw@0.0.1-snapshot.v20260122110524 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@7.0.0-snapshot.v20260122110524 --save-exact

@clerk/nuxt

npm i @clerk/nuxt@2.0.0-snapshot.v20260122110524 --save-exact

@clerk/react

npm i @clerk/react@6.0.0-snapshot.v20260122110524 --save-exact

@clerk/react-router

npm i @clerk/react-router@3.0.0-snapshot.v20260122110524 --save-exact

@clerk/shared

npm i @clerk/shared@4.0.0-snapshot.v20260122110524 --save-exact

@clerk/tanstack-react-start

npm i @clerk/tanstack-react-start@1.0.0-snapshot.v20260122110524 --save-exact

@clerk/testing

npm i @clerk/testing@2.0.0-snapshot.v20260122110524 --save-exact

@clerk/ui

npm i @clerk/ui@1.0.0-snapshot.v20260122110524 --save-exact

@clerk/upgrade

npm i @clerk/upgrade@2.0.0-snapshot.v20260122110524 --save-exact

@clerk/vue

npm i @clerk/vue@2.0.0-snapshot.v20260122110524 --save-exact

…te imports

…or second factors

…alization

…d localization

…d component updates

…ed navigation and component structure

… update related context and imports

…roved navigation and step management

…ng new TOTP and SMS code screens

…nd types, and remove obsolete test files

…and improve type definitions for session tasks

github-actions bot added clerk-js localizations core-3 labels Jan 20, 2026

octoper force-pushed the octoper/setup-mfa-task branch from 84d9b10 to 4c19ae6 Compare January 20, 2026 20:40

vercel bot deployed to Preview January 20, 2026 20:41 View deployment

vercel bot deployed to Preview January 20, 2026 21:04 View deployment

octoper changed the title ~~wip~~ feat(clerk-js,ui): Introduce setup MFA session task Jan 20, 2026

vercel bot deployed to Preview January 20, 2026 23:28 View deployment

octoper self-assigned this Jan 20, 2026

octoper force-pushed the octoper/setup-mfa-task branch from d9e893a to 4fc95f2 Compare January 21, 2026 10:43

vercel bot deployed to Preview January 21, 2026 10:44 View deployment

octoper force-pushed the octoper/setup-mfa-task branch from 4fc95f2 to 61862a2 Compare January 22, 2026 11:04

vercel bot deployed to Preview January 22, 2026 11:05 View deployment

octoper added 11 commits January 23, 2026 20:21

wip

3cb4225

wip

d6196ab

wip

09b8b1a

refactor(ui): Move MFA utility functions to a dedicated file and upda…

704869e

…te imports

refactor(ui): Update MFA task handling and improve type definitions f…

c4c34fa

…or second factors

refactor(ui): Revamp MFA setup flow with new screens and improved loc…

dcb357a

…alization

feat(ui): Implement SMS code verification flow with new components an…

9944fee

…d localization

feat(ui): Enhance SMS code verification flow with new localization an…

deb403d

…d component updates

feat(ui): Introduce TOTP and SMS code flows for MFA setup with enhanc…

f6cac07

…ed navigation and component structure

refactor(ui): Rename TaskSetupMfa to TaskSetupMFA for consistency and…

90f25be

… update related context and imports

refactor(ui): Update MFA setup flow to use a wizard component for imp…

56f4b69

…roved navigation and step management

octoper added 3 commits January 23, 2026 20:21

feat(ui): Add localization and UI enhancements for MFA setup, includi…

5d6baa8

…ng new TOTP and SMS code screens

refactor(ui): Standardize naming for TaskSetupMFA across components a…

a552311

…nd types, and remove obsolete test files

refactor(ui): Update TaskSetupMFA to handle optional auto-navigation …

b41bd37

…and improve type definitions for session tasks

octoper force-pushed the octoper/setup-mfa-task branch from 61862a2 to b41bd37 Compare January 23, 2026 18:21

vercel bot deployed to Preview January 23, 2026 18:22 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(clerk-js,ui): Introduce setup MFA session task #7626

feat(clerk-js,ui): Introduce setup MFA session task #7626

octoper commented Jan 20, 2026

Uh oh!

changeset-bot bot commented Jan 20, 2026 •

edited

Loading

Uh oh!

vercel bot commented Jan 20, 2026 •

edited

Loading

Uh oh!

octoper commented Jan 21, 2026

Uh oh!

clerk-cookie commented Jan 21, 2026

Uh oh!

octoper commented Jan 22, 2026

Uh oh!

clerk-cookie commented Jan 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

feat(clerk-js,ui): Introduce setup MFA session task #7626

Are you sure you want to change the base?

feat(clerk-js,ui): Introduce setup MFA session task #7626

Conversation

octoper commented Jan 20, 2026

Description

Checklist

Type of change

Uh oh!

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

Uh oh!

⚠️ No Changeset found

Uh oh!

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

Uh oh!

Uh oh!

octoper commented Jan 21, 2026

Uh oh!

clerk-cookie commented Jan 21, 2026

Uh oh!

octoper commented Jan 22, 2026

Uh oh!

clerk-cookie commented Jan 22, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

changeset-bot bot commented Jan 20, 2026 •

edited

Loading

vercel bot commented Jan 20, 2026 •

edited

Loading