Introduction to Proxy

In Next.js 16, the routing interception layer formerly known as "Middleware" has been renamed to Proxy (proxy.ts or proxy.js).

Proxy allows you to run code before a request is completed. You can modify the response by rewriting, redirecting, modifying the request or response headers, or responding directly.

Usage

Create a proxy.ts file in the root of your project (or inside src/ if you use it).

ts
import { NextResponse } from 'next/server'
import type { NextRequest } from 'next/server'

// This function can be marked `async` if using `await` inside
export function proxy(request: NextRequest) {
  return NextResponse.redirect(new URL('/home', request.url))
}

// See "Matching Paths" below to learn more
export const config = {
  matcher: '/about/:path*',
}

import { NextResponse } from 'next/server'
import type { NextRequest } from 'next/server'
 
export function proxy(request: NextRequest) {
  if (request.nextUrl.pathname.startsWith('/dashboard')) {
    return NextResponse.rewrite(new URL('/dashboard/user', request.url))
  }
}