[cli] Preserve --environment in web UI fallback URLs by qiao · Pull Request #15493 · vercel/vercel

qiao · 2026-03-12T17:15:31Z

Summary

https://linear.app/vercel/issue/MKT-2932/pre-fill-web-fallback-ui-with-environment-and-prefix-is-these-flags

When integration add falls back to the browser (unsupported product, non-subscription billing plan, or auto-provision 422), the --environment flag was being dropped. This threads it through as an environment query param so the checkout page can pre-select the correct environments.

add.ts: pass environments to provisionResourceViaWebUI and append to URL
add-auto-provision.ts: append environment param to fallback URL
Tests for all three fallback scenarios

Related PRs

Follows the same pattern established by:

[cli] Add --plan flag to vercel integration add #14965 (--plan → planId in fallback URLs)
feat(cli): Add source and defaultResourceName to legacy integration add path #14868 (source=cli + defaultResourceName in fallback URLs)

Test plan

Unit test: auto-provision fallback includes environment param
Unit test: unsupported product web UI includes environment param
Unit test: non-subscription plan web UI includes environment param

When `integration add` falls back to the browser (unsupported product, non-subscription plan, or auto-provision 422), the user's --environment selection was being dropped. Thread it through as an `environment` query param so the checkout page can pre-select the correct environments.

changeset-bot · 2026-03-12T17:15:36Z

🦋 Changeset detected

Latest commit: 6a3c1ed

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

This PR includes changesets to release 1 package

Name	Type
vercel	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

github-actions · 2026-03-12T17:16:21Z

📦 CLI Tarball Ready

The Vercel CLI tarball for this PR is now available!

Quick Test

You can test this PR's CLI directly by running:

npx https://vercel-r0sx7iekg.vercel.sh/tarballs/vercel.tgz --help

Use in vercel.json

To use this CLI version in your project builds, add to your vercel.json:

