Unverified Commit d8aae5e7 authored by Delba de Oliveira's avatar Delba de Oliveira Committed by GitHub

15.3 Docs: Turbopack for `build` (#77730)

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

---------
Co-authored-by: 's avatarSebastian "Sebbie" Silbermann <sebastian.silbermann@vercel.com>
parent b0d85fb3
......@@ -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 |
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment