This page is also available as Markdown at /docs/app/api-reference/adapters.md. For an index of all documentation, see /docs/llms.txt.

Adapters

Last updated April 10, 2026

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

[

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

](/docs/app/api-reference/adapters/configuration)[

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

](/docs/app/api-reference/adapters/creating-an-adapter)[

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

](/docs/app/api-reference/adapters/api-reference)[

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

](/docs/app/api-reference/adapters/testing-adapters)[

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

](/docs/app/api-reference/adapters/routing-with-next-routing)[

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

](/docs/app/api-reference/adapters/implementing-ppr-in-an-adapter)[

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

](/docs/app/api-reference/adapters/runtime-integration)[

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

](/docs/app/api-reference/adapters/invoking-entrypoints)[

Reference for all build output types exposed to adapters.

](/docs/app/api-reference/adapters/output-types)[

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

](/docs/app/api-reference/adapters/routing-information)[

Common patterns and examples for deployment adapter implementations.

](/docs/app/api-reference/adapters/use-cases)

Was this helpful?