Adapters

Last updated April 23, 2026

Use this section to build and validate deployment adapters that integrate with the Next.js build and runtime model.

• Configuration
• Creating an Adapter
• API Reference
• Testing Adapters
• Routing with @next/routing
• Implementing PPR in an Adapter
• Runtime Integration
• Invoking Entrypoints
• Output Types
• Routing Information
• Use Cases

[

Configuration

Configure `adapterPath` or `NEXT_ADAPTER_PATH` to use a custom deployment adapter.

](configuration/index.md)[

Creating an Adapter

Create an adapter module that implements the `NextAdapter` interface.

](creating-an-adapter/index.md)[

API Reference

Reference for `modifyConfig` and `onBuildComplete` in the `NextAdapter` interface.

](api-reference/index.md)[

Testing Adapters

Validate adapters with the Next.js compatibility test harness and custom lifecycle scripts.

](testing-adapters/index.md)[

Routing with @next/routing

Use `@next/routing` to apply Next.js route matching behavior in adapters.

](routing-with-next-routing/index.md)[

Implementing PPR in an Adapter

Implement Partial Prerendering support in an adapter using fallback output and cache hooks.

](implementing-ppr-in-an-adapter/index.md)[

Runtime Integration

Understand how build-time adapters and runtime cache interfaces work together.

](runtime-integration/index.md)[

Invoking Entrypoints

Invoke Node.js and Edge build entrypoints with adapter runtime context.

](invoking-entrypoints/index.md)[

Output Types

Reference for all build output types exposed to adapters.

](output-types/index.md)[

Routing Information

Reference for routing phases and route fields exposed in `onBuildComplete`.

](routing-information/index.md)[

Use Cases

Common patterns and examples for deployment adapter implementations.

](use-cases/index.md)

Was this helpful?