Add a better error message for when turbopack cannot be loaded by lukesandberg · Pull Request #89633 · vercel/next.js

lukesandberg · 2026-02-07T08:12:22Z

Add a more direct error message when next is running on a platform that turbopack doesn't support

document supported turbopack platforms

Testing

To test i just set NEXT_TEST_WASM=1 and ran a build

Error: Turbopack is not supported on this platform (darwin/arm64) because native bindings are not available. Only WebAssembly (WASM) bindings were loaded, and Turbopack requires native bindings.

To use Next.js on this platform, use Webpack instead:
  next dev --webpack

For more information, see: https://nextjs.org/docs/app/api-reference/turbopack#supported-platforms
    at ignore-listed frames

so it should work. Messaging probably could be better (there is also a messge about not being able to set the lockfile) but this should be much better

Fixes #89305

lukesandberg · 2026-02-07T08:12:43Z

Add a better error message for when turbopack cannot be loaded #89633 👈 (View in Graphite)
canary

This stack of pull requests is managed by Graphite. Learn more about stacking.

suggest running with `--webpack` when possible

nextjs-bot · 2026-02-07T08:26:08Z

Tests Passed

codspeed-hq · 2026-02-07T08:35:04Z

Merging this PR will not alter performance

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks¹

_{Comparing better_error_message (5dfbfd5) with canary (09851e2)}

3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

nextjs-bot · 2026-02-07T08:36:54Z

Stats from current PR

✅ No significant changes detected

📊 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)	455ms	455ms	✓	▁▁▁▁▁
Cold (Ready in log)	437ms	438ms	✓	▁▂▁▂▂
Cold (First Request)	1.177s	1.177s	✓	▁▅▁▅▅
Warm (Listen)	456ms	456ms	✓	▁▁▁▁▁
Warm (Ready in log)	442ms	442ms	✓	▁▁▁▁▁
Warm (First Request)	338ms	337ms	✓	▁▁▁▁▁

📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric	Canary	PR	Change	Trend
Cold (Listen)	456ms	457ms	✓	▁▁▁▁▁
Cold (Ready in log)	455ms	455ms	✓	▆▅▃▆▂
Cold (First Request)	1.943s	1.946s	✓	▃▃▃▃▂
Warm (Listen)	456ms	456ms	✓	▁▁▁▁▁
Warm (Ready in log)	457ms	458ms	✓	▄▅▃▄▂
Warm (First Request)	1.960s	1.970s	✓	▃▃▃▃▂

⚡ Production Builds

Metric	Canary	PR	Change	Trend
Fresh Build	3.797s	3.835s	✓	▁▁▁▁▁
Cached Build	3.852s	3.824s	✓	▁▁▁▁▁

📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric	Canary	PR	Change	Trend
Fresh Build	14.492s	14.475s	✓	▁▁▃▁▁
Cached Build	14.564s	14.572s	✓	▁▁▃▁▂
node_modules Size	467 MB	467 MB	✓	▁▁▁▁▁

📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **437 kB** → **437 kB** ⚠️ +8 B

81 files with content-based hashes (individual files not comparable between builds)

Server

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	764 B	762 B	✓
Total	764 B	762 B	✅ -2 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	450 B	448 B	✓
Total	450 B	448 B	✅ -2 B

📦 Webpack

Client

Main Bundles

	Canary	PR	Change
5528-HASH.js gzip	5.47 kB	N/A	-
6280-HASH.js gzip	57 kB	N/A	-
6335.HASH.js gzip	169 B	N/A	-
912-HASH.js gzip	4.53 kB	N/A	-
e8aec2e4-HASH.js gzip	62.5 kB	N/A	-
framework-HASH.js gzip	59.7 kB	59.7 kB	✓
main-app-HASH.js gzip	255 B	253 B	✓
main-HASH.js gzip	39.1 kB	39.1 kB	✓
webpack-HASH.js gzip	1.68 kB	1.68 kB	✓
262-HASH.js gzip	N/A	4.53 kB	-
2889.HASH.js gzip	N/A	169 B	-
5602-HASH.js gzip	N/A	5.49 kB	-
6948ada0-HASH.js gzip	N/A	62.5 kB	-
9544-HASH.js gzip	N/A	57.7 kB	-
Total	230 kB	231 kB	⚠️ +626 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	194 B	✓
_error-HASH.js gzip	183 B	180 B	🟢 3 B (-2%)
css-HASH.js gzip	331 B	330 B	✓
dynamic-HASH.js gzip	1.81 kB	1.81 kB	✓
edge-ssr-HASH.js gzip	256 B	256 B	✓
head-HASH.js gzip	351 B	352 B	✓
hooks-HASH.js gzip	384 B	383 B	✓
image-HASH.js gzip	580 B	581 B	✓
index-HASH.js gzip	260 B	260 B	✓
link-HASH.js gzip	2.49 kB	2.49 kB	✓
routerDirect..HASH.js gzip	320 B	319 B	✓
script-HASH.js gzip	386 B	386 B	✓
withRouter-HASH.js gzip	315 B	315 B	✓
1afbb74e6ecf..834.css gzip	106 B	106 B	✓
Total	7.97 kB	7.97 kB	✅ -1 B

Server

Edge SSR

	Canary	PR	Change
edge-ssr.js gzip	126 kB	126 kB	✓
page.js gzip	249 kB	249 kB	✓
Total	375 kB	376 kB	⚠️ +416 B

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	614 B	614 B	✓
middleware-r..fest.js gzip	156 B	155 B	✓
middleware.js gzip	33.1 kB	33.3 kB	✓
edge-runtime..pack.js gzip	842 B	842 B	✓
Total	34.7 kB	34.9 kB	⚠️ +157 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	733 B	735 B	✓
Total	733 B	735 B	⚠️ +2 B

