---
docs_index: /docs/llms.txt
---

# Next.js Documentation Sitemap

## Purpose

This file is a high-level semantic index of the documentation.
It is intended for:

- LLM-assisted navigation (ChatGPT, Claude Code)
- Quick orientation for contributors
- Identifying relevant documentation areas during development

It is not intended to replace individual docs.

---

## App Router

- [Getting Started](/docs/app/getting-started) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to create full-stack web applications with the Next.js App Router. | Topics: app-router, getting-started

    - [Installation](/docs/app/getting-started/installation) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to create a new Next.js application with the `create-next-app` CLI, and set up TypeScript, ESLint, and Module Path Aliases. | Prerequisites: Getting Started | Topics: app-router, getting-started, installation

    - [Project Structure](/docs/app/getting-started/project-structure) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn the folder and file conventions in Next.js, and how to organize your project. | Prerequisites: Getting Started | Topics: app-router, getting-started, project-structure

    - [Layouts and Pages](/docs/app/getting-started/layouts-and-pages) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to create your first pages and layouts, and link between them with the Link component. | Prerequisites: Getting Started | Topics: app-router, getting-started, layouts-and-pages

    - [Linking and Navigating](/docs/app/getting-started/linking-and-navigating) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how the built-in navigation optimizations work, including prefetching, prerendering, and client-side navigation, and how to optimize navigation for dynamic routes and slow networks. | Prerequisites: Getting Started | Topics: app-router, getting-started, linking-and-navigating

    - [Server and Client Components](/docs/app/getting-started/server-and-client-components) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how you can use React Server and Client Components to render parts of your application on the server or the client. | Prerequisites: Getting Started | Topics: app-router, getting-started, server-and-client-components

    - [Fetching Data](/docs/app/getting-started/fetching-data) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to fetch data and stream content that depends on data. | Prerequisites: Getting Started | Topics: app-router, getting-started, fetching-data

    - [Mutating Data](/docs/app/getting-started/mutating-data) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to mutate data using Server Functions and Server Actions in Next.js. | Prerequisites: Getting Started | Topics: app-router, getting-started, mutating-data

    - [Caching](/docs/app/getting-started/caching) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to cache data and UI in Next.js | Prerequisites: Getting Started | Topics: app-router, getting-started, caching

    - [Revalidating](/docs/app/getting-started/revalidating) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to revalidate cached data using time-based and on-demand strategies. | Prerequisites: Getting Started | Topics: app-router, getting-started, revalidating

    - [Error Handling](/docs/app/getting-started/error-handling) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to display expected errors and handle uncaught exceptions. | Prerequisites: Getting Started | Topics: app-router, getting-started, error-handling

    - [CSS](/docs/app/getting-started/css) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn about the different ways to add CSS to your application, including Tailwind CSS, CSS Modules, Global CSS, and more. | Prerequisites: Getting Started | Topics: app-router, getting-started, css

    - [Image Optimization](/docs/app/getting-started/images) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to optimize images in Next.js | Prerequisites: Getting Started | Topics: app-router, getting-started, images

    - [Font Optimization](/docs/app/getting-started/fonts) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to optimize fonts in Next.js | Prerequisites: Getting Started | Topics: app-router, getting-started, fonts

    - [Metadata and OG images](/docs/app/getting-started/metadata-and-og-images) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to add metadata to your pages and create dynamic OG images. | Prerequisites: Getting Started | Topics: app-router, getting-started, metadata-and-og-images

    - [Route Handlers](/docs/app/getting-started/route-handlers) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to use Route Handlers | Prerequisites: Getting Started | Topics: app-router, getting-started, route-handlers

    - [Proxy](/docs/app/getting-started/proxy) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to use Proxy | Prerequisites: Getting Started | Topics: app-router, getting-started, proxy

    - [Deploying](/docs/app/getting-started/deploying) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to deploy your Next.js application. | Prerequisites: Getting Started | Topics: app-router, getting-started, deploying

    - [Upgrading](/docs/app/getting-started/upgrading) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to upgrade your Next.js application to the latest version or canary. | Prerequisites: Getting Started | Topics: app-router, getting-started, upgrading

