[services] build time service url env vars by ricardo-agz · Pull Request #14893 · vercel/vercel

ricardo-agz · 2026-02-05T21:52:12Z

Injects {SERVICE_NAME}_URL (and {FRAMEWORK_PREFIX}_{SERVICE_NAME}_URL) environment variables for all the web services that are part of the deployment
These consist of {VERCEL_URL}/{SERVICE_ROUTE_PREFIX}
This is so they are available during the build, as some frontend frameworks, e.g. Next and Vite require them to be available during build time, not just runtime

Add getServiceUrlEnvVars utility to @vercel/build-utils that generates environment variables for service URLs (e.g., BACKEND_URL, VITE_BACKEND_URL, NEXT_PUBLIC_BACKEND_URL). Wire this into the CLI build command to inject service URLs into process.env after services are detected, making them available during framework builds. Key behaviors: - Requires VERCEL_URL to generate absolute URLs - User-defined env vars take precedence (won't overwrite existing) - Generates framework-prefixed versions for all frontend frameworks in the deployment (VITE_, NEXT_PUBLIC_, etc.)

changeset-bot · 2026-02-05T21:52:19Z

🦋 Changeset detected

Latest commit: 3ee79f2

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

This PR includes changesets to release 15 packages

Name	Type
@vercel/build-utils	Patch
vercel	Patch
@vercel/backends	Patch
@vercel/client	Patch
@vercel/elysia	Patch
@vercel/express	Patch
@vercel/fastify	Patch
@vercel/gatsby-plugin-vercel-builder	Patch
@vercel/h3	Patch
@vercel/hono	Patch
@vercel/koa	Patch
@vercel/nestjs	Patch
@vercel/node	Patch
@vercel/static-build	Patch
@vercel/cervel	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-02-05T21:52:43Z

📦 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-blmk85zya.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-blmk85zya.vercel.sh/tarballs/vercel.tgz"
    }
  }
}

github-actions · 2026-02-05T21:55:14Z

🧪 Unit Test Strategy

Comparing: fc357e1 → 3ee79f2 (view diff)

Strategy: Code changed outside of a package - running all unit tests

⚠️ All unit tests will run because global code changes could impact all packages.

Affected packages - 40 (100%)

@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
vercel

Results

Unit tests: All affected packages will run unit tests
E2E tests: Handled separately (Version Packages PRs or run-e2e-tests label)
Type checks: All affected packages will run type checks

This comment is automatically generated based on the affected testing strategy

elprans · 2026-02-05T22:10:18Z

packages/build-utils/src/get-service-url-env-vars.ts

