Skip to main content

Next.js Vercel Adapter

The official deployment adapter that transforms your Next.js applications for optimal performance on Vercel’s edge network. Automatically configured on deployment, manually configurable for advanced use cases.

Get StartedAPI Reference

Quick start

Get up and running in minutes with automatic or manual configuration

1

Deploy to Vercel (automatic)

The adapter is automatically configured when you deploy a Next.js application to Vercel. No manual installation required.
git push
Your Next.js app will be optimized with the Vercel adapter automatically during the build process.
2

Install locally (for debugging)

For local testing or debugging purposes, install the adapter package:
npm install @next-community/adapter-vercel@latest
3

Configure your Next.js project

Add the adapter to your next.config.ts or next.config.js file:
next.config.ts
import { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    adapterPath: require.resolve('@next-community/adapter-vercel')
  }
}

export default nextConfig
It’s recommended to leave this automatically configured in production to receive automatic updates and fixes from Vercel.
4

Build and deploy

Build your application to see the adapter in action:
npm run build
The adapter will generate optimized outputs in .next/output/ including edge functions, Node.js functions, static files, and routing configurations.

Key features

Everything you need to deploy Next.js applications to Vercel’s edge network

Auto-configured

Automatically optimizes your Next.js app when deploying to Vercel with zero configuration

Edge & Node.js

Deploy functions to Edge Runtime for low latency or Node.js for maximum compatibility

Advanced routing

Sophisticated routing with rewrites, redirects, headers, and middleware support

ISR & SSG

Full support for static generation and incremental static regeneration

App Router ready

Optimized for Next.js App Router with RSC and Server Actions support

Internationalization

Built-in i18n routing with locale detection and domain mapping

Explore by topic

Deep dive into core concepts and features

How it works

Understand the adapter’s build process, output generation, and deployment workflow

Learn more

Middleware

Deploy middleware to the edge for request interception, authentication, and redirects

Learn more

Configuration

Fine-tune adapter behavior with Vercel config options for routing, images, and more

Learn more

API reference

Complete API documentation for adapter interfaces, types, and public functions

Learn more

Ready to deploy?

Start building with the Next.js Vercel Adapter and take advantage of automatic optimizations, edge deployment, and powerful routing features.

Get started

Build docs developers (and LLMs) love

Get started for freeTalk to us