15.3 Docs: Turbopack for build (#77730)

Closes: https://linear.app/vercel/issue/DOC-4469/turbopack-for-builds

---------

Co-authored-by: Sebastian "Sebbie" Silbermann <[email protected]>
This commit is contained in:
Delba de Oliveira
2025-04-10 11:17:41 +01:00
committed by GitHub
co-authored by Sebastian Sebbie Silbermann
parent b0d85fb30d
commit d8aae5e7c0
+11 -6
View File
@@ -18,19 +18,19 @@ We built Turbopack to push the performance of Next.js, including:
## Getting started
To enable Turbopack in your Next.js project, use the `--turbopack` flag when running the development server:
To enable Turbopack in your Next.js project, add the `--turbopack` flag to the `dev`, `build`, and `start` scripts in your `package.json` file:
```json filename="package.json" highlight={3}
{
"scripts": {
"dev": "next dev --turbopack",
"build": "next build",
"start": "next start"
"build": "next build --turbopack",
"start": "next start --turbopack"
}
}
```
Currently, Turbopack only supports `next dev`. Build (`next build`) is **not yet** supported. We are actively working on production support as Turbopack moves closer to stability.
Currently, Turbopack for `dev` is stable, while `build` is in alpha. We are actively working on production support as Turbopack moves closer to stability.
## Supported features
@@ -95,8 +95,6 @@ Turbopack in Next.js has **zero-configuration** for the common use cases. Below
Some features are not yet implemented or not planned:
- **Production Builds** (`next build`)
Turbopack currently only supports `next dev`. Support for production builds is in active development.
- **Legacy CSS Modules features**
- Standalone `:local` and `:global` pseudo-classes (only the function variant `:global(...)` is supported).
- The `@value` rule (superseded by CSS variables).
@@ -166,3 +164,10 @@ This will produce a `.next/trace-turbopack` file. Include that file when creatin
Turbopack is a **Rust-based**, **incremental** bundler designed to make local development and builds fast—especially for large applications. It is integrated into Next.js, offering zero-config CSS, React, and TypeScript support.
Stay tuned for more updates as we continue to improve Turbopack and add production build support. In the meantime, give it a try with `next dev --turbopack` and let us know your feedback.
## Version Changes
| Version | Changes |
| --------- | -------------------------------- |
| `v15.3.0` | Experimental support for `build` |
| `v15.0.0` | Turbopack for `dev` stable |