- [Guides](/docs/app/guides) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to implement common patterns and real-world use cases using Next.js | Topics: app-router, guides

    - [AI Coding Agents](/docs/app/guides/ai-agents) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to configure your Next.js project so AI coding agents use up-to-date documentation instead of outdated training data. | Prerequisites: Guides | Topics: app-router, guides, ai-agents

    - [Analytics](/docs/app/guides/analytics) | Type: How-to | Lastmod: 2026-05-13 | Summary: Measure and track page performance using Next.js Speed Insights | Prerequisites: Guides | Topics: app-router, guides, analytics

    - [Authentication](/docs/app/guides/authentication) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to implement authentication in your Next.js application. | Prerequisites: Guides | Topics: app-router, guides, authentication

    - [Backend for Frontend](/docs/app/guides/backend-for-frontend) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to use Next.js as a backend framework | Prerequisites: Guides | Topics: app-router, guides, backend-for-frontend

    - [Caching (Previous Model)](/docs/app/guides/caching-without-cache-components) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to cache and revalidate data using fetch options, unstable_cache, and route segment configs for projects not using Cache Components. | Prerequisites: Guides | Topics: app-router, guides, caching-without-cache-components

    - [CDN Caching](/docs/app/guides/cdn-caching) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how CDN caching works with Next.js, including what works today, cache variability, and the direction toward pathname-based cache keying. | Prerequisites: Guides | Topics: app-router, guides, cdn-caching

    - [CI Build Caching](/docs/app/guides/ci-build-caching) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to configure CI to cache Next.js builds | Prerequisites: Guides | Topics: app-router, guides, ci-build-caching

    - [Content Security Policy](/docs/app/guides/content-security-policy) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set a Content Security Policy (CSP) for your Next.js application. | Prerequisites: Guides | Topics: app-router, guides, content-security-policy

    - [CSS-in-JS](/docs/app/guides/css-in-js) | Type: How-to | Lastmod: 2026-05-13 | Summary: Use CSS-in-JS libraries with Next.js | Prerequisites: Guides | Topics: app-router, guides, css-in-js

    - [Custom Server](/docs/app/guides/custom-server) | Type: How-to | Lastmod: 2026-05-13 | Summary: Start a Next.js app programmatically using a custom server. | Prerequisites: Guides | Topics: app-router, guides, custom-server

    - [Data Security](/docs/app/guides/data-security) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn the built-in data security features in Next.js and learn best practices for protecting your application's data. | Prerequisites: Guides | Topics: app-router, guides, data-security

    - [Debugging](/docs/app/guides/debugging) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to debug your Next.js application with VS Code, Chrome DevTools, or Firefox DevTools. | Prerequisites: Guides | Topics: app-router, guides, debugging

    - [Deploying to Platforms](/docs/app/guides/deploying-to-platforms) | Type: How-to | Lastmod: 2026-05-13 | Summary: Understand which Next.js features require specific platform capabilities and how to choose the right deployment target. | Prerequisites: Guides | Topics: app-router, guides, deploying-to-platforms

    - [Draft Mode](/docs/app/guides/draft-mode) | Type: How-to | Lastmod: 2026-05-13 | Summary: Next.js has draft mode to toggle between static and dynamic pages. You can learn how it works with App Router here. | Prerequisites: Guides | Topics: app-router, guides, draft-mode

    - [Environment Variables](/docs/app/guides/environment-variables) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn to add and access environment variables in your Next.js application. | Prerequisites: Guides | Topics: app-router, guides, environment-variables

    - [Forms](/docs/app/guides/forms) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to create forms in Next.js with React Server Actions. | Prerequisites: Guides | Topics: app-router, guides, forms

    - [How Revalidation Works](/docs/app/guides/how-revalidation-works) | Type: How-to | Lastmod: 2026-05-13 | Summary: A deep dive into how Next.js revalidates cached content, including the tag system, cache consistency, and multi-instance coordination. | Prerequisites: Guides | Topics: app-router, guides, how-revalidation-works

    - [ISR](/docs/app/guides/incremental-static-regeneration) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to create or update static pages at runtime with Incremental Static Regeneration. | Prerequisites: Guides | Topics: app-router, guides, incremental-static-regeneration

    - [Instrumentation](/docs/app/guides/instrumentation) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to use instrumentation to run code at server startup in your Next.js app | Prerequisites: Guides | Topics: app-router, guides, instrumentation

    - [Internationalization](/docs/app/guides/internationalization) | Type: How-to | Lastmod: 2026-05-13 | Summary: Add support for multiple languages with internationalized routing and localized content. | Prerequisites: Guides | Topics: app-router, guides, internationalization

    - [JSON-LD](/docs/app/guides/json-ld) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to add JSON-LD to your Next.js application to describe your content to search engines and AI. | Prerequisites: Guides | Topics: app-router, guides, json-ld

    - [Lazy Loading](/docs/app/guides/lazy-loading) | Type: How-to | Lastmod: 2026-05-13 | Summary: Lazy load imported libraries and React Components to improve your application's loading performance. | Prerequisites: Guides | Topics: app-router, guides, lazy-loading

    - [Development Environment](/docs/app/guides/local-development) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to optimize your local development environment with Next.js. | Prerequisites: Guides | Topics: app-router, guides, local-development

    - [Next.js MCP Server](/docs/app/guides/mcp) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to use Next.js MCP support to allow coding agents access to your application state | Prerequisites: Guides | Topics: app-router, guides, mcp

    - [MDX](/docs/app/guides/mdx) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to configure MDX and use it in your Next.js apps. | Prerequisites: Guides | Topics: app-router, guides, mdx

    - [Memory Usage](/docs/app/guides/memory-usage) | Type: How-to | Lastmod: 2026-05-13 | Summary: Optimize memory used by your application in development and production. | Prerequisites: Guides | Topics: app-router, guides, memory-usage

    - [Migrating](/docs/app/guides/migrating) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to migrate from popular frameworks to Next.js | Prerequisites: Guides | Topics: app-router, guides, migrating

        - [App Router](/docs/app/guides/migrating/app-router-migration) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to upgrade your existing Next.js application from the Pages Router to the App Router. | Prerequisites: Migrating | Topics: app-router, guides, migrating

        - [Create React App](/docs/app/guides/migrating/from-create-react-app) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to migrate your existing React application from Create React App to Next.js. | Prerequisites: Migrating | Topics: app-router, guides, migrating

        - [Vite](/docs/app/guides/migrating/from-vite) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to migrate your existing React application from Vite to Next.js. | Prerequisites: Migrating | Topics: app-router, guides, migrating

    - [Migrating to Cache Components](/docs/app/guides/migrating-to-cache-components) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to migrate from route segment configs to Cache Components in Next.js. | Prerequisites: Guides | Topics: app-router, guides, migrating-to-cache-components

    - [Multi-tenant](/docs/app/guides/multi-tenant) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to build multi-tenant apps with the App Router. | Prerequisites: Guides | Topics: app-router, guides, multi-tenant

    - [Multi-zones](/docs/app/guides/multi-zones) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to build micro-frontends using Next.js Multi-Zones to deploy multiple Next.js apps under a single domain. | Prerequisites: Guides | Topics: app-router, guides, multi-zones

    - [OpenTelemetry](/docs/app/guides/open-telemetry) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to instrument your Next.js app with OpenTelemetry. | Prerequisites: Guides | Topics: app-router, guides, open-telemetry

    - [Package Bundling](/docs/app/guides/package-bundling) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to analyze and optimize your application's server and client bundles with the Next.js Bundle Analyzer for Turbopack, and the `@next/bundle-analyzer` plugin for Webpack. | Prerequisites: Guides | Topics: app-router, guides, package-bundling

    - [PPR Platform Guide](/docs/app/guides/ppr-platform-guide) | Type: How-to | Lastmod: 2026-05-13 | Summary: A guide for platform engineers on implementing PPR support, from basic origin rendering to optimized CDN integration. | Prerequisites: Guides | Topics: app-router, guides, ppr-platform-guide

    - [Prefetching](/docs/app/guides/prefetching) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to configure prefetching in Next.js | Prerequisites: Guides | Topics: app-router, guides, prefetching

    - [Preserving UI state](/docs/app/guides/preserving-ui-state) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how React's Activity component preserves UI state across navigations in Next.js and how to control what resets. | Prerequisites: Guides | Topics: app-router, guides, preserving-ui-state

    - [Preventing Flash](/docs/app/guides/preventing-flash-before-hydration) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to correct server-rendered content before the browser paints, avoiding visible flash when the page hydrates. | Prerequisites: Guides | Topics: app-router, guides, preventing-flash-before-hydration

    - [Production](/docs/app/guides/production-checklist) | Type: How-to | Lastmod: 2026-05-13 | Summary: Recommendations to ensure the best performance and user experience before taking your Next.js application to production. | Prerequisites: Guides | Topics: app-router, guides, production-checklist

    - [PWAs](/docs/app/guides/progressive-web-apps) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to build a Progressive Web Application (PWA) with Next.js. | Prerequisites: Guides | Topics: app-router, guides, progressive-web-apps

    - [Public pages](/docs/app/guides/public-static-pages) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to build public, "static" pages that share data across users, such as landing pages, list pages (products, blogs, etc.), marketing and news sites. | Prerequisites: Guides | Topics: app-router, guides, public-static-pages

    - [Redirecting](/docs/app/guides/redirecting) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn the different ways to handle redirects in Next.js. | Prerequisites: Guides | Topics: app-router, guides, redirecting

    - [Rendering Philosophy](/docs/app/guides/rendering-philosophy) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how Next.js treats static and dynamic rendering as a spectrum at the component level, and what this means for deployment. | Prerequisites: Guides | Topics: app-router, guides, rendering-philosophy

    - [Sass](/docs/app/guides/sass) | Type: How-to | Lastmod: 2026-05-13 | Summary: Style your Next.js application using Sass. | Prerequisites: Guides | Topics: app-router, guides, sass

    - [Scripts](/docs/app/guides/scripts) | Type: How-to | Lastmod: 2026-05-13 | Summary: Optimize 3rd party scripts with the built-in Script component. | Prerequisites: Guides | Topics: app-router, guides, scripts

    - [Self-Hosting](/docs/app/guides/self-hosting) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to self-host your Next.js application on a Node.js server, Docker image, or static HTML files (static exports). | Prerequisites: Guides | Topics: app-router, guides, self-hosting

    - [SPAs](/docs/app/guides/single-page-applications) | Type: How-to | Lastmod: 2026-05-13 | Summary: Next.js fully supports building Single-Page Applications (SPAs). | Prerequisites: Guides | Topics: app-router, guides, single-page-applications

    - [Static Exports](/docs/app/guides/static-exports) | Type: How-to | Lastmod: 2026-05-13 | Summary: Next.js enables starting as a static site or Single-Page Application (SPA), then later optionally upgrading to use features that require a server. | Prerequisites: Guides | Topics: app-router, guides, static-exports

    - [Streaming](/docs/app/guides/streaming) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how streaming works in Next.js and how to use it to progressively render UI as data becomes available. | Prerequisites: Guides | Topics: app-router, guides, streaming

    - [Tailwind CSS v3](/docs/app/guides/tailwind-v3-css) | Type: How-to | Lastmod: 2026-05-13 | Summary: Style your Next.js Application using Tailwind CSS v3 for broader browser support. | Prerequisites: Guides | Topics: app-router, guides, tailwind-v3-css

    - [Testing](/docs/app/guides/testing) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Next.js with four commonly used testing tools — Cypress, Playwright, Vitest, and Jest. | Prerequisites: Guides | Topics: app-router, guides, testing

        - [Cypress](/docs/app/guides/testing/cypress) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Cypress with Next.js for End-to-End (E2E) and Component Testing. | Prerequisites: Testing | Topics: app-router, guides, testing

        - [Jest](/docs/app/guides/testing/jest) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Jest with Next.js for Unit Testing and Snapshot Testing. | Prerequisites: Testing | Topics: app-router, guides, testing

        - [Playwright](/docs/app/guides/testing/playwright) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Playwright with Next.js for End-to-End (E2E) Testing. | Prerequisites: Testing | Topics: app-router, guides, testing

        - [Vitest](/docs/app/guides/testing/vitest) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Vitest with Next.js for Unit Testing. | Prerequisites: Testing | Topics: app-router, guides, testing

    - [Third Party Libraries](/docs/app/guides/third-party-libraries) | Type: How-to | Lastmod: 2026-05-13 | Summary: Optimize the performance of third-party libraries in your application with the `@next/third-parties` package. | Prerequisites: Guides | Topics: app-router, guides, third-party-libraries

    - [Upgrading](/docs/app/guides/upgrading) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to upgrade to the latest versions of Next.js. | Prerequisites: Guides | Topics: app-router, guides, upgrading

        - [Codemods](/docs/app/guides/upgrading/codemods) | Type: How-to | Lastmod: 2026-05-13 | Summary: Use codemods to upgrade your Next.js codebase when new features are released. | Prerequisites: Upgrading | Topics: app-router, guides, upgrading

        - [Version 14](/docs/app/guides/upgrading/version-14) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 13 to 14. | Prerequisites: Upgrading | Topics: app-router, guides, upgrading

        - [Version 15](/docs/app/guides/upgrading/version-15) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 14 to 15. | Prerequisites: Upgrading | Topics: app-router, guides, upgrading

        - [Version 16](/docs/app/guides/upgrading/version-16) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 15 to 16. | Prerequisites: Upgrading | Topics: app-router, guides, upgrading

    - [Videos](/docs/app/guides/videos) | Type: How-to | Lastmod: 2026-05-13 | Summary: Recommendations and best practices for optimizing videos in your Next.js application. | Prerequisites: Guides | Topics: app-router, guides, videos

    - [View transitions](/docs/app/guides/view-transitions) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to use view transitions to communicate meaning during navigation, loading, and content changes in a Next.js app. | Prerequisites: Guides | Topics: app-router, guides, view-transitions

