mirror of
https://github.com/LukeHagar/vercel.git
synced 2025-12-09 12:57:46 +00:00
54aaab83aa
It's been long enough I think we can change these to refer to `@vercel/next` instead. x-ref: [slack thread](https://vercel.slack.com/archives/C03DQ3QFV7C/p1674849801196389)
73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
# `@vercel/next` Legacy Mode
|
|
|
|
#### Why This Warning Occurred
|
|
|
|
`@vercel/next` has two modes: `legacy` and `serverless`. You will always want to use the `serverless` mode. `legacy` is to provide backwards compatibility with previous `@vercel/next` versions.
|
|
|
|
The differences:
|
|
|
|
Legacy:
|
|
|
|
- Minimal lambda size of `2.2Mb` (approximately)
|
|
- Forces `next@v7.0.2-canary.49` and `next-server@v7.0.2-canary.49`
|
|
- Forces all `dependencies` to be `devDependencies`
|
|
- Loads `next.config.js` on bootup, breaking sometimes when users didn't use `phases` to load files
|
|
- Used `next-server` which is the full Next.js server with routing etc.
|
|
- Runs `npm install`
|
|
- Runs `npm run now-build`
|
|
- Runs `npm install --production` after build
|
|
|
|
Serverless:
|
|
|
|
- Minimal lambda size of `49Kb` (approximately)
|
|
- Uses Next.js build targets (`target: 'serverless'`) in `next.config.js`. [documentation](https://github.com/vercel/next.js#summary)
|
|
- Does not make changes to your application dependencies
|
|
- Does not load `next.config.js` ([as per the serverless target documentation](https://github.com/vercel/next.js#summary))
|
|
- Runs `npm install`
|
|
- Runs `npm run now-build`
|
|
- Does not run `npm install --production` as the output from the build is all that's needed to bundle lambdas.
|
|
- No runtime dependencies, meaning smaller lambda functions
|
|
- Optimized for fast cold start
|
|
|
|
#### Possible Ways to Fix It
|
|
|
|
In order to create the smallest possible lambdas Next.js has to be configured to build for the `serverless` target.
|
|
|
|
1. Serverless Next.js requires Next.js 8 or later, to upgrade you can install the `latest` version:
|
|
|
|
```
|
|
npm install next --save
|
|
```
|
|
|
|
2. Add the `now-build` script to your `package.json`
|
|
|
|
```json
|
|
{
|
|
"scripts": {
|
|
"now-build": "next build"
|
|
}
|
|
}
|
|
```
|
|
|
|
3. Add `target: 'serverless'` to `next.config.js`
|
|
|
|
```js
|
|
module.exports = {
|
|
target: 'serverless',
|
|
// Other options are still valid
|
|
};
|
|
```
|
|
|
|
4. Optionally make sure the `"src"` in `"builds"` points to your application `package.json`
|
|
|
|
```js
|
|
{
|
|
"version": 2,
|
|
"builds": [{ "src": "package.json", "use": "@vercel/next" }]
|
|
}
|
|
```
|
|
|
|
### Useful Links
|
|
|
|
- [Serverless target implementation](https://github.com/vercel/now-builders/pull/150)
|