Skip to content

feat(turbopack): support import.meta.env - #96225

Merged
timneutkens merged 4 commits into
canaryfrom
codex/import-meta-env
Jul 28, 2026
Merged

feat(turbopack): support import.meta.env#96225
timneutkens merged 4 commits into
canaryfrom
codex/import-meta-env

Conversation

@timneutkens

@timneutkens timneutkens commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Summary

  • add native Turbopack support for import.meta.env.DEV, PROD, MODE, BASE_URL, and SSR
  • statically analyze built-in values for dead-code elimination while exposing the complete runtime object
  • derive BASE_URL from the Next.js basePath and include Vite-compatible trailing-slash formatting
  • add TypeScript declarations, focused execution and Next.js integration coverage, and Vite migration documentation

Verification

  • cargo fmt --all -- --check
  • cargo nextest run -p turbopack-tests -E 'test(import_meta_env)'
  • pnpm build-all
  • pnpm --filter=next types
  • NEXT_TEST_PREFER_OFFLINE=1 pnpm test-dev-turbo test/e2e/import-meta-env/import-meta-env.test.ts
  • NEXT_TEST_PREFER_OFFLINE=1 pnpm test-start-turbo test/e2e/import-meta-env/import-meta-env.test.ts

Comment thread docs/01-app/03-api-reference/08-turbopack.mdx
Comment thread turbopack/crates/turbopack-ecmascript/src/analyzer/well_known/mod.rs Outdated
@timneutkens
timneutkens force-pushed the codex/import-meta-env branch from 28a9ff6 to 8f6be48 Compare July 27, 2026 19:55
@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Stats from current PR

🟢 1 improvement

Metric Canary PR Change Trend
node_modules Size 550 MB 547 MB 🟢 3.37 MB (-1%) ▁▁▁▁▁
📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 814ms 813ms ▁▁▂█▂
Cold (Ready in log) 789ms 795ms ▁▁▁█▂
Cold (First Request) 1.342s 1.352s ▁▁▁█▂
Warm (Listen) 813ms 813ms ▂▁▂█▂
Warm (Ready in log) 797ms 795ms ▁▁▁█▂
Warm (First Request) 1.338s 1.322s ▁▂▁█▂
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 811ms 812ms ▄▁▄▄█
Cold (Ready in log) 773ms 784ms ▃▁▁▂█
Cold (First Request) 3.358s 3.455s ▂▃▂▂█
Warm (Listen) 814ms 812ms █████
Warm (Ready in log) 788ms 784ms ▂▂▂▂█
Warm (First Request) 3.521s 3.469s ▁▃▁▄█

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.623s 5.625s ▁▁▂█▂
Cached Build 5.756s 5.904s ▁▁▁█▃
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.333s 24.649s ▅▄▃▁█
Cached Build 24.365s 24.698s ▃▃▁▁█
node_modules Size 550 MB 547 MB 🟢 3.37 MB (-1%) ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
00984xh3ankve.js gzip 7.4 kB N/A -
00lv61-dw-p1s.js gzip 71.2 kB N/A -
0a-p0meqxynjz.js gzip 10.3 kB N/A -
0avtke4yefj4-.js gzip 13.1 kB N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0fkgqovmj3kd_.js gzip 156 B N/A -
0pt5of3ch6d2u.js gzip 13.6 kB N/A -
0s_6le5473zon.js gzip 153 B N/A -
0utq7k-24q3k_.js gzip 157 B N/A -
0xnsdo-6y9r3k.js gzip 5.72 kB N/A -
0yi7is8u4covm.js gzip 8.77 kB N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1prv-wg6jgtt2.js gzip 8.77 kB N/A -
1t47vod02e_4a.js gzip 8.75 kB N/A -
1tf1phijqlx9j.js gzip 220 B 220 B
1tw002sq5bo4l.js gzip 10 kB N/A -
1wlerik1n7zbr.js gzip 8.7 kB N/A -
2_zr4masp3rwy.js gzip 155 B N/A -
25xtago53_2xf.js gzip 160 B N/A -
2b2322zzwplhu.js gzip 161 B N/A -
2lviwqiqxm904.js gzip 3.52 kB N/A -
2pevdqjpbf3xk.js gzip 9.45 kB N/A -
2qd2anu9eizlz.js gzip 8.75 kB N/A -
2se72tcn7ulb_.js gzip 154 B N/A -
2sv39ae5_8vfj.js gzip 8.81 kB N/A -
2utx6n7w65xqa.js gzip 8.7 kB N/A -
2x2jbjxj8_k8h.js gzip 155 B N/A -
3-mgi7apkkmqn.js gzip 169 B N/A -
3-ukivglqkfeq.js gzip 8.78 kB N/A -
325xisqrylugu.js gzip 450 B N/A -
32fs4p58op4zm.js gzip 65.6 kB N/A -
367gc92a9294o.js gzip 158 B N/A -
3eswx3idwrkj8.js gzip 46.2 kB N/A -
3jc9ghvds1spf.js gzip 2.29 kB N/A -
3juwkvkgvywfe.js gzip 10.6 kB N/A -
3kbove7q58uqh.js gzip 13.2 kB N/A -
3kyroy-o6ffl5.js gzip 154 B N/A -
3md__14nrd0du.js gzip 156 B N/A -
3qn7vntp30gaj.js gzip 1.47 kB N/A -
3yz9mvl23_vys.js gzip 156 B N/A -
turbopack-00..nycg.js gzip 3.86 kB N/A -
turbopack-03..h4gn.js gzip 3.85 kB N/A -
turbopack-04..7jl6.js gzip 3.84 kB N/A -
turbopack-07..hdpt.js gzip 3.85 kB N/A -
turbopack-07..6ba4.js gzip 3.84 kB N/A -
turbopack-0a..weg2.js gzip 3.84 kB N/A -
turbopack-0a..ncn4.js gzip 3.85 kB N/A -
turbopack-0b..vyhj.js gzip 3.84 kB N/A -
turbopack-16..dn94.js gzip 3.84 kB N/A -
turbopack-1a..ymrt.js gzip 3.84 kB N/A -
turbopack-20..b45f.js gzip 3.85 kB N/A -
turbopack-2f..he3a.js gzip 3.82 kB N/A -
turbopack-3s..7_iy.js gzip 3.84 kB N/A -
turbopack-3y..s536.js gzip 3.84 kB N/A -
030a1njeh5b77.js gzip N/A 10 kB -
040byd99yski1.js gzip N/A 157 B -
0ev_hnv3jxpfc.js gzip N/A 45.2 kB -
0f5gxnfqdomje.js gzip N/A 156 B -
0fsconcqw__ge.js gzip N/A 155 B -
0inszdzepj4nu.js gzip N/A 71.1 kB -
0ot0qt5np20h7.js gzip N/A 8.78 kB -
12m9rr7_7cexd.js gzip N/A 8.7 kB -
1504ulb4wy-ci.js gzip N/A 168 B -
186r3y_rfvr0b.js gzip N/A 8.78 kB -
19v97848yrjp7.js gzip N/A 8.81 kB -
1d6k_0r45ituk.js gzip N/A 158 B -
1infbfbijhrf3.js gzip N/A 155 B -
1nd_0rwgz2ozk.js gzip N/A 9.45 kB -
1oi9pltr_e10m.js gzip N/A 10.6 kB -
1px_yvc50vdqw.js gzip N/A 155 B -
1rd9tzqgzsz2w.js gzip N/A 8.77 kB -
1rq1g_cwv642d.js gzip N/A 10.3 kB -
1uojw_uabeg93.js gzip N/A 450 B -
1w-7lusgyl81y.js gzip N/A 8.7 kB -
21h56wdn9zddo.js gzip N/A 8.75 kB -
2ezbkax1wpax7.js gzip N/A 156 B -
2hifxandmlxt6.js gzip N/A 156 B -
2lg10omv7xu14.js gzip N/A 3.52 kB -
2ovff1533zvno.js gzip N/A 13.2 kB -
2s4z8jy0z7v93.js gzip N/A 1.46 kB -
2y6gb5bs4mnam.js gzip N/A 8.75 kB -
340uo343e-ols.js gzip N/A 152 B -
341h71ln1jpl3.js gzip N/A 2.29 kB -
34ttpt_n7605h.js gzip N/A 5.72 kB -
36ckfq9o-ys-a.js gzip N/A 13.1 kB -
38n1na-4zsfpn.js gzip N/A 7.41 kB -
3a8nxso6ehjpa.js gzip N/A 65.6 kB -
3bkm4u2nqqu8u.js gzip N/A 161 B -
3euiwa3al4zcz.js gzip N/A 155 B -
3nz1-rn_lqqgn.js gzip N/A 161 B -
3vdh6_u50pu5t.js gzip N/A 13.6 kB -
turbopack-03..vf45.js gzip N/A 3.8 kB -
turbopack-0o..ej5r.js gzip N/A 3.82 kB -
turbopack-0p..s82b.js gzip N/A 3.8 kB -
turbopack-0q..k6q-.js gzip N/A 3.8 kB -
turbopack-1a..mxjn.js gzip N/A 3.8 kB -
turbopack-1t..im68.js gzip N/A 3.8 kB -
turbopack-21..2zyd.js gzip N/A 3.8 kB -
turbopack-27..wy4e.js gzip N/A 3.81 kB -
turbopack-27..cr0_.js gzip N/A 3.8 kB -
turbopack-29..j3-e.js gzip N/A 3.8 kB -
turbopack-2o..revh.js gzip N/A 3.8 kB -
turbopack-2u..d2hl.js gzip N/A 3.78 kB -
turbopack-2w..9ns4.js gzip N/A 3.8 kB -
turbopack-30..-la7.js gzip N/A 3.8 kB -
Total 450 kB 448 kB ✅ -1.65 kB

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 776 B 774 B
Total 776 B 774 B ✅ -2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 432 B 433 B
Total 432 B 433 B ⚠️ +1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 64.8 kB N/A -
4191.HASH.js gzip 169 B N/A -
7920-HASH.js gzip 4.68 kB N/A -
9784-HASH.js gzip 5.63 kB N/A -
b1ad9f4c-HASH.js gzip 63 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB
main-app-HASH.js gzip 255 B 254 B
main-HASH.js gzip 40 kB 40 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 64.5 kB -
8590-HASH.js gzip N/A 5.61 kB -
9750-HASH.js gzip N/A 4.69 kB -
a8984546-HASH.js gzip N/A 62.9 kB -
Total 240 kB 239 kB ✅ -526 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 194 B 193 B
_error-HASH.js gzip 181 B 182 B
css-HASH.js gzip 334 B 331 B
dynamic-HASH.js gzip 1.81 kB 1.81 kB
edge-ssr-HASH.js gzip 255 B 253 B
head-HASH.js gzip 349 B 351 B
hooks-HASH.js gzip 382 B 384 B
image-HASH.js gzip 581 B 582 B
index-HASH.js gzip 260 B 259 B
link-HASH.js gzip 2.48 kB 2.48 kB
routerDirect..HASH.js gzip 317 B 318 B
script-HASH.js gzip 384 B 386 B
withRouter-HASH.js gzip 316 B 315 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.95 kB 7.95 kB ⚠️ +1 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 128 kB
page.js gzip 292 kB 289 kB 🟢 2.92 kB (-1%)
Total 420 kB 417 kB ✅ -3.73 kB
Middleware
Canary PR Change
middleware-b..fest.js gzip 617 B 619 B
middleware-r..fest.js gzip 156 B 156 B
middleware.js gzip 45.5 kB 45.3 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 47.1 kB 46.9 kB ✅ -177 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 718 B 718 B
Total 718 B 718 B
Build Cache
Canary PR Change
0.pack gzip 4.82 MB 4.6 MB 🟢 222 kB (-5%)
index.pack gzip 122 kB 123 kB
index.pack.old gzip 122 kB 121 kB
Total 5.07 MB 4.84 MB ✅ -222 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 372 kB 368 kB 🟢 3.67 kB (-1%)
app-page-exp..prod.js gzip 205 kB 204 kB
app-page-tur...dev.js gzip 371 kB 368 kB 🟢 3.66 kB (-1%)
app-page-tur..prod.js gzip 205 kB 204 kB
app-page-tur...dev.js gzip 368 kB 364 kB 🟢 3.72 kB (-1%)
app-page-tur..prod.js gzip 203 kB 202 kB
app-page.run...dev.js gzip 368 kB 364 kB 🟢 3.71 kB (-1%)
app-page.run..prod.js gzip 203 kB 202 kB
app-route-ex...dev.js gzip 82.5 kB 81.8 kB
app-route-ex..prod.js gzip 55.9 kB 55.6 kB
app-route-tu...dev.js gzip 82.5 kB 81.8 kB
app-route-tu..prod.js gzip 55.9 kB 55.6 kB
app-route-tu...dev.js gzip 82.1 kB 81.4 kB
app-route-tu..prod.js gzip 55.7 kB 55.4 kB
app-route.ru...dev.js gzip 82.1 kB 81.4 kB
app-route.ru..prod.js gzip 55.7 kB 55.4 kB
dev-validati...dev.js gzip 132 kB 132 kB
dev-validati...dev.js gzip 132 kB 132 kB
dev-validati...dev.js gzip 130 kB 130 kB
dev-validati...dev.js gzip 130 kB 130 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 45.4 kB 45.4 kB
pages-api-tu..prod.js gzip 34.1 kB 34.1 kB
pages-api.ru...dev.js gzip 45.4 kB 45.4 kB
pages-api.ru..prod.js gzip 34.1 kB 34.1 kB
pages-turbo....dev.js gzip 54.9 kB 54.9 kB
pages-turbo...prod.js gzip 39.8 kB 39.7 kB
pages.runtim...dev.js gzip 54.9 kB 54.8 kB
pages.runtim..prod.js gzip 39.7 kB 39.7 kB
server.runti..prod.js gzip 68.3 kB 68.2 kB
use-cache-pr...dev.js gzip 72 kB 72 kB
use-cache-pr...dev.js gzip 72 kB 72 kB
use-cache-pr...dev.js gzip 70.3 kB 70.3 kB
use-cache-pr...dev.js gzip 70.3 kB 70.3 kB
Total 4.07 MB 4.05 MB ✅ -24 kB
📝 Changed Files (33 files)