- [API Reference](/docs/app/api-reference) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js API Reference for the App Router. | Topics: app-router, api-reference

    - [Directives](/docs/app/api-reference/directives) | Type: Reference | Lastmod: 2026-05-13 | Summary: Directives are used to modify the behavior of your Next.js application. | Prerequisites: API Reference | Topics: app-router, api-reference, directives

        - [use cache](/docs/app/api-reference/directives/use-cache) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the "use cache" directive to cache data in your Next.js application. | Prerequisites: Directives | Topics: app-router, api-reference, directives

        - [use cache: private](/docs/app/api-reference/directives/use-cache-private) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the "use cache: private" directive to cache functions that access runtime request APIs. | Prerequisites: Directives | Topics: app-router, api-reference, directives

        - [use cache: remote](/docs/app/api-reference/directives/use-cache-remote) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the "use cache: remote" directive for persistent, shared caching using remote cache handlers. | Prerequisites: Directives | Topics: app-router, api-reference, directives

        - [use client](/docs/app/api-reference/directives/use-client) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the use client directive to render a component on the client. | Prerequisites: Directives | Topics: app-router, api-reference, directives

        - [use server](/docs/app/api-reference/directives/use-server) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the use server directive to execute code on the server. | Prerequisites: Directives | Topics: app-router, api-reference, directives

    - [Components](/docs/app/api-reference/components) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for Next.js built-in components. | Prerequisites: API Reference | Topics: app-router, api-reference, components

        - [Font](/docs/app/api-reference/components/font) | Type: Reference | Lastmod: 2026-05-13 | Summary: Optimizing loading web fonts with the built-in `next/font` loaders. | Prerequisites: Components | Topics: app-router, api-reference, components

        - [Form Component](/docs/app/api-reference/components/form) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the `<Form>` component to handle form submissions and search params updates with client-side navigation. | Prerequisites: Components | Topics: app-router, api-reference, components

        - [Image Component](/docs/app/api-reference/components/image) | Type: Reference | Lastmod: 2026-05-13 | Summary: Optimize Images in your Next.js Application using the built-in `next/image` Component. | Prerequisites: Components | Topics: app-router, api-reference, components

        - [Link Component](/docs/app/api-reference/components/link) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable fast client-side navigation with the built-in `next/link` component. | Prerequisites: Components | Topics: app-router, api-reference, components

        - [Script Component](/docs/app/api-reference/components/script) | Type: Reference | Lastmod: 2026-05-13 | Summary: Optimize third-party scripts in your Next.js application using the built-in `next/script` Component. | Prerequisites: Components | Topics: app-router, api-reference, components

    - [File-system conventions](/docs/app/api-reference/file-conventions) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for Next.js file-system conventions. | Prerequisites: API Reference | Topics: app-router, api-reference, file-conventions

        - [default.js](/docs/app/api-reference/file-conventions/default) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the default.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [Dynamic Segments](/docs/app/api-reference/file-conventions/dynamic-routes) | Type: Reference | Lastmod: 2026-05-13 | Summary: Dynamic Route Segments can be used to programmatically generate route segments from dynamic data. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [error.js](/docs/app/api-reference/file-conventions/error) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the error.js special file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [forbidden.js](/docs/app/api-reference/file-conventions/forbidden) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the forbidden.js special file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [instrumentation.js](/docs/app/api-reference/file-conventions/instrumentation) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the instrumentation.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [instrumentation-client.js](/docs/app/api-reference/file-conventions/instrumentation-client) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to add client-side instrumentation to track and monitor your Next.js application's frontend performance. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [Intercepting Routes](/docs/app/api-reference/file-conventions/intercepting-routes) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use intercepting routes to load a new route within the current layout while masking the browser URL, useful for advanced routing patterns such as modals. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [layout.js](/docs/app/api-reference/file-conventions/layout) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the layout.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [loading.js](/docs/app/api-reference/file-conventions/loading) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the loading.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [mdx-components.js](/docs/app/api-reference/file-conventions/mdx-components) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the mdx-components.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [not-found.js](/docs/app/api-reference/file-conventions/not-found) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the not-found.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [page.js](/docs/app/api-reference/file-conventions/page) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the page.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [Parallel Routes](/docs/app/api-reference/file-conventions/parallel-routes) | Type: Reference | Lastmod: 2026-05-13 | Summary: Simultaneously render one or more pages in the same view that can be navigated independently. A pattern for highly dynamic applications. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [proxy.js](/docs/app/api-reference/file-conventions/proxy) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the proxy.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [public](/docs/app/api-reference/file-conventions/public-folder) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js allows you to serve static files, like images, in the public directory. You can learn how it works here. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [route.js](/docs/app/api-reference/file-conventions/route) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the route.js special file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

            - [dynamicParams](/docs/app/api-reference/file-conventions/route-segment-config/dynamicParams) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the dynamicParams route segment config option. | Prerequisites: route.js | Topics: app-router, api-reference, file-conventions

            - [maxDuration](/docs/app/api-reference/file-conventions/route-segment-config/maxDuration) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the maxDuration route segment config option. | Prerequisites: route.js | Topics: app-router, api-reference, file-conventions

            - [preferredRegion](/docs/app/api-reference/file-conventions/route-segment-config/preferredRegion) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the preferredRegion route segment config option. | Prerequisites: route.js | Topics: app-router, api-reference, file-conventions

            - [runtime](/docs/app/api-reference/file-conventions/route-segment-config/runtime) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the runtime route segment config option. | Prerequisites: route.js | Topics: app-router, api-reference, file-conventions

        - [Route Groups](/docs/app/api-reference/file-conventions/route-groups) | Type: Reference | Lastmod: 2026-05-13 | Summary: Route Groups can be used to partition your Next.js application into different sections. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [src](/docs/app/api-reference/file-conventions/src-folder) | Type: Reference | Lastmod: 2026-05-13 | Summary: Save pages under the `src` folder as an alternative to the root `pages` directory. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [template.js](/docs/app/api-reference/file-conventions/template) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the template.js file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [unauthorized.js](/docs/app/api-reference/file-conventions/unauthorized) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the unauthorized.js special file. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

        - [Metadata Files](/docs/app/api-reference/file-conventions/metadata) | Type: Reference | Lastmod: 2026-05-13 | Summary: API documentation for the metadata file conventions. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

            - [favicon, icon, and apple-icon](/docs/app/api-reference/file-conventions/metadata/app-icons) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the Favicon, Icon and Apple Icon file conventions. | Prerequisites: Metadata Files | Topics: app-router, api-reference, file-conventions

            - [manifest.json](/docs/app/api-reference/file-conventions/metadata/manifest) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for manifest.json file. | Prerequisites: Metadata Files | Topics: app-router, api-reference, file-conventions

            - [opengraph-image and twitter-image](/docs/app/api-reference/file-conventions/metadata/opengraph-image) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the Open Graph Image and Twitter Image file conventions. | Prerequisites: Metadata Files | Topics: app-router, api-reference, file-conventions

            - [robots.txt](/docs/app/api-reference/file-conventions/metadata/robots) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for robots.txt file. | Prerequisites: Metadata Files | Topics: app-router, api-reference, file-conventions

            - [sitemap.xml](/docs/app/api-reference/file-conventions/metadata/sitemap) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the sitemap.xml file. | Prerequisites: Metadata Files | Topics: app-router, api-reference, file-conventions

        - [Route Segment Config](/docs/app/api-reference/file-conventions/route-segment-config) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn about how to configure options for Next.js route segments. | Prerequisites: File-system conventions | Topics: app-router, api-reference, file-conventions

            - [dynamicParams](/docs/app/api-reference/file-conventions/route-segment-config/dynamicParams) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the dynamicParams route segment config option. | Prerequisites: Route Segment Config | Topics: app-router, api-reference, file-conventions

            - [maxDuration](/docs/app/api-reference/file-conventions/route-segment-config/maxDuration) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the maxDuration route segment config option. | Prerequisites: Route Segment Config | Topics: app-router, api-reference, file-conventions

            - [preferredRegion](/docs/app/api-reference/file-conventions/route-segment-config/preferredRegion) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the preferredRegion route segment config option. | Prerequisites: Route Segment Config | Topics: app-router, api-reference, file-conventions

            - [runtime](/docs/app/api-reference/file-conventions/route-segment-config/runtime) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the runtime route segment config option. | Prerequisites: Route Segment Config | Topics: app-router, api-reference, file-conventions

    - [Functions](/docs/app/api-reference/functions) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for Next.js Functions and Hooks. | Prerequisites: API Reference | Topics: app-router, api-reference, functions

        - [after](/docs/app/api-reference/functions/after) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the after function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [cacheLife](/docs/app/api-reference/functions/cacheLife) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the cacheLife function to set the cache expiration time for a cached function or component. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [cacheTag](/docs/app/api-reference/functions/cacheTag) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the cacheTag function to manage cache invalidation in your Next.js application. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [unstable_catchError](/docs/app/api-reference/functions/catchError) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the unstable_catchError function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [connection](/docs/app/api-reference/functions/connection) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the connection function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [cookies](/docs/app/api-reference/functions/cookies) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the cookies function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [draftMode](/docs/app/api-reference/functions/draft-mode) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the draftMode function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [fetch](/docs/app/api-reference/functions/fetch) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the extended fetch function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [forbidden](/docs/app/api-reference/functions/forbidden) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the forbidden function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [generateImageMetadata](/docs/app/api-reference/functions/generate-image-metadata) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to generate multiple images in a single Metadata API special file. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [generateMetadata](/docs/app/api-reference/functions/generate-metadata) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to add Metadata to your Next.js application for improved search engine optimization (SEO) and web shareability. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [generateSitemaps](/docs/app/api-reference/functions/generate-sitemaps) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the generateSiteMaps function to create multiple sitemaps for your application. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [generateStaticParams](/docs/app/api-reference/functions/generate-static-params) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the generateStaticParams function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [generateViewport](/docs/app/api-reference/functions/generate-viewport) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the generateViewport function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [headers](/docs/app/api-reference/functions/headers) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the headers function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [ImageResponse](/docs/app/api-reference/functions/image-response) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the ImageResponse constructor. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [NextRequest](/docs/app/api-reference/functions/next-request) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for NextRequest. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [NextResponse](/docs/app/api-reference/functions/next-response) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for NextResponse. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [notFound](/docs/app/api-reference/functions/not-found) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the notFound function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [permanentRedirect](/docs/app/api-reference/functions/permanentRedirect) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the permanentRedirect function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [redirect](/docs/app/api-reference/functions/redirect) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the redirect function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [refresh](/docs/app/api-reference/functions/refresh) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the refresh function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [revalidatePath](/docs/app/api-reference/functions/revalidatePath) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the revalidatePath function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [revalidateTag](/docs/app/api-reference/functions/revalidateTag) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the revalidateTag function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [unauthorized](/docs/app/api-reference/functions/unauthorized) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the unauthorized function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [unstable_cache](/docs/app/api-reference/functions/unstable_cache) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the unstable_cache function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [unstable_noStore](/docs/app/api-reference/functions/unstable_noStore) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the unstable_noStore function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [unstable_rethrow](/docs/app/api-reference/functions/unstable_rethrow) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the unstable_rethrow function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [updateTag](/docs/app/api-reference/functions/updateTag) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the updateTag function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [useLinkStatus](/docs/app/api-reference/functions/use-link-status) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useLinkStatus hook. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [useParams](/docs/app/api-reference/functions/use-params) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useParams hook. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [usePathname](/docs/app/api-reference/functions/use-pathname) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the usePathname hook. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [useReportWebVitals](/docs/app/api-reference/functions/use-report-web-vitals) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useReportWebVitals function. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [useRouter](/docs/app/api-reference/functions/use-router) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the useRouter hook. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [useSearchParams](/docs/app/api-reference/functions/use-search-params) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useSearchParams hook. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [useSelectedLayoutSegment](/docs/app/api-reference/functions/use-selected-layout-segment) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useSelectedLayoutSegment hook. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [useSelectedLayoutSegments](/docs/app/api-reference/functions/use-selected-layout-segments) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useSelectedLayoutSegments hook. | Prerequisites: Functions | Topics: app-router, api-reference, functions

        - [userAgent](/docs/app/api-reference/functions/userAgent) | Type: Reference | Lastmod: 2026-05-13 | Summary: The userAgent helper extends the Web Request API with additional properties and methods to interact with the user agent object from the request. | Prerequisites: Functions | Topics: app-router, api-reference, functions

    - [Configuration](/docs/app/api-reference/config) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to configure Next.js applications. | Prerequisites: API Reference | Topics: app-router, api-reference, config

        - [next.config.js](/docs/app/api-reference/config/next-config-js) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to configure your application with next.config.js. | Prerequisites: Configuration | Topics: app-router, api-reference, config

            - [adapterPath](/docs/app/api-reference/config/next-config-js/adapterPath) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure a custom adapter for Next.js to hook into the build process. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [allowedDevOrigins](/docs/app/api-reference/config/next-config-js/allowedDevOrigins) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use `allowedDevOrigins` to configure additional origins that can request the dev server. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [appDir](/docs/app/api-reference/config/next-config-js/appDir) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable the App Router to use layouts, streaming, and more. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [assetPrefix](/docs/app/api-reference/config/next-config-js/assetPrefix) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the assetPrefix config option to configure your CDN. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [authInterrupts](/docs/app/api-reference/config/next-config-js/authInterrupts) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to enable the experimental `authInterrupts` configuration option to use `forbidden` and `unauthorized`. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [basePath](/docs/app/api-reference/config/next-config-js/basePath) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use `basePath` to deploy a Next.js application under a sub-path of a domain. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [cacheComponents](/docs/app/api-reference/config/next-config-js/cacheComponents) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to enable the cacheComponents flag in Next.js. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [cacheHandlers](/docs/app/api-reference/config/next-config-js/cacheHandlers) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure custom cache handlers for use cache directives in Next.js. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [cacheLife](/docs/app/api-reference/config/next-config-js/cacheLife) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to set up cacheLife configurations in Next.js. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [compress](/docs/app/api-reference/config/next-config-js/compress) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js provides gzip compression to compress rendered content and static files, it only works with the server target. Learn more about it here. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [crossOrigin](/docs/app/api-reference/config/next-config-js/crossOrigin) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use the `crossOrigin` option to add a crossOrigin tag on the `script` tags generated by `next/script`. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [cssChunking](/docs/app/api-reference/config/next-config-js/cssChunking) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use the `cssChunking` option to control how CSS files are chunked in your Next.js application. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [deploymentId](/docs/app/api-reference/config/next-config-js/deploymentId) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure a deployment identifier used for version skew protection and cache busting. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [devIndicators](/docs/app/api-reference/config/next-config-js/devIndicators) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configuration options for the on-screen indicator that gives context about the current route you're viewing during development. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [distDir](/docs/app/api-reference/config/next-config-js/distDir) | Type: Reference | Lastmod: 2026-05-13 | Summary: Set a custom build directory to use instead of the default .next directory. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [env](/docs/app/api-reference/config/next-config-js/env) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn to add and access environment variables in your Next.js application at build time. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [expireTime](/docs/app/api-reference/config/next-config-js/expireTime) | Type: Reference | Lastmod: 2026-05-13 | Summary: Customize stale-while-revalidate expire time for ISR enabled pages. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [exportPathMap](/docs/app/api-reference/config/next-config-js/exportPathMap) | Type: Reference | Lastmod: 2026-05-13 | Summary: Customize the pages that will be exported as HTML files when using `next export`. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [generateBuildId](/docs/app/api-reference/config/next-config-js/generateBuildId) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure the build id, which is used to identify the current build in which your application is being served. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [generateEtags](/docs/app/api-reference/config/next-config-js/generateEtags) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js will generate etags for every page by default. Learn more about how to disable etag generation here. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [headers](/docs/app/api-reference/config/next-config-js/headers) | Type: Reference | Lastmod: 2026-05-13 | Summary: Add custom HTTP headers to your Next.js app. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [htmlLimitedBots](/docs/app/api-reference/config/next-config-js/htmlLimitedBots) | Type: Reference | Lastmod: 2026-05-13 | Summary: Specify a list of user agents that should receive blocking metadata. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [httpAgentOptions](/docs/app/api-reference/config/next-config-js/httpAgentOptions) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js will automatically use HTTP Keep-Alive by default. Learn more about how to disable HTTP Keep-Alive here. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [images](/docs/app/api-reference/config/next-config-js/images) | Type: Reference | Lastmod: 2026-05-13 | Summary: Custom configuration for the next/image loader | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [cacheHandler](/docs/app/api-reference/config/next-config-js/incrementalCacheHandlerPath) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure the Next.js cache used for storing and revalidating data to use any external service like Redis, Memcached, or others. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [inlineCss](/docs/app/api-reference/config/next-config-js/inlineCss) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable inline CSS support. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [logging](/docs/app/api-reference/config/next-config-js/logging) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure logging behavior in the terminal when running Next.js in development mode, including fetch logging, incoming requests, and forwarding browser console logs to the terminal. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [mdxRs](/docs/app/api-reference/config/next-config-js/mdxRs) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use the new Rust compiler to compile MDX files in the App Router. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [onDemandEntries](/docs/app/api-reference/config/next-config-js/onDemandEntries) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure how Next.js will dispose and keep in memory pages created in development. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [optimizePackageImports](/docs/app/api-reference/config/next-config-js/optimizePackageImports) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for optimizePackageImports Next.js Config Option | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [output](/docs/app/api-reference/config/next-config-js/output) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js automatically traces which files are needed by each page to allow for easy deployment of your application. Learn how it works here. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [pageExtensions](/docs/app/api-reference/config/next-config-js/pageExtensions) | Type: Reference | Lastmod: 2026-05-13 | Summary: Extend the default page extensions used by Next.js when resolving pages in the Pages Router. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [poweredByHeader](/docs/app/api-reference/config/next-config-js/poweredByHeader) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js will add the `x-powered-by` header by default. Learn to opt-out of it here. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [productionBrowserSourceMaps](/docs/app/api-reference/config/next-config-js/productionBrowserSourceMaps) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enables browser source map generation during the production build. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [proxyClientMaxBodySize](/docs/app/api-reference/config/next-config-js/proxyClientMaxBodySize) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure the maximum request body size when using proxy. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [reactCompiler](/docs/app/api-reference/config/next-config-js/reactCompiler) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable the React Compiler to automatically optimize component rendering. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [reactMaxHeadersLength](/docs/app/api-reference/config/next-config-js/reactMaxHeadersLength) | Type: Reference | Lastmod: 2026-05-13 | Summary: The maximum length of the headers that are emitted by React and added to the response. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [reactStrictMode](/docs/app/api-reference/config/next-config-js/reactStrictMode) | Type: Reference | Lastmod: 2026-05-13 | Summary: The complete Next.js runtime is now Strict Mode-compliant, learn how to opt-in | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [redirects](/docs/app/api-reference/config/next-config-js/redirects) | Type: Reference | Lastmod: 2026-05-13 | Summary: Add redirects to your Next.js app. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [rewrites](/docs/app/api-reference/config/next-config-js/rewrites) | Type: Reference | Lastmod: 2026-05-13 | Summary: Add rewrites to your Next.js app. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [sassOptions](/docs/app/api-reference/config/next-config-js/sassOptions) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Sass options. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [serverActions](/docs/app/api-reference/config/next-config-js/serverActions) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Server Actions behavior in your Next.js application. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [serverComponentsHmrCache](/docs/app/api-reference/config/next-config-js/serverComponentsHmrCache) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure whether fetch responses in Server Components are cached across HMR refresh requests. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [serverExternalPackages](/docs/app/api-reference/config/next-config-js/serverExternalPackages) | Type: Reference | Lastmod: 2026-05-13 | Summary: Opt-out specific dependencies from the Server Components bundling and use native Node.js `require`. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [staleTimes](/docs/app/api-reference/config/next-config-js/staleTimes) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to override the invalidation time of the client cache. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [staticGeneration*](/docs/app/api-reference/config/next-config-js/staticGeneration) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to configure static generation in your Next.js application. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [taint](/docs/app/api-reference/config/next-config-js/taint) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable tainting Objects and Values. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [trailingSlash](/docs/app/api-reference/config/next-config-js/trailingSlash) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Next.js pages to resolve with or without a trailing slash. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [transpilePackages](/docs/app/api-reference/config/next-config-js/transpilePackages) | Type: Reference | Lastmod: 2026-05-13 | Summary: Automatically transpile and bundle dependencies from local packages (like monorepos) or from external dependencies (`node_modules`). | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [turbopack](/docs/app/api-reference/config/next-config-js/turbopack) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Next.js with Turbopack-specific options | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [turbopackFileSystemCache](/docs/app/api-reference/config/next-config-js/turbopackFileSystemCache) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to enable FileSystem Caching for Turbopack builds | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [turbopack.ignoreIssue](/docs/app/api-reference/config/next-config-js/turbopackIgnoreIssue) | Type: Reference | Lastmod: 2026-05-13 | Summary: Suppress specific Turbopack errors and warnings from the CLI output and error overlay. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [typedRoutes](/docs/app/api-reference/config/next-config-js/typedRoutes) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable support for statically typed links. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [typescript](/docs/app/api-reference/config/next-config-js/typescript) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure how Next.js handles TypeScript errors during production builds and specify a custom tsconfig file. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [urlImports](/docs/app/api-reference/config/next-config-js/urlImports) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Next.js to allow importing modules from external URLs. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [useLightningcss](/docs/app/api-reference/config/next-config-js/useLightningcss) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable experimental support for Lightning CSS. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [viewTransition](/docs/app/api-reference/config/next-config-js/viewTransition) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable ViewTransition API from React in App Router | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [webpack](/docs/app/api-reference/config/next-config-js/webpack) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to customize the webpack config used by Next.js | Prerequisites: next.config.js | Topics: app-router, api-reference, config

            - [webVitalsAttribution](/docs/app/api-reference/config/next-config-js/webVitalsAttribution) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the webVitalsAttribution option to pinpoint the source of Web Vitals issues. | Prerequisites: next.config.js | Topics: app-router, api-reference, config

        - [TypeScript](/docs/app/api-reference/config/typescript) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js provides a TypeScript-first development experience for building your React application. | Prerequisites: Configuration | Topics: app-router, api-reference, config

        - [ESLint](/docs/app/api-reference/config/eslint) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use and configure the ESLint plugin to catch common issues and problems in a Next.js application. | Prerequisites: Configuration | Topics: app-router, api-reference, config

    - [CLI](/docs/app/api-reference/cli) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the Next.js Command Line Interface (CLI) tools. | Prerequisites: API Reference | Topics: app-router, api-reference, cli

        - [create-next-app](/docs/app/api-reference/cli/create-next-app) | Type: Reference | Lastmod: 2026-05-13 | Summary: Create Next.js apps using one command with the create-next-app CLI. | Prerequisites: CLI | Topics: app-router, api-reference, cli

        - [next CLI](/docs/app/api-reference/cli/next) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to run and build your application with the Next.js CLI. | Prerequisites: CLI | Topics: app-router, api-reference, cli

    - [Adapters](/docs/app/api-reference/adapters) | Type: Reference | Lastmod: 2026-05-13 | Summary: Build deployment adapters for Next.js platforms and infrastructure. | Prerequisites: API Reference | Topics: app-router, api-reference, adapters

        - [Configuration](/docs/app/api-reference/adapters/configuration) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure `adapterPath` or `NEXT_ADAPTER_PATH` to use a custom deployment adapter. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Creating an Adapter](/docs/app/api-reference/adapters/creating-an-adapter) | Type: Reference | Lastmod: 2026-05-13 | Summary: Create an adapter module that implements the `NextAdapter` interface. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [API Reference](/docs/app/api-reference/adapters/api-reference) | Type: Reference | Lastmod: 2026-05-13 | Summary: Reference for `modifyConfig` and `onBuildComplete` in the `NextAdapter` interface. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Testing Adapters](/docs/app/api-reference/adapters/testing-adapters) | Type: Reference | Lastmod: 2026-05-13 | Summary: Validate adapters with the Next.js compatibility test harness and custom lifecycle scripts. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Routing with @next/routing](/docs/app/api-reference/adapters/routing-with-next-routing) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use `@next/routing` to apply Next.js route matching behavior in adapters. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Implementing PPR in an Adapter](/docs/app/api-reference/adapters/implementing-ppr-in-an-adapter) | Type: Reference | Lastmod: 2026-05-13 | Summary: Implement Partial Prerendering support in an adapter using fallback output and cache hooks. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Runtime Integration](/docs/app/api-reference/adapters/runtime-integration) | Type: Reference | Lastmod: 2026-05-13 | Summary: Understand how build-time adapters and runtime cache interfaces work together. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Invoking Entrypoints](/docs/app/api-reference/adapters/invoking-entrypoints) | Type: Reference | Lastmod: 2026-05-13 | Summary: Invoke Node.js and Edge build entrypoints with adapter runtime context. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Output Types](/docs/app/api-reference/adapters/output-types) | Type: Reference | Lastmod: 2026-05-13 | Summary: Reference for all build output types exposed to adapters. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Routing Information](/docs/app/api-reference/adapters/routing-information) | Type: Reference | Lastmod: 2026-05-13 | Summary: Reference for routing phases and route fields exposed in `onBuildComplete`. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

        - [Use Cases](/docs/app/api-reference/adapters/use-cases) | Type: Reference | Lastmod: 2026-05-13 | Summary: Common patterns and examples for deployment adapter implementations. | Prerequisites: Adapters | Topics: app-router, api-reference, adapters

    - [Edge Runtime](/docs/app/api-reference/edge) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the Edge Runtime. | Prerequisites: API Reference | Topics: app-router, api-reference, edge

    - [Turbopack](/docs/app/api-reference/turbopack) | Type: Reference | Lastmod: 2026-05-13 | Summary: Turbopack is an incremental bundler optimized for JavaScript and TypeScript, written in Rust, and built into Next.js. | Prerequisites: API Reference | Topics: app-router, api-reference, turbopack

