feat(clerk-js): Introduce development modal to enable organizations

[LauraBeatris]

Description

This PR allows developers to enable the organization's featureset in-app instead of having to go to the Clerk Dashboard, decreasing friction to build B2B apps.

The prompt only appears for development instances only.

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:

[changeset-bot]

🦋 Changeset detected

Latest commit: 5aebc26

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

This PR includes changesets to release 22 packages

Name	Type
@clerk/clerk-js	Minor
@clerk/shared	Minor
@clerk/clerk-react	Minor
@clerk/vue	Minor
@clerk/chrome-extension	Patch
@clerk/clerk-expo	Patch
@clerk/agent-toolkit	Patch
@clerk/astro	Patch
@clerk/backend	Patch
@clerk/elements	Patch
@clerk/expo-passkeys	Patch
@clerk/express	Patch
@clerk/fastify	Patch
@clerk/nextjs	Patch
@clerk/nuxt	Patch
@clerk/react-router	Patch
@clerk/remix	Patch
@clerk/tanstack-react-start	Patch
@clerk/testing	Patch
@clerk/themes	Patch
@clerk/types	Patch
@clerk/localizations	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

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Comment	Nov 13, 2025 7:37pm

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch laura/enable-orgs

---

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

[LauraBeatris]

I've added this handling to avoid updating the state multiple times if there's already a enableOrganizationsPrompt entry.

Since this can be called multiple times if there are multiple components/hooks on the same page:

[LauraBeatris]

Our components also use organizations hooks internally, and therefore prompting with it would cause developers to be confused: "i've rendered OrganizationSwitcher but the prompt is mentioning useOrganization"

So I believe it makes sense to open the prompt on the first call and avoid updating the state afterwards.

[LauraBeatris]

Here's a video of the current state of the UI:

Area.mp4

[LauraBeatris]

There's still some delay in which the window is reloading and the screen kepts showing a blank state without having the component mounted due to the stale environment data.

I'm thinking of applying an optimistic update, at least on the "enabled" status, to have the components mounted meanwhile, or not closing the modal and introduce a loading status until the window gets reloaded.

[LauraBeatris]

Waiting on https://github.com/clerk/clerk_go/pull/14838/files to be merged to send a allow_personal_accounts field