mirror of
https://github.com/hanzoai/next.js.git
synced 2026-09-24 17:00:51 +00:00
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:
co-authored by
Sebastian Sebbie Silbermann
parent
b0d85fb30d
commit
d8aae5e7c0
@@ -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 |
|
||||
|
||||
Reference in New Issue
Block a user