- [Glossary](/docs/app/glossary) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: A glossary of common terms used in Next.js. | Topics: app-router, glossary

## Pages Router

- [Getting Started](/docs/pages/getting-started) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to create full-stack web applications with Next.js with the Pages Router. | Topics: pages-router, getting-started

    - [Installation](/docs/pages/getting-started/installation) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: How to create a new Next.js application with `create-next-app`. Set up TypeScript, ESLint,and configure your `next.config.js` file. | Prerequisites: Getting Started | Topics: pages-router, getting-started, installation

    - [Project Structure](/docs/pages/getting-started/project-structure) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn about the folder and file conventions in a Next.js project, and how to organize your project. | Prerequisites: Getting Started | Topics: pages-router, getting-started, project-structure

    - [Images](/docs/pages/getting-started/images) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Optimize your images with the built-in `next/image` component. | Prerequisites: Getting Started | Topics: pages-router, getting-started, images

    - [Fonts](/docs/pages/getting-started/fonts) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to use fonts in Next.js | Prerequisites: Getting Started | Topics: pages-router, getting-started, fonts

    - [CSS](/docs/pages/getting-started/css) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn about the different ways to add CSS to your application, including CSS Modules, Global CSS, Tailwind CSS, and more. | Prerequisites: Getting Started | Topics: pages-router, getting-started, css

    - [Deploying](/docs/pages/getting-started/deploying) | Type: Tutorial | Lastmod: 2026-05-13 | Summary: Learn how to deploy your Next.js application. | Prerequisites: Getting Started | Topics: pages-router, getting-started, deploying