+ * e.g., "frontend" → "FRONTEND_URL", "api-users" → "API_USERS_URL"
+ */
+function serviceNameToEnvVar(name: string): string {
+  return `${name.replace(/-/g, '_').toUpperCase()}_URL`;


Do we have a restricted alphabet for service names? is it [alpha][alnum]*?

This PR was opened by the [Changesets release](https://github.com/changesets/action) GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated. # Releases ## @vercel/frameworks@3.17.0 ### Minor Changes - Add experimental Go runtime framework preset. ([#14865](#14865)) This adds support for deploying standalone Go HTTP servers (using `package main` with `func main()`) in addition to the existing serverless function pattern. The preset supports: - `main.go` at project root (simple projects) - `cmd/api/main.go` (API servers) - `cmd/server/main.go` (HTTP servers) The Go application must listen on the port specified by the `PORT` environment variable. ## @vercel/go@3.4.0 ### Minor Changes - Add experimental Go runtime framework preset. ([#14865](#14865)) This adds support for deploying standalone Go HTTP servers (using `package main` with `func main()`) in addition to the existing serverless function pattern. The preset supports: - `main.go` at project root (simple projects) - `cmd/api/main.go` (API servers) - `cmd/server/main.go` (HTTP servers) The Go application must listen on the port specified by the `PORT` environment variable. ## @vercel/backends@0.0.29 ### Patch Changes - Updated dependencies \[[`fc357e11cb4b00ab8ec413a0ea3586a87e733f0e`](fc357e1), [`ff320caa5c8a0857aad0b989699207a6a703256f`](ff320ca)]: - @vercel/build-utils@13.3.2 ## @vercel/build-utils@13.3.2 ### Patch Changes - Improve memory efficiency in `FileBlob.fromStream()` by avoiding unnecessary buffer copies when chunks are already Buffers ([#14701](#14701)) - [services] build time service url env vars ([#14893](#14893)) - Updated dependencies \[[`7a747344dfb778a650da2ee5f7fba8c974098b42`](7a74734)]: - @vercel/python-analysis@0.3.1 ## @vercel/cervel@0.0.16 ### Patch Changes - Updated dependencies \[]: - @vercel/backends@0.0.29 ## vercel@50.12.2 ### Patch Changes - Add source and defaultResourceName query params to legacy integration add web UI path ([#14868](#14868)) - [services] build time service url env vars ([#14893](#14893)) - Updated dependencies \[[`fc357e11cb4b00ab8ec413a0ea3586a87e733f0e`](fc357e1), [`84f121190813b2840a6a16279dcaa75dcb2872cd`](84f1211), [`ff320caa5c8a0857aad0b989699207a6a703256f`](ff320ca)]: - @vercel/build-utils@13.3.2 - @vercel/go@3.4.0 - @vercel/backends@0.0.29 - @vercel/elysia@0.1.31 - @vercel/express@0.1.40 - @vercel/fastify@0.1.34 - @vercel/h3@0.1.40 - @vercel/hono@0.2.34 - @vercel/hydrogen@1.3.5 - @vercel/koa@0.1.14 - @vercel/nestjs@0.2.35 - @vercel/next@4.15.23 - @vercel/node@5.5.32 - @vercel/python@6.6.0 - @vercel/redwood@2.4.9 - @vercel/remix-builder@5.5.10 - @vercel/ruby@2.2.5 - @vercel/rust@1.0.5 - @vercel/static-build@2.8.33 ## @vercel/client@17.2.35 ### Patch Changes - Updated dependencies \[[`fc357e11cb4b00ab8ec413a0ea3586a87e733f0e`](fc357e1), [`ff320caa5c8a0857aad0b989699207a6a703256f`](ff320ca)]: - @vercel/build-utils@13.3.2 ## @vercel/elysia@0.1.31 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.5.32 ## @vercel/express@0.1.40 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.5.32 - @vercel/cervel@0.0.16 ## @vercel/fastify@0.1.34 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.5.32 ## @vercel/fs-detectors@5.8.2 ### Patch Changes - Updated dependencies \[[`84f121190813b2840a6a16279dcaa75dcb2872cd`](84f1211)]: - @vercel/frameworks@3.17.0 ## @vercel/gatsby-plugin-vercel-builder@2.0.131 ### Patch Changes - Updated dependencies \[[`fc357e11cb4b00ab8ec413a0ea3586a87e733f0e`](fc357e1), [`ff320caa5c8a0857aad0b989699207a6a703256f`](ff320ca)]: - @vercel/build-utils@13.3.2 ## @vercel/h3@0.1.40 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.5.32 ## @vercel/hono@0.2.34 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.5.32 ## @vercel/koa@0.1.14 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.5.32 ## @vercel/nestjs@0.2.35 ### Patch Changes - Updated dependencies \[]: - @vercel/node@5.5.32 ## @vercel/node@5.5.32 ### Patch Changes - Updated dependencies \[[`fc357e11cb4b00ab8ec413a0ea3586a87e733f0e`](fc357e1), [`ff320caa5c8a0857aad0b989699207a6a703256f`](ff320ca)]: - @vercel/build-utils@13.3.2 ## @vercel/python-analysis@0.3.1 ### Patch Changes - fix ESM/CJS cross-compatibility ([#14869](#14869)) ## @vercel/static-build@2.8.33 ### Patch Changes - Updated dependencies \[]: - @vercel/gatsby-plugin-vercel-builder@2.0.131 Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

ricardo-agz added 2 commits February 5, 2026 13:45

tests

5a5eb93

vercel bot deployed to Preview February 5, 2026 21:52 View deployment

unset

a87b4a8

vercel bot deployed to Preview February 5, 2026 21:58 View deployment

ricardo-agz marked this pull request as ready for review February 5, 2026 21:58

ricardo-agz requested a review from a team as a code owner February 5, 2026 21:58

Create olive-turtles-destroy.md

3ee79f2

ricardo-agz requested review from jeffsee55, nsidnev and tknickman February 5, 2026 22:02

vercel bot deployed to Preview February 5, 2026 22:02 View deployment

ricardo-agz requested review from 1st1 and elprans February 5, 2026 22:05

jeffsee55 approved these changes Feb 5, 2026

View reviewed changes

ricardo-agz merged commit ff320ca into main Feb 5, 2026
144 checks passed

ricardo-agz deleted the ricardo/be-426-services-env-vars branch February 5, 2026 22:27

vercel-release-bot mentioned this pull request Feb 5, 2026

Version Packages #14890

Merged

elprans approved these changes Feb 5, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[services] build time service url env vars#14893

[services] build time service url env vars#14893
ricardo-agz merged 4 commits intomainfrom
ricardo/be-426-services-env-vars

ricardo-agz commented Feb 5, 2026 •

edited

Loading

Uh oh!

changeset-bot bot commented Feb 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 5, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 5, 2026 •

edited

Loading

Uh oh!

Uh oh!

elprans Feb 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

ricardo-agz commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Feb 5, 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 Feb 5, 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

Uh oh!

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

Uh oh!

🧪 Unit Test Strategy

Results

Uh oh!

Uh oh!

elprans Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

ricardo-agz commented Feb 5, 2026 •

edited

Loading

changeset-bot bot commented Feb 5, 2026 •

edited

Loading

github-actions bot commented Feb 5, 2026 •

edited

Loading

github-actions bot commented Feb 5, 2026 •

edited

Loading