chore(elements): Support next@16

[nikosdouvlis]

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

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

Summary by CodeRabbit

• Chores
  • Expanded Next.js peer dependency support to include v16 and updated compatibility ranges for versions 13, 14, and 15.
  • Added a changeset entry recording the dependency update.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 8f258cf

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

This PR includes changesets to release 1 package

Name	Type
@clerk/elements	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 21, 2025 4:14am

[coderabbitai]

Walkthrough

This PR updates Next.js peer dependency compatibility in packages/elements/package.json to support Next.js v16 (^16) and adjusts patch/minor version constraints across supported Next.js release lines; includes a changeset entry.

Changes

Cohort / File(s)	Summary
Changeset metadata .changeset/honest-baths-brush.md	Patch changeset entry recording the dependency update.
Peer dependency update packages/elements/package.json	Updated peerDependencies.next from `"^13.5.4

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

• Single dependency field change; no code or API modifications.
• Quick checks: ensure version ranges match release policy and changelog expectations.

Possibly related issues

• clerk/javascript#7246: Updates the same packages/elements/package.json peerDependency to include ^16, addressing Next.js v16 support.

Poem

🐰 A newer version hops along,
Next.js sixteen, steady and true,
Range pins nudged, the garden grows,
Old and new now welcome through.

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'chore(elements): Support next@16' directly matches the primary change—updating Next.js peer dependencies in the elements package to support version 16.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch nikos/elements-peer-deps

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 1b84ae8 and 8f258cf.

📒 Files selected for processing (2)

• .changeset/honest-baths-brush.md (1 hunks)
• packages/elements/package.json (1 hunks)

🚧 Files skipped from review as they are similar to previous changes (1)

• packages/elements/package.json

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (30)

• GitHub Check: Integration Tests (react-router, chrome)
• GitHub Check: Integration Tests (quickstart, chrome, 15)
• GitHub Check: Integration Tests (quickstart, chrome, 16)
• GitHub Check: Integration Tests (nextjs, chrome, 16)
• GitHub Check: Integration Tests (nextjs, chrome, 15, RQ)
• GitHub Check: Integration Tests (billing, chrome)
• GitHub Check: Integration Tests (nextjs, chrome, 15)
• GitHub Check: Integration Tests (astro, chrome)
• GitHub Check: Integration Tests (nextjs, chrome, 14)
• GitHub Check: Integration Tests (machine, chrome)
• GitHub Check: Integration Tests (custom, chrome)
• GitHub Check: Integration Tests (billing, chrome, RQ)
• GitHub Check: Integration Tests (nuxt, chrome)
• GitHub Check: Integration Tests (express, chrome)
• GitHub Check: Integration Tests (sessions, chrome)
• GitHub Check: Integration Tests (tanstack-react-start, chrome)
• GitHub Check: Integration Tests (generic, chrome)
• GitHub Check: Integration Tests (ap-flows, chrome)
• GitHub Check: Integration Tests (vue, chrome)
• GitHub Check: Integration Tests (sessions:staging, chrome)
• GitHub Check: Integration Tests (handshake:staging, chrome)
• GitHub Check: Integration Tests (expo-web, chrome)
• GitHub Check: Integration Tests (handshake, chrome)
• GitHub Check: Integration Tests (elements, chrome)
• GitHub Check: Integration Tests (localhost, chrome)
• GitHub Check: Unit Tests (22, **)
• GitHub Check: Publish with pkg-pr-new
• GitHub Check: Unit Tests (22, shared, clerk-js, RQ)
• GitHub Check: Static analysis
• GitHub Check: semgrep-cloud-platform/scan

🔇 Additional comments (1)

.changeset/honest-baths-brush.md (1)

1-5: Well‑formatted changeset with appropriate message.

The changeset correctly documents the peer dependency update with the proper format (YAML frontmatter + changelog message) and applies a patch bump type, which is appropriate for peer dependency maintenance. The changelog message aligns with the PR objective and matches the previous reviewer's suggestion.

---

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

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (1)

.changeset/honest-baths-brush.md (1)

5-5: Consider providing more context in the changeset description.

The description mentions adding Next.js v16 support but doesn't explain the minimum version bumps on existing ranges (13.5.7, 14.2.25, 15.2.3). Consider clarifying whether these are required for compatibility or just updated constraints.

For example, update the description to:

Update peerDependencies to support NextJs v16 and adjust minimum version constraints for existing ranges to address compatibility issues.

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 77e022f and 1b84ae8.

📒 Files selected for processing (2)

• .changeset/honest-baths-brush.md (1 hunks)
• packages/elements/package.json (1 hunks)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (5)

• GitHub Check: Formatting | Dedupe | Changeset
• GitHub Check: Build Packages
• GitHub Check: semgrep-cloud-platform/scan
• GitHub Check: semgrep-cloud-platform/scan
• GitHub Check: Analyze (javascript-typescript)

🔇 Additional comments (1)

packages/elements/package.json (1)

93-93: Verify compatibility testing with Next.js v16 and clarify minimum version constraints.

The peer dependency update adds support for Next.js v16 and adjusts minimum versions for existing ranges. The version bumps (14.0.3→14.2.25 and the addition of 15.2.3 constraints) suggest addressing compatibility issues, but the rationale is not documented in the PR description or commit messages.

Before merging, ensure that:

1. Next.js v16 compatibility has been verified (particularly with @clerk/elements' Next.js-specific features).
2. The minimum version bumps (13.5.7, 14.2.25, 15.2.3) are justified (e.g., bug fixes, API stability) rather than arbitrary constraints.
3. Existing consumers on v13.5.4, v14.0.x, or earlier v15 patches receive clear migration guidance if they need to upgrade.

[pkg-pr-new]

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7274

@clerk/astro

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

@clerk/backend

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

@clerk/chrome-extension

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

@clerk/clerk-js

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

@clerk/dev-cli

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

@clerk/elements

npm i https://pkg.pr.new/@clerk/elements@7274

@clerk/clerk-expo

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

@clerk/expo-passkeys

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

@clerk/express

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

@clerk/fastify

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

@clerk/localizations

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

@clerk/nextjs

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

@clerk/nuxt

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

@clerk/clerk-react

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

@clerk/react-router

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

@clerk/remix

npm i https://pkg.pr.new/@clerk/remix@7274

@clerk/shared

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

@clerk/tanstack-react-start

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

@clerk/testing

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

@clerk/themes

npm i https://pkg.pr.new/@clerk/themes@7274

@clerk/types

npm i https://pkg.pr.new/@clerk/types@7274

@clerk/upgrade

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

@clerk/vue

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

commit: 8f258cf