- [Guides](/docs/pages/guides) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to implement common UI patterns and use cases using Next.js | Topics: pages-router, guides

    - [Analytics](/docs/pages/guides/analytics) | Type: How-to | Lastmod: 2026-05-13 | Summary: Measure and track page performance using Next.js | Prerequisites: Guides | Topics: pages-router, guides, analytics

    - [Authentication](/docs/pages/guides/authentication) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to implement authentication in Next.js, covering best practices, securing routes, authorization techniques, and session management. | Prerequisites: Guides | Topics: pages-router, guides, authentication

    - [Babel](/docs/pages/guides/babel) | Type: How-to | Lastmod: 2026-05-13 | Summary: Extend the babel preset added by Next.js with your own configs. | Prerequisites: Guides | Topics: pages-router, guides, babel

    - [CI Build Caching](/docs/pages/guides/ci-build-caching) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to configure CI to cache Next.js builds | Prerequisites: Guides | Topics: pages-router, guides, ci-build-caching

    - [Content Security Policy](/docs/pages/guides/content-security-policy) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set a Content Security Policy (CSP) for your Next.js application. | Prerequisites: Guides | Topics: pages-router, guides, content-security-policy

    - [CSS-in-JS](/docs/pages/guides/css-in-js) | Type: How-to | Lastmod: 2026-05-13 | Summary: Use CSS-in-JS libraries with Next.js | Prerequisites: Guides | Topics: pages-router, guides, css-in-js

    - [Custom Server](/docs/pages/guides/custom-server) | Type: How-to | Lastmod: 2026-05-13 | Summary: Start a Next.js app programmatically using a custom server. | Prerequisites: Guides | Topics: pages-router, guides, custom-server

    - [Debugging](/docs/pages/guides/debugging) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to debug your Next.js application with VS Code or Chrome DevTools. | Prerequisites: Guides | Topics: pages-router, guides, debugging

    - [Draft Mode](/docs/pages/guides/draft-mode) | Type: How-to | Lastmod: 2026-05-13 | Summary: Next.js has draft mode to toggle between static and dynamic pages. You can learn how it works with Pages Router. | Prerequisites: Guides | Topics: pages-router, guides, draft-mode

    - [Environment Variables](/docs/pages/guides/environment-variables) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn to add and access environment variables in your Next.js application. | Prerequisites: Guides | Topics: pages-router, guides, environment-variables

    - [Forms](/docs/pages/guides/forms) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to handle form submissions and data mutations with Next.js. | Prerequisites: Guides | Topics: pages-router, guides, forms

    - [ISR](/docs/pages/guides/incremental-static-regeneration) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to create or update static pages at runtime with Incremental Static Regeneration. | Prerequisites: Guides | Topics: pages-router, guides, incremental-static-regeneration

    - [Instrumentation](/docs/pages/guides/instrumentation) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to use instrumentation to run code at server startup in your Next.js app | Prerequisites: Guides | Topics: pages-router, guides, instrumentation

    - [Internationalization](/docs/pages/guides/internationalization) | Type: How-to | Lastmod: 2026-05-13 | Summary: Next.js has built-in support for internationalized routing and language detection. Learn more here. | Prerequisites: Guides | Topics: pages-router, guides, internationalization

    - [Lazy Loading](/docs/pages/guides/lazy-loading) | Type: How-to | Lastmod: 2026-05-13 | Summary: Lazy load imported libraries and React Components to improve your application's overall loading performance. | Prerequisites: Guides | Topics: pages-router, guides, lazy-loading

    - [MDX](/docs/pages/guides/mdx) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to configure MDX to write JSX in your markdown files. | Prerequisites: Guides | Topics: pages-router, guides, mdx

    - [Migrating](/docs/pages/guides/migrating) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to migrate from popular frameworks to Next.js | Prerequisites: Guides | Topics: pages-router, guides, migrating

        - [App Router](/docs/pages/guides/migrating/app-router-migration) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to upgrade your existing Next.js application from the Pages Router to the App Router. | Prerequisites: Migrating | Topics: pages-router, guides, migrating

        - [Create React App](/docs/pages/guides/migrating/from-create-react-app) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to migrate your existing React application from Create React App to Next.js. | Prerequisites: Migrating | Topics: pages-router, guides, migrating

        - [Vite](/docs/pages/guides/migrating/from-vite) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to migrate your existing React application from Vite to Next.js. | Prerequisites: Migrating | Topics: pages-router, guides, migrating

    - [Multi-Zones](/docs/pages/guides/multi-zones) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to build micro-frontends using Next.js Multi-Zones to deploy multiple Next.js apps under a single domain. | Prerequisites: Guides | Topics: pages-router, guides, multi-zones

    - [OpenTelemetry](/docs/pages/guides/open-telemetry) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to instrument your Next.js app with OpenTelemetry. | Prerequisites: Guides | Topics: pages-router, guides, open-telemetry

    - [Package Bundling](/docs/pages/guides/package-bundling) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to optimize your application's server and client bundles. | Prerequisites: Guides | Topics: pages-router, guides, package-bundling

    - [PostCSS](/docs/pages/guides/post-css) | Type: How-to | Lastmod: 2026-05-13 | Summary: Extend the PostCSS config and plugins added by Next.js with your own. | Prerequisites: Guides | Topics: pages-router, guides, post-css

    - [Preview Mode](/docs/pages/guides/preview-mode) | Type: How-to | Lastmod: 2026-05-13 | Summary: Next.js has the preview mode for statically generated pages. You can learn how it works here. | Prerequisites: Guides | Topics: pages-router, guides, preview-mode

    - [Production](/docs/pages/guides/production-checklist) | Type: How-to | Lastmod: 2026-05-13 | Summary: Recommendations to ensure the best performance and user experience before taking your Next.js application to production. | Prerequisites: Guides | Topics: pages-router, guides, production-checklist

    - [Redirecting](/docs/pages/guides/redirecting) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn the different ways to handle redirects in Next.js. | Prerequisites: Guides | Topics: pages-router, guides, redirecting

    - [Sass](/docs/pages/guides/sass) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to use Sass in your Next.js application. | Prerequisites: Guides | Topics: pages-router, guides, sass

    - [Scripts](/docs/pages/guides/scripts) | Type: How-to | Lastmod: 2026-05-13 | Summary: Optimize 3rd party scripts with the built-in Script component. | Prerequisites: Guides | Topics: pages-router, guides, scripts

    - [Self-Hosting](/docs/pages/guides/self-hosting) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to self-host your Next.js application on a Node.js server, Docker image, or static HTML files (static exports). | Prerequisites: Guides | Topics: pages-router, guides, self-hosting

    - [Static Exports](/docs/pages/guides/static-exports) | Type: How-to | Lastmod: 2026-05-13 | Summary: Next.js enables starting as a static site or Single-Page Application (SPA), then later optionally upgrading to use features that require a server. | Prerequisites: Guides | Topics: pages-router, guides, static-exports

    - [Tailwind CSS](/docs/pages/guides/tailwind-v3-css) | Type: How-to | Lastmod: 2026-05-13 | Summary: Style your Next.js Application using Tailwind CSS. | Prerequisites: Guides | Topics: pages-router, guides, tailwind-v3-css

    - [Testing](/docs/pages/guides/testing) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Next.js with three commonly used testing tools — Cypress, Playwright, Vitest, and Jest. | Prerequisites: Guides | Topics: pages-router, guides, testing

        - [Cypress](/docs/pages/guides/testing/cypress) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Next.js with Cypress for End-to-End (E2E) and Component Testing. | Prerequisites: Testing | Topics: pages-router, guides, testing

        - [Jest](/docs/pages/guides/testing/jest) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Next.js with Jest for Unit Testing. | Prerequisites: Testing | Topics: pages-router, guides, testing

        - [Playwright](/docs/pages/guides/testing/playwright) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Next.js with Playwright for End-to-End (E2E) and Integration testing. | Prerequisites: Testing | Topics: pages-router, guides, testing

        - [Vitest](/docs/pages/guides/testing/vitest) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to set up Next.js with Vitest and React Testing Library - two popular unit testing libraries. | Prerequisites: Testing | Topics: pages-router, guides, testing

    - [Third Party Libraries](/docs/pages/guides/third-party-libraries) | Type: How-to | Lastmod: 2026-05-13 | Summary: Optimize the performance of third-party libraries in your application with the `@next/third-parties` package. | Prerequisites: Guides | Topics: pages-router, guides, third-party-libraries

    - [Upgrading](/docs/pages/guides/upgrading) | Type: How-to | Lastmod: 2026-05-13 | Summary: Learn how to upgrade to the latest versions of Next.js. | Prerequisites: Guides | Topics: pages-router, guides, upgrading

        - [Codemods](/docs/pages/guides/upgrading/codemods) | Type: How-to | Lastmod: 2026-05-13 | Summary: Use codemods to upgrade your Next.js codebase when new features are released. | Prerequisites: Upgrading | Topics: pages-router, guides, upgrading

        - [Version 10](/docs/pages/guides/upgrading/version-10) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 9 to Version 10. | Prerequisites: Upgrading | Topics: pages-router, guides, upgrading

        - [Version 11](/docs/pages/guides/upgrading/version-11) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 10 to Version 11. | Prerequisites: Upgrading | Topics: pages-router, guides, upgrading

        - [Version 12](/docs/pages/guides/upgrading/version-12) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 11 to Version 12. | Prerequisites: Upgrading | Topics: pages-router, guides, upgrading

        - [Version 13](/docs/pages/guides/upgrading/version-13) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 12 to 13. | Prerequisites: Upgrading | Topics: pages-router, guides, upgrading

        - [Version 14](/docs/pages/guides/upgrading/version-14) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 13 to 14. | Prerequisites: Upgrading | Topics: pages-router, guides, upgrading

        - [Version 9](/docs/pages/guides/upgrading/version-9) | Type: How-to | Lastmod: 2026-05-13 | Summary: Upgrade your Next.js Application from Version 8 to Version 9. | Prerequisites: Upgrading | Topics: pages-router, guides, upgrading