{
  "build": {
    "env": {
      "VERCEL_CLI_VERSION": "vercel@https://vercel-r0sx7iekg.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

Python Runtime Wheel

A vercel-runtime wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_RUNTIME_PYTHON="vercel-runtime @ https://vercel-r0sx7iekg.vercel.sh/tarballs/vercel_runtime-0.9.0.dev1773435860+6a3c1ed-py3-none-any.whl"

Python Workers Wheel

A vercel-workers wheel was also built for this PR.
To use in your Python project builds, also set this environment variable:

VERCEL_WORKERS_PYTHON="vercel-workers @ https://vercel-r0sx7iekg.vercel.sh/tarballs/vercel_workers-0.1.0.dev1773435860+6a3c1ed-py3-none-any.whl"

github-actions · 2026-03-12T17:18:15Z

🧪 Unit Test Strategy

Comparing: d8c186e → 6a3c1ed (view diff)

Strategy: Affected packages only

✅ Only testing packages that have been modified or depend on modified packages.

Affected packages - 1 (3%)

vercel

Unaffected packages - 39 (98%)

@vercel-internals/get-package-json
@vercel/backends
@vercel/build-utils
@vercel/cervel
@vercel/cli-auth
@vercel/client
@vercel/config
@vercel/detect-agent
@vercel/edge
@vercel/elysia
@vercel/error-utils
@vercel/express
@vercel/fastify
@vercel/firewall
@vercel/frameworks
@vercel/fs-detectors
@vercel/functions
@vercel/gatsby-plugin-vercel-builder
@vercel/go
@vercel/h3
@vercel/hono
@vercel/hydrogen
@vercel/koa
@vercel/nestjs
@vercel/next
@vercel/node
@vercel/oidc
@vercel/oidc-aws-credentials-provider
@vercel/python
@vercel/python-analysis
@vercel/redwood
@vercel/related-projects
@vercel/remix-builder
@vercel/routing-utils
@vercel/ruby
@vercel/rust
@vercel/static-build
@vercel/static-config
examples

Results

Unit tests: Only affected packages will run unit tests
E2E tests: Running in parallel via E2E Tests workflow
Type checks: Only affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

vercel · 2026-03-12T18:12:30Z

Low Risk — CLI URL param passthrough + tests — no auth, billing logic, or schema changes.

add.ts: pass environmentstoprovisionResourceViaWebUI`, append as query param
add-auto-provision.ts: append environment` query param to fallback URL
add*.test.ts`: add tests for environment param in fallback URLs

^{Assessed at 6a3c1ed.}

packages/cli/test/unit/commands/integration/add-auto-provision.test.ts

packages/cli/src/commands/integration/add-auto-provision.ts

tonypan2

See inline comments.

🤖 Written by Claude Code on behalf of @tonypan

…l/vercel into cli/environment-web-ui-passthrough

qiao requested review from a team as code owners March 12, 2026 17:15

vercel bot deployed to Preview March 12, 2026 17:16 View deployment

qiao requested a review from tonypan2 March 12, 2026 17:16

tonypan2 reviewed Mar 12, 2026

View reviewed changes

packages/cli/test/unit/commands/integration/add-auto-provision.test.ts Show resolved Hide resolved

tonypan2 reviewed Mar 12, 2026

View reviewed changes

packages/cli/test/unit/commands/integration/add-auto-provision.test.ts Show resolved Hide resolved

tonypan2 reviewed Mar 12, 2026

View reviewed changes

packages/cli/src/commands/integration/add-auto-provision.ts Show resolved Hide resolved

tonypan2 requested changes Mar 12, 2026

View reviewed changes

Merge branch 'main' into cli/environment-web-ui-passthrough

e0e49fd

vercel bot deployed to Preview March 12, 2026 19:22 View deployment

qiao added 2 commits March 13, 2026 12:09

Address comments on more test cases

6a66b02

Merge branch 'cli/environment-web-ui-passthrough' of github.com:verce…

c94601b

…l/vercel into cli/environment-web-ui-passthrough

qiao requested a review from tonypan2 March 13, 2026 19:10

vercel bot deployed to Preview March 13, 2026 19:10 View deployment

tonypan2 approved these changes Mar 13, 2026

View reviewed changes

Merge branch 'main' into cli/environment-web-ui-passthrough

6ee897b

qiao enabled auto-merge (squash) March 13, 2026 19:21

vercel bot deployed to Preview March 13, 2026 19:22 View deployment

github-actions bot mentioned this pull request Mar 13, 2026

[CI Failure Doctor] 🏥 CI Failure Investigation - Run #3961 #15537

Closed

4 tasks

Merge branch 'main' into cli/environment-web-ui-passthrough

6a3c1ed

vercel bot deployed to Preview March 13, 2026 21:05 View deployment

qiao merged commit 8ee6645 into main Mar 13, 2026
178 checks passed

qiao deleted the cli/environment-web-ui-passthrough branch March 13, 2026 21:20

vercel-cli-release-bot mentioned this pull request Mar 13, 2026

Version Packages #15507

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[cli] Preserve --environment in web UI fallback URLs#15493

[cli] Preserve --environment in web UI fallback URLs#15493
qiao merged 6 commits intomainfrom
cli/environment-web-ui-passthrough

qiao commented Mar 12, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

vercel bot commented Mar 12, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

tonypan2 left a comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

qiao commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Related PRs

Test plan

Uh oh!

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

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 CLI Tarball Ready

Quick Test

Use in vercel.json

Python Runtime Wheel

Python Workers Wheel

Uh oh!

github-actions bot commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

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

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

tonypan2 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

qiao commented Mar 12, 2026 •

edited

Loading

changeset-bot bot commented Mar 12, 2026 •

edited

Loading

github-actions bot commented Mar 12, 2026 •

edited

Loading

github-actions bot commented Mar 12, 2026 •

edited

Loading

vercel bot commented Mar 12, 2026 •

edited

Loading