Skip to content

Commit 37f4c79

Browse files
authored
[turbopack] Fix a few references to caching configuration as it is no longer canary guarded (#84761)
1 parent 537f8c7 commit 37f4c79

File tree

2 files changed

+10
-10
lines changed

2 files changed

+10
-10
lines changed

docs/01-app/03-api-reference/05-config/01-next-config-js/turbopackFileSystemCache.mdx

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,16 +2,13 @@
22
title: Turbopack FileSystem Caching
33
nav_title: turbopackFileSystemCache
44
description: Learn how to enable FileSystem Caching for Turbopack builds
5-
version: canary
65
---
76

87
## Usage
98

109
Turbopack FileSystem Cache enables Turbopack to reduce work across `next dev` or `next build` commands. When enabled, Turbopack will save and restore data to the `.next` folder between builds, which can greatly speed up subsequent builds and dev sessions.
1110

12-
> **Warning:** FileSystem Cache is still under development and is not yet stable. Users adopting should expect some stability issues.
13-
14-
> **Good to know**: Note that while `next dev` and `next build` can share cached data with each other, most cache entries are command-specific due to different configuration and environment variables.
11+
> **Good to know:** The FileSystem Cache feature is Beta and is still under development. Users adopting should expect some stability issues. We recommend first adopting it for development.
1512
1613
```ts filename="next.config.ts" switcher
1714
import type { NextConfig } from 'next'
@@ -44,7 +41,7 @@ module.exports = nextConfig
4441

4542
## Version Changes
4643

47-
| Version | Changes |
48-
| --------- | ------------------------------------------- |
49-
| `v16.0.0` | Separate flags for build and dev. |
50-
| `v15.5.0` | Persistent caching released as experimental |
44+
| Version | Changes |
45+
| --------- | -------------------------------------------------------------- |
46+
| `v16.0.0` | Beta release with separate flags for build and dev |
47+
| `v15.5.0` | Persistent caching released as experimental on canary releases |

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

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -152,9 +152,12 @@ We are planning to offer an equivalent to the Inner Graph Optimization in Turbop
152152

153153
### Build Caching
154154

155-
Webpack supports [disk build caching](https://webpack.js.org/configuration/cache/#cache) to speed up builds. We are planning to support an analogous feature in Turbopack but it is not ready yet. On the `next@canary` release you can experiment with our solution by enabling the [`experimental.turbopackFileSystemCacheForDev`/`experimental.turbopackFileSystemCacheForBuild` flags](/docs/app/api-reference/config/next-config-js/turbopackFileSystemCache).
155+
Webpack supports [disk build caching](https://webpack.js.org/configuration/cache/#cache) to improve build performance. Turbopack provides a similar opt-in feature, currently in beta. Starting with Next 16, you can enable Turbopack’s filesystem cache by setting the following experimental flags:
156156

157-
> **Good to know:** For this reason, when comparing webpack and Turbopack performance, make sure to delete the `.next` folder between builds to see a fair comparison.
157+
- [`experimental.turbopackFileSystemCacheForDev`](/docs/app/api-reference/config/next-config-js/turbopackFileSystemCache)
158+
- [`experimental.turbopackFileSystemCacheForBuild`](/docs/app/api-reference/config/next-config-js/turbopackFileSystemCache)
159+
160+
> **Good to know:** For this reason, when comparing webpack and Turbopack performance, make sure to delete the `.next` folder between builds to see a fair comparison or enable the turbopack filesystem cache feature.
158161
159162
### Webpack plugins
160163

0 commit comments

Comments
 (0)