- [Building Your Application](/docs/pages/building-your-application) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn how to use Next.js features to build your application. | Topics: pages-router, building-your-application

    - [Routing](/docs/pages/building-your-application/routing) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn the fundamentals of routing for front-end applications with the Pages Router. | Prerequisites: Building Your Application | Topics: pages-router, building-your-application, routing

        - [Pages and Layouts](/docs/pages/building-your-application/routing/pages-and-layouts) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Create your first page and shared layout with the Pages Router. | Prerequisites: Routing | Topics: pages-router, building-your-application, routing

        - [Dynamic Routes](/docs/pages/building-your-application/routing/dynamic-routes) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Dynamic Routes are pages that allow you to add custom params to your URLs. Start creating Dynamic Routes and learn more here. | Prerequisites: Routing | Topics: pages-router, building-your-application, routing

        - [Linking and Navigating](/docs/pages/building-your-application/routing/linking-and-navigating) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn how navigation works in Next.js, and how to use the Link Component and `useRouter` hook. | Prerequisites: Routing | Topics: pages-router, building-your-application, routing

        - [Custom App](/docs/pages/building-your-application/routing/custom-app) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Control page initialization and add a layout that persists for all pages by overriding the default App component used by Next.js. | Prerequisites: Routing | Topics: pages-router, building-your-application, routing

        - [Custom Document](/docs/pages/building-your-application/routing/custom-document) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Extend the default document markup added by Next.js. | Prerequisites: Routing | Topics: pages-router, building-your-application, routing

        - [API Routes](/docs/pages/building-your-application/routing/api-routes) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Next.js supports API Routes, which allow you to build your API without leaving your Next.js app. Learn how it works here. | Prerequisites: Routing | Topics: pages-router, building-your-application, routing

        - [Custom Errors](/docs/pages/building-your-application/routing/custom-error) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Override and extend the built-in Error page to handle custom errors. | Prerequisites: Routing | Topics: pages-router, building-your-application, routing

    - [Rendering](/docs/pages/building-your-application/rendering) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn the fundamentals of rendering in React and Next.js. | Prerequisites: Building Your Application | Topics: pages-router, building-your-application, rendering

        - [Server-side Rendering (SSR)](/docs/pages/building-your-application/rendering/server-side-rendering) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Use Server-side Rendering to render pages on each request. | Prerequisites: Rendering | Topics: pages-router, building-your-application, rendering

        - [Static Site Generation (SSG)](/docs/pages/building-your-application/rendering/static-site-generation) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Use Static Site Generation (SSG) to prerender pages at build time. | Prerequisites: Rendering | Topics: pages-router, building-your-application, rendering

        - [Automatic Static Optimization](/docs/pages/building-your-application/rendering/automatic-static-optimization) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Next.js automatically optimizes your app to be static HTML whenever possible. Learn how it works here. | Prerequisites: Rendering | Topics: pages-router, building-your-application, rendering

        - [Client-side Rendering (CSR)](/docs/pages/building-your-application/rendering/client-side-rendering) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn how to implement client-side rendering in the Pages Router. | Prerequisites: Rendering | Topics: pages-router, building-your-application, rendering

    - [Data Fetching](/docs/pages/building-your-application/data-fetching) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Next.js allows you to fetch data in multiple ways, with prerendering, server-side rendering or static-site generation, and incremental static regeneration. Learn how to manage your application data in Next.js. | Prerequisites: Building Your Application | Topics: pages-router, building-your-application, data-fetching

        - [getStaticProps](/docs/pages/building-your-application/data-fetching/get-static-props) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Fetch data and generate static pages with `getStaticProps`. Learn more about this API for data fetching in Next.js. | Prerequisites: Data Fetching | Topics: pages-router, building-your-application, data-fetching

        - [getStaticPaths](/docs/pages/building-your-application/data-fetching/get-static-paths) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Fetch data and generate static pages with `getStaticPaths`. Learn more about this API for data fetching in Next.js. | Prerequisites: Data Fetching | Topics: pages-router, building-your-application, data-fetching

        - [getServerSideProps](/docs/pages/building-your-application/data-fetching/get-server-side-props) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Fetch data on each request with `getServerSideProps`. | Prerequisites: Data Fetching | Topics: pages-router, building-your-application, data-fetching

        - [Client-side Fetching](/docs/pages/building-your-application/data-fetching/client-side) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn about client-side data fetching, and how to use SWR, a data fetching React Hook library that handles caching, revalidation, focus tracking, refetching on interval and more. | Prerequisites: Data Fetching | Topics: pages-router, building-your-application, data-fetching

    - [Configuring](/docs/pages/building-your-application/configuring) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn how to configure your Next.js application. | Prerequisites: Building Your Application | Topics: pages-router, building-your-application, configuring

        - [Error Handling](/docs/pages/building-your-application/configuring/error-handling) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Handle errors in your Next.js app. | Prerequisites: Configuring | Topics: pages-router, building-your-application, configuring