Build Cache

	Canary	PR	Change
0.pack gzip	3.85 MB	3.85 MB	🔴 +5.96 kB (+0%)
index.pack gzip	102 kB	104 kB	🔴 +1.58 kB (+2%)
index.pack.old gzip	104 kB	103 kB	✓
Total	4.05 MB	4.06 MB	⚠️ +7.07 kB

🔄 Shared (bundler-independent)

Runtimes

	Canary	PR	Change
app-page-exp...dev.js gzip	315 kB	315 kB	✓
app-page-exp..prod.js gzip	167 kB	167 kB	✓
app-page-tur...dev.js gzip	315 kB	315 kB	✓
app-page-tur..prod.js gzip	167 kB	167 kB	✓
app-page-tur...dev.js gzip	312 kB	312 kB	✓
app-page-tur..prod.js gzip	166 kB	166 kB	✓
app-page.run...dev.js gzip	312 kB	312 kB	✓
app-page.run..prod.js gzip	166 kB	166 kB	✓
app-route-ex...dev.js gzip	70.5 kB	70.5 kB	✓
app-route-ex..prod.js gzip	49 kB	49 kB	✓
app-route-tu...dev.js gzip	70.5 kB	70.5 kB	✓
app-route-tu..prod.js gzip	49 kB	49 kB	✓
app-route-tu...dev.js gzip	70.1 kB	70.1 kB	✓
app-route-tu..prod.js gzip	48.8 kB	48.8 kB	✓
app-route.ru...dev.js gzip	70.1 kB	70.1 kB	✓
app-route.ru..prod.js gzip	48.7 kB	48.7 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	43.2 kB	43.2 kB	✓
pages-api-tu..prod.js gzip	32.9 kB	32.9 kB	✓
pages-api.ru...dev.js gzip	43.1 kB	43.1 kB	✓
pages-api.ru..prod.js gzip	32.8 kB	32.8 kB	✓
pages-turbo....dev.js gzip	52.5 kB	52.5 kB	✓
pages-turbo...prod.js gzip	39.4 kB	39.4 kB	✓
pages.runtim...dev.js gzip	52.5 kB	52.5 kB	✓
pages.runtim..prod.js gzip	39.3 kB	39.3 kB	✓
server.runti..prod.js gzip	62.7 kB	62.7 kB	✓
Total	2.8 MB	2.8 MB	✅ -2 B

bgw

How did you test this?

lukesandberg · 2026-02-12T23:24:00Z

Merge activity

Feb 12, 11:24 PM UTC: @lukesandberg merged this pull request with Graphite.

nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. Documentation Related to Next.js' official documentation. Turbopack Related to Turbopack with Next.js. type: next labels Feb 7, 2026

lukesandberg marked this pull request as ready for review February 7, 2026 08:13

Add a better error message for when turbopack cannot be loaded

685172b

suggest running with `--webpack` when possible

lukesandberg force-pushed the better_error_message branch from eee499b to 685172b Compare February 7, 2026 08:14

lukesandberg requested a review from a team February 7, 2026 08:16

ijjk reviewed Feb 7, 2026

View reviewed changes

Comment thread docs/01-app/03-api-reference/08-turbopack.mdx Outdated

drop ia32, it is obsolete

5dfbfd5

bgw approved these changes Feb 9, 2026

View reviewed changes

Comment thread turbopack/crates/turbo-tasks-backend/src/backend/mod.rs Outdated

Update mod.rs

8ea9c4b

lukesandberg merged commit 462b116 into canary Feb 12, 2026
274 of 294 checks passed

lukesandberg deleted the better_error_message branch February 12, 2026 23:24

lukesandberg mentioned this pull request Feb 12, 2026

next.js 15.5.9 works on OpenBSD/adJ 7.8 but next.js 16 does not #89305

Closed

github-actions Bot added the locked label Feb 27, 2026

github-actions Bot locked as resolved and limited conversation to collaborators Feb 27, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add a better error message for when turbopack cannot be loaded#89633

Add a better error message for when turbopack cannot be loaded#89633
lukesandberg merged 3 commits into
canaryfrom
better_error_message

lukesandberg commented Feb 7, 2026 •

edited

Loading

Uh oh!

lukesandberg commented Feb 7, 2026

Uh oh!

nextjs-bot commented Feb 7, 2026 •

edited

Loading

Uh oh!

codspeed-hq Bot commented Feb 7, 2026 •

edited

Loading

Uh oh!

nextjs-bot commented Feb 7, 2026 •

edited

Loading

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

Uh oh!

bgw left a comment

Uh oh!

Uh oh!

Uh oh!

lukesandberg commented Feb 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Conversation

lukesandberg commented Feb 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Testing

Uh oh!

lukesandberg commented Feb 7, 2026

Uh oh!

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

Uh oh!

Tests Passed

Uh oh!

codspeed-hq Bot commented Feb 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Merging this PR will not alter performance

Footnotes

Uh oh!

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

Uh oh!

Stats from current PR

✅ No significant changes detected

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

Uh oh!

bgw left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

lukesandberg commented Feb 12, 2026

Merge activity

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

lukesandberg commented Feb 7, 2026 •

edited

Loading

nextjs-bot commented Feb 7, 2026 •

edited

Loading

codspeed-hq Bot commented Feb 7, 2026 •

edited

Loading

nextjs-bot commented Feb 7, 2026 •

edited

Loading