vercel/errors/now-next-legacy-mode.md

@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
• Does not make changes to your application dependencies
• Does not load next.config.js (as per the serverless target documentation)
• 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

{
  "scripts": {
    "now-build": "next build"
  }
}

3. Add target: 'serverless' to next.config.js

module.exports = {
  target: 'serverless',
  // Other options are still valid
};

4. Optionally make sure the "src" in "builds" points to your application package.json

{
  "version": 2,
  "builds": [{ "src": "package.json", "use": "@vercel/next" }]
}

Useful Links

• Serverless target implementation