- [API Reference](/docs/pages/api-reference) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js API Reference for the Pages Router. | Topics: pages-router, api-reference

    - [Components](/docs/pages/api-reference/components) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for Next.js built-in components in the Pages Router. | Prerequisites: API Reference | Topics: pages-router, api-reference, components

        - [Font](/docs/pages/api-reference/components/font) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the Font Module | Prerequisites: Components | Topics: pages-router, api-reference, components

        - [Form](/docs/pages/api-reference/components/form) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the `<Form>` component to handle form submissions and search params updates with client-side navigation. | Prerequisites: Components | Topics: pages-router, api-reference, components

        - [Head](/docs/pages/api-reference/components/head) | Type: Reference | Lastmod: 2026-05-13 | Summary: Add custom elements to the `head` of your page with the built-in Head component. | Prerequisites: Components | Topics: pages-router, api-reference, components

        - [Image](/docs/pages/api-reference/components/image) | Type: Reference | Lastmod: 2026-05-13 | Summary: Optimize Images in your Next.js Application using the built-in `next/image` Component. | Prerequisites: Components | Topics: pages-router, api-reference, components

        - [Image (Legacy)](/docs/pages/api-reference/components/image-legacy) | Type: Reference | Lastmod: 2026-05-13 | Summary: Backwards compatible Image Optimization with the Legacy Image component. | Prerequisites: Components | Topics: pages-router, api-reference, components

        - [Link](/docs/pages/api-reference/components/link) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the `<Link>` component. | Prerequisites: Components | Topics: pages-router, api-reference, components

        - [Script](/docs/pages/api-reference/components/script) | Type: Reference | Lastmod: 2026-05-13 | Summary: Optimize third-party scripts in your Next.js application using the built-in `next/script` Component. | Prerequisites: Components | Topics: pages-router, api-reference, components

    - [File-system conventions](/docs/pages/api-reference/file-conventions) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for Next.js file-system conventions. | Prerequisites: API Reference | Topics: pages-router, api-reference, file-conventions

        - [instrumentation.js](/docs/pages/api-reference/file-conventions/instrumentation) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for the instrumentation.js file. | Prerequisites: File-system conventions | Topics: pages-router, api-reference, file-conventions

        - [Proxy](/docs/pages/api-reference/file-conventions/proxy) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use Proxy to run code before a request is completed. | Prerequisites: File-system conventions | Topics: pages-router, api-reference, file-conventions

        - [public](/docs/pages/api-reference/file-conventions/public-folder) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js allows you to serve static files, like images, in the public directory. You can learn how it works here. | Prerequisites: File-system conventions | Topics: pages-router, api-reference, file-conventions

        - [src Directory](/docs/pages/api-reference/file-conventions/src-folder) | Type: Reference | Lastmod: 2026-05-13 | Summary: Save pages under the `src` folder as an alternative to the root `pages` directory. | Prerequisites: File-system conventions | Topics: pages-router, api-reference, file-conventions

    - [Functions](/docs/pages/api-reference/functions) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for Functions and Hooks in Pages Router. | Prerequisites: API Reference | Topics: pages-router, api-reference, functions

        - [getInitialProps](/docs/pages/api-reference/functions/get-initial-props) | Type: Reference | Lastmod: 2026-05-13 | Summary: Fetch dynamic data on the server for your React component with getInitialProps. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [getServerSideProps](/docs/pages/api-reference/functions/get-server-side-props) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for `getServerSideProps`. Learn how to fetch data on each request with Next.js. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [getStaticPaths](/docs/pages/api-reference/functions/get-static-paths) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for `getStaticPaths`. Learn how to fetch data and generate static pages with `getStaticPaths`. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [getStaticProps](/docs/pages/api-reference/functions/get-static-props) | Type: Reference | Lastmod: 2026-05-13 | Summary: API reference for `getStaticProps`. Learn how to use `getStaticProps` to generate static pages with Next.js. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [NextRequest](/docs/pages/api-reference/functions/next-request) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for NextRequest. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [NextResponse](/docs/pages/api-reference/functions/next-response) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for NextResponse. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [useParams](/docs/pages/api-reference/functions/use-params) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useParams hook in the Pages Router. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [useReportWebVitals](/docs/pages/api-reference/functions/use-report-web-vitals) | Type: Reference | Lastmod: 2026-05-13 | Summary: useReportWebVitals | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [useRouter](/docs/pages/api-reference/functions/use-router) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn more about the API of the Next.js Router, and access the router instance in your page with the useRouter hook. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [useSearchParams](/docs/pages/api-reference/functions/use-search-params) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the useSearchParams hook in the Pages Router. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

        - [userAgent](/docs/pages/api-reference/functions/userAgent) | Type: Reference | Lastmod: 2026-05-13 | Summary: The userAgent helper extends the Web Request API with additional properties and methods to interact with the user agent object from the request. | Prerequisites: Functions | Topics: pages-router, api-reference, functions

    - [Configuration](/docs/pages/api-reference/config) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to configure your Next.js application. | Prerequisites: API Reference | Topics: pages-router, api-reference, config

        - [next.config.js Options](/docs/pages/api-reference/config/next-config-js) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn about the options available in next.config.js for the Pages Router. | Prerequisites: Configuration | Topics: pages-router, api-reference, config

            - [adapterPath](/docs/pages/api-reference/config/next-config-js/adapterPath) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure a custom adapter for Next.js to hook into the build process. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [allowedDevOrigins](/docs/pages/api-reference/config/next-config-js/allowedDevOrigins) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use `allowedDevOrigins` to configure additional origins that can request the dev server. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [assetPrefix](/docs/pages/api-reference/config/next-config-js/assetPrefix) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the assetPrefix config option to configure your CDN. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [basePath](/docs/pages/api-reference/config/next-config-js/basePath) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use `basePath` to deploy a Next.js application under a sub-path of a domain. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [bundlePagesRouterDependencies](/docs/pages/api-reference/config/next-config-js/bundlePagesRouterDependencies) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable automatic dependency bundling for Pages Router | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [compress](/docs/pages/api-reference/config/next-config-js/compress) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js provides gzip compression to compress rendered content and static files, it only works with the server target. Learn more about it here. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [crossOrigin](/docs/pages/api-reference/config/next-config-js/crossOrigin) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use the `crossOrigin` option to add a crossOrigin tag on the `script` tags generated by `next/script` and `next/head`. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [deploymentId](/docs/pages/api-reference/config/next-config-js/deploymentId) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure a deployment identifier used for version skew protection and cache busting. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [devIndicators](/docs/pages/api-reference/config/next-config-js/devIndicators) | Type: Reference | Lastmod: 2026-05-13 | Summary: Optimized pages include an indicator to let you know if it's being statically optimized. You can opt-out of it here. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [distDir](/docs/pages/api-reference/config/next-config-js/distDir) | Type: Reference | Lastmod: 2026-05-13 | Summary: Set a custom build directory to use instead of the default .next directory. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [env](/docs/pages/api-reference/config/next-config-js/env) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn to add and access environment variables in your Next.js application at build time. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [exportPathMap](/docs/pages/api-reference/config/next-config-js/exportPathMap) | Type: Reference | Lastmod: 2026-05-13 | Summary: Customize the pages that will be exported as HTML files when using `next export`. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [generateBuildId](/docs/pages/api-reference/config/next-config-js/generateBuildId) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure the build id, which is used to identify the current build in which your application is being served. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [generateEtags](/docs/pages/api-reference/config/next-config-js/generateEtags) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js will generate etags for every page by default. Learn more about how to disable etag generation here. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [headers](/docs/pages/api-reference/config/next-config-js/headers) | Type: Reference | Lastmod: 2026-05-13 | Summary: Add custom HTTP headers to your Next.js app. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [httpAgentOptions](/docs/pages/api-reference/config/next-config-js/httpAgentOptions) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js will automatically use HTTP Keep-Alive by default. Learn more about how to disable HTTP Keep-Alive here. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [images](/docs/pages/api-reference/config/next-config-js/images) | Type: Reference | Lastmod: 2026-05-13 | Summary: Custom configuration for the next/image loader | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [logging](/docs/pages/api-reference/config/next-config-js/logging) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure logging behavior in the terminal when running Next.js in development mode. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [onDemandEntries](/docs/pages/api-reference/config/next-config-js/onDemandEntries) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure how Next.js will dispose and keep in memory pages created in development. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [optimizePackageImports](/docs/pages/api-reference/config/next-config-js/optimizePackageImports) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for optimizePackageImports Next.js Config Option | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [output](/docs/pages/api-reference/config/next-config-js/output) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js automatically traces which files are needed by each page to allow for easy deployment of your application. Learn how it works here. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [pageExtensions](/docs/pages/api-reference/config/next-config-js/pageExtensions) | Type: Reference | Lastmod: 2026-05-13 | Summary: Extend the default page extensions used by Next.js when resolving pages in the Pages Router. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [poweredByHeader](/docs/pages/api-reference/config/next-config-js/poweredByHeader) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js will add the `x-powered-by` header by default. Learn to opt-out of it here. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [productionBrowserSourceMaps](/docs/pages/api-reference/config/next-config-js/productionBrowserSourceMaps) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enables browser source map generation during the production build. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [experimental.proxyClientMaxBodySize](/docs/pages/api-reference/config/next-config-js/proxyClientMaxBodySize) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure the maximum request body size when using proxy. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [reactStrictMode](/docs/pages/api-reference/config/next-config-js/reactStrictMode) | Type: Reference | Lastmod: 2026-05-13 | Summary: The complete Next.js runtime is now Strict Mode-compliant, learn how to opt-in | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [redirects](/docs/pages/api-reference/config/next-config-js/redirects) | Type: Reference | Lastmod: 2026-05-13 | Summary: Add redirects to your Next.js app. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [rewrites](/docs/pages/api-reference/config/next-config-js/rewrites) | Type: Reference | Lastmod: 2026-05-13 | Summary: Add rewrites to your Next.js app. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [serverExternalPackages](/docs/pages/api-reference/config/next-config-js/serverExternalPackages) | Type: Reference | Lastmod: 2026-05-13 | Summary: Opt-out specific dependencies from the dependency bundling enabled by `bundlePagesRouterDependencies`. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [trailingSlash](/docs/pages/api-reference/config/next-config-js/trailingSlash) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Next.js pages to resolve with or without a trailing slash. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [transpilePackages](/docs/pages/api-reference/config/next-config-js/transpilePackages) | Type: Reference | Lastmod: 2026-05-13 | Summary: Automatically transpile and bundle dependencies from local packages (like monorepos) or from external dependencies (`node_modules`). | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [turbopack](/docs/pages/api-reference/config/next-config-js/turbopack) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Next.js with Turbopack-specific options | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [typescript](/docs/pages/api-reference/config/next-config-js/typescript) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js reports TypeScript errors by default. Learn to opt-out of this behavior here. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [urlImports](/docs/pages/api-reference/config/next-config-js/urlImports) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure Next.js to allow importing modules from external URLs. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [useLightningcss](/docs/pages/api-reference/config/next-config-js/useLightningcss) | Type: Reference | Lastmod: 2026-05-13 | Summary: Enable experimental support for Lightning CSS. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [webpack](/docs/pages/api-reference/config/next-config-js/webpack) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to customize the webpack config used by Next.js | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

            - [webVitalsAttribution](/docs/pages/api-reference/config/next-config-js/webVitalsAttribution) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to use the webVitalsAttribution option to pinpoint the source of Web Vitals issues. | Prerequisites: next.config.js Options | Topics: pages-router, api-reference, config

        - [TypeScript](/docs/pages/api-reference/config/typescript) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js provides a TypeScript-first development experience for building your React application. | Prerequisites: Configuration | Topics: pages-router, api-reference, config

        - [ESLint](/docs/pages/api-reference/config/eslint) | Type: Reference | Lastmod: 2026-05-13 | Summary: Next.js reports ESLint errors and warnings during builds by default. Learn how to opt-out of this behavior here. | Prerequisites: Configuration | Topics: pages-router, api-reference, config

    - [CLI](/docs/pages/api-reference/cli) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the Next.js Command Line Interface (CLI) tools. | Prerequisites: API Reference | Topics: pages-router, api-reference, cli

        - [create-next-app CLI](/docs/pages/api-reference/cli/create-next-app) | Type: Reference | Lastmod: 2026-05-13 | Summary: Create Next.js apps using one command with the create-next-app CLI. | Prerequisites: CLI | Topics: pages-router, api-reference, cli

        - [next CLI](/docs/pages/api-reference/cli/next) | Type: Reference | Lastmod: 2026-05-13 | Summary: Learn how to run and build your application with the Next.js CLI. | Prerequisites: CLI | Topics: pages-router, api-reference, cli

    - [Adapters](/docs/pages/api-reference/adapters) | Type: Reference | Lastmod: 2026-05-13 | Summary: Build deployment adapters for Next.js platforms and infrastructure. | Prerequisites: API Reference | Topics: pages-router, api-reference, adapters

        - [Configuration](/docs/pages/api-reference/adapters/configuration) | Type: Reference | Lastmod: 2026-05-13 | Summary: Configure `adapterPath` or `NEXT_ADAPTER_PATH` to use a custom deployment adapter. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Creating an Adapter](/docs/pages/api-reference/adapters/creating-an-adapter) | Type: Reference | Lastmod: 2026-05-13 | Summary: Create an adapter module that implements the `NextAdapter` interface. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [API Reference](/docs/pages/api-reference/adapters/api-reference) | Type: Reference | Lastmod: 2026-05-13 | Summary: Reference for `modifyConfig` and `onBuildComplete` in the `NextAdapter` interface. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Testing Adapters](/docs/pages/api-reference/adapters/testing-adapters) | Type: Reference | Lastmod: 2026-05-13 | Summary: Validate adapters with the Next.js compatibility test harness and custom lifecycle scripts. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Routing with @next/routing](/docs/pages/api-reference/adapters/routing-with-next-routing) | Type: Reference | Lastmod: 2026-05-13 | Summary: Use `@next/routing` to apply Next.js route matching behavior in adapters. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Implementing PPR in an Adapter](/docs/pages/api-reference/adapters/implementing-ppr-in-an-adapter) | Type: Reference | Lastmod: 2026-05-13 | Summary: Implement Partial Prerendering support in an adapter using fallback output and cache hooks. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Runtime Integration](/docs/pages/api-reference/adapters/runtime-integration) | Type: Reference | Lastmod: 2026-05-13 | Summary: Understand how build-time adapters and runtime cache interfaces work together. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Invoking Entrypoints](/docs/pages/api-reference/adapters/invoking-entrypoints) | Type: Reference | Lastmod: 2026-05-13 | Summary: Invoke Node.js and Edge build entrypoints with adapter runtime context. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Output Types](/docs/pages/api-reference/adapters/output-types) | Type: Reference | Lastmod: 2026-05-13 | Summary: Reference for all build output types exposed to adapters. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Routing Information](/docs/pages/api-reference/adapters/routing-information) | Type: Reference | Lastmod: 2026-05-13 | Summary: Reference for routing phases and route fields exposed in `onBuildComplete`. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

        - [Use Cases](/docs/pages/api-reference/adapters/use-cases) | Type: Reference | Lastmod: 2026-05-13 | Summary: Common patterns and examples for deployment adapter implementations. | Prerequisites: Adapters | Topics: pages-router, api-reference, adapters

    - [Edge Runtime](/docs/pages/api-reference/edge) | Type: Reference | Lastmod: 2026-05-13 | Summary: API Reference for the Edge Runtime. | Prerequisites: API Reference | Topics: pages-router, api-reference, edge

    - [Turbopack](/docs/pages/api-reference/turbopack) | Type: Reference | Lastmod: 2026-05-13 | Summary: Turbopack is an incremental bundler optimized for JavaScript and TypeScript, written in Rust, and built into Next.js. | Prerequisites: API Reference | Topics: pages-router, api-reference, turbopack