Files with changes:

  • app-page-exp..ntime.dev.js
  • app-page-exp..time.prod.js
  • app-page-tur..ntime.dev.js
  • app-page-tur..time.prod.js
  • app-page-tur..ntime.dev.js
  • app-page-tur..time.prod.js
  • app-page.runtime.dev.js
  • app-page.runtime.prod.js
  • app-route-ex..ntime.dev.js
  • app-route-ex..time.prod.js
  • app-route-tu..ntime.dev.js
  • app-route-tu..time.prod.js
  • app-route-tu..ntime.dev.js
  • app-route-tu..time.prod.js
  • app-route.runtime.dev.js
  • app-route.ru..time.prod.js
  • dev-validati..ntime.dev.js
  • dev-validati..ntime.dev.js
  • dev-validati..ntime.dev.js
  • dev-validati..ntime.dev.js
  • ... and 13 more
View diffs
app-page-exp..ntime.dev.js
failed to diff
app-page-exp..time.prod.js
failed to diff
app-page-tur..ntime.dev.js
failed to diff
app-page-tur..time.prod.js
failed to diff
app-page-tur..ntime.dev.js
failed to diff
app-page-tur..time.prod.js
failed to diff
app-page.runtime.dev.js
failed to diff
app-page.runtime.prod.js
failed to diff
app-route-ex..ntime.dev.js

