This page is also available as Markdown: request this page's URL with an
Accept: text/markdown header. For an index of Next.js documentation, see /docs/llms.txt.Adapters
Last updated August 25, 2026
Use this section to build and validate deployment adapters that integrate with the Next.js build and runtime model.
Configuration
Configure `adapterPath` or `NEXT_ADAPTER_PATH` to use a custom deployment adapter.
Creating an Adapter
Create an adapter module that implements the `NextAdapter` interface.
API Reference
Reference for `modifyConfig` and `onBuildComplete` in the `NextAdapter` interface.
Testing Adapters
Validate adapters with the Next.js compatibility test harness and custom lifecycle scripts.
Routing with @next/routing
Use `@next/routing` to apply Next.js route matching behavior in adapters.
Implementing PPR in an Adapter
Implement Partial Prerendering support in an adapter using fallback output and cache hooks.
Runtime Integration
Understand how build-time adapters and runtime cache interfaces work together.
Invoking Entrypoints
Invoke Node.js and Edge build entrypoints with adapter runtime context.
Output Types
Reference for all build output types exposed to adapters.
Routing Information
Reference for routing phases and route fields exposed in `onBuildComplete`.
Use Cases
Common patterns and examples for deployment adapter implementations.
Supporting Immutable Static Assets
Support immutable static assets in an adapter
Supported Providers
Feature support matrix for each adapter provider based on its most recent ingestion.
Was this helpful?