## Architecture

- [Architecture](/docs/architecture) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: How Next.js Works | Topics: architecture

    - [Accessibility](/docs/architecture/accessibility) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: The built-in accessibility features of Next.js. | Prerequisites: Architecture | Topics: architecture, accessibility

    - [Fast Refresh](/docs/architecture/fast-refresh) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Fast Refresh is a hot module reloading experience that gives you instantaneous feedback on edits made to your React components. | Prerequisites: Architecture | Topics: architecture, fast-refresh

    - [Next.js Compiler](/docs/architecture/nextjs-compiler) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Next.js Compiler, written in Rust, which transforms and minifies your Next.js application. | Prerequisites: Architecture | Topics: architecture, nextjs-compiler

    - [Supported Browsers](/docs/architecture/supported-browsers) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Browser support and which JavaScript features are supported by Next.js. | Prerequisites: Architecture | Topics: architecture, supported-browsers

## Community

- [Community](/docs/community) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Get involved in the Next.js community. | Topics: community

    - [Contribution Guide](/docs/community/contribution-guide) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Learn how to contribute to Next.js Documentation | Prerequisites: Community | Topics: community, contribution-guide

    - [Rspack](/docs/community/rspack) | Type: Conceptual | Lastmod: 2026-05-13 | Summary: Use the `next-rspack` plugin to bundle your Next.js with Rspack. | Prerequisites: Community | Topics: community, rspack
