61f56f997c
2.4 KiB
Building
You can build Next.js, including all type definitions and packages, with:
pnpm build
Tip
Next.js uses taskr to parallelize the build tasks. The tasks can be found in the
taskfile.jsfile, and each task name refers to the name of the function to execute. For example,taskr releasewill execute therelease()function in thetaskfile.jsfile.
The build process consists of the three main tasks:
- Compile the TypeScript sources with SWC
- Bundle the project with Webpack
- Generate the type definitions
Compile the TypeScript Sources with SWC
By default, the latest canary of the next-swc binaries will be installed and used to compile the TypeScript sources of the project. These sources are meant to be built inside the packages/next/dist/... directory. The outputs will include compiled JavaScript files and source maps.
Bundle the Project with Webpack
Based on the outputs of the compilation, the project is then bundled with Webpack. The configuration can be found in the next-runtime.webpack-config.js file.
Generate the Type Definitions
The type definitions are generated using the TypeScript tsc compiler. You can build them separately with pnpm types. The tsconfig.build.json is used which extends the base tsconfig.json but excludes test files and other unneeded type definitions.
Working on Turbopack, WASM, and other Rust code
If you are actively working on Rust code or you need to test out the most recent Rust code that hasn't been published as a canary yet, you can install Rust and run pnpm swc-build-native.
If you want to test out the wasm build locally, you will need to install wasm-pack. Run pnpm --filter=@next/swc build-wasm --target <wasm_target> to build and node ./scripts/setup-wasm.mjs to copy it into your node_modules. Run next with NODE_OPTIONS='--no-addons' to force it to use the wasm binary.
If you need to clean the project for any reason, use pnpm clean.