Diff too large to display

app-route-ex..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route.runtime.dev.js

Diff too large to display

app-route.ru..time.prod.js

Diff too large to display

dev-validati..ntime.dev.js
failed to diff
dev-validati..ntime.dev.js
failed to diff
dev-validati..ntime.dev.js
failed to diff
dev-validati..ntime.dev.js
failed to diff
pages-api-tu..ntime.dev.js

Diff too large to display

pages-api-tu..time.prod.js

Diff too large to display

pages-api.runtime.dev.js

Diff too large to display

pages-api.ru..time.prod.js

Diff too large to display

pages-turbo...ntime.dev.js

Diff too large to display

pages-turbo...time.prod.js

Diff too large to display

pages.runtime.dev.js

Diff too large to display

pages.runtime.prod.js

Diff too large to display

server.runtime.prod.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

use-cache-pr..ntime.dev.js

Diff too large to display

📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/13ba505b31f97700c6ea8ce16ec1747f0fe99280/next

Commit: 13ba505

@github-actions

github-actions Bot commented Jul 27, 2026

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: 13ba505

@timneutkens
timneutkens marked this pull request as ready for review July 27, 2026 20:12
@timneutkens
timneutkens enabled auto-merge (squash) July 27, 2026 20:13
@timneutkens
timneutkens merged commit c23d1a9 into canary Jul 28, 2026
128 checks passed
@timneutkens
timneutkens deleted the codex/import-meta-env branch July 28, 2026 17:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants