---
title: Guides
description: Learn how to implement common patterns and real-world use cases using Next.js
url: "https://nextjs.org/docs/app/guides"
docs_index: /docs/llms.txt
lastUpdated: 2025-06-11
---

> For an index of all documentation, see [/docs/llms.txt](/docs/llms.txt).

- [Adopting Partial Prefetching](/docs/app/guides/adopting-partial-prefetching): Learn how to enable Partial Prefetching and what changes for \`\<Link>\`.
- [AI Coding Agents](/docs/app/guides/ai-agents): Learn how Next.js helps AI coding agents use current framework guidance, inspect applications, verify changes, and report issues.
- [Analytics](/docs/app/guides/analytics): Measure and track page performance using Next.js Speed Insights
- [Authentication with Cache Components](/docs/app/guides/authentication-with-cache-components): Learn how to read the user session, show authenticated UI without slowing down the page, and cache data derived from the session when Cache Components is enabled.
- [Authentication](/docs/app/guides/authentication): Learn how to implement authentication in your Next.js application.
- [Backend for Frontend](/docs/app/guides/backend-for-frontend): Learn how to use Next.js as a backend framework
- [Building](/docs/app/guides/building): Learn what happens when you run next build and how to read the build output.
- [Caching (Previous Model)](/docs/app/guides/caching-without-cache-components): Learn how to cache and revalidate data using fetch options, unstable\_cache, and route segment configs for projects not using Cache Components.
- [CDN Caching](/docs/app/guides/cdn-caching): Learn how CDN caching works with Next.js, including what works today, cache variability, and the direction toward pathname-based cache keying.
- [CI Build Caching](/docs/app/guides/ci-build-caching): Learn how to configure CI to cache Next.js builds
- [Client-side data fetching](/docs/app/guides/client-side-data-fetching): Fetch data in Client Components with a data-fetching library, optionally provide initial data from a Server Component, and coordinate server and client caches.
- [Content Security Policy](/docs/app/guides/content-security-policy): Learn how to set a Content Security Policy (CSP) for your Next.js application.
- [CSS-in-JS](/docs/app/guides/css-in-js): Use CSS-in-JS libraries with Next.js
- [Custom Server](/docs/app/guides/custom-server): Start a Next.js app programmatically using a custom server.
- [Data Security](/docs/app/guides/data-security): Learn the built-in data security features in Next.js and learn best practices for protecting your application's data.
- [Debugging](/docs/app/guides/debugging): Learn how to debug your Next.js application with VS Code, Chrome DevTools, or Firefox DevTools.
- [Deploying to Platforms](/docs/app/guides/deploying-to-platforms): Understand which Next.js features require specific platform capabilities and how to choose the right deployment target.
- [Draft Mode](/docs/app/guides/draft-mode): Bypass Next.js caching for a request so editors can preview unpublished content from a headless CMS.
- [Environment Variables](/docs/app/guides/environment-variables): Learn to add and access environment variables in your Next.js application.
- [Forms](/docs/app/guides/forms): Learn how to create forms in Next.js with React Server Actions.
- [How Revalidation Works](/docs/app/guides/how-revalidation-works): A deep dive into how Next.js revalidates cached content, including the tag system, cache consistency, and multi-instance coordination.
- [ISR with Cache Components](/docs/app/guides/incremental-static-regeneration-cache-components): Learn how to prerender a subset of dynamic routes, serve App Shells for the rest, and upgrade them after the first visit.
- [ISR](/docs/app/guides/incremental-static-regeneration): Learn how to create or update static pages at runtime with Incremental Static Regeneration.
- [Instant navigation](/docs/app/guides/instant-navigation): Learn how to structure your app to prefetch and prerender more content, providing instant page loads and client navigations.
- [Instrumentation](/docs/app/guides/instrumentation): Learn how to use instrumentation to run code at server startup in your Next.js app
- [Interactive apps](/docs/app/guides/interactive-apps): Learn how to build responsive interactions with Server Functions, transitions, optimistic UI, and pending feedback.
- [Internationalization](/docs/app/guides/internationalization): Add support for multiple languages with internationalized routing and localized content.
- [JSON-LD](/docs/app/guides/json-ld): Learn how to add JSON-LD to your Next.js application to describe your content to search engines and AI.
- [Keeping pages static](/docs/app/guides/keeping-pages-static): Keep selected route output static as your app changes.
- [Lazy Loading](/docs/app/guides/lazy-loading): Lazy load imported libraries and React Components to improve your application's loading performance.
- [Development Environment](/docs/app/guides/local-development): Learn how to optimize your local development environment with Next.js.
- [Next.js MCP Server](/docs/app/guides/mcp): Learn how to give coding agents access to your running Next.js app through the built-in MCP endpoint.
- [MDX](/docs/app/guides/mdx): Learn how to configure MDX and use it in your Next.js apps.
- [Memory Usage](/docs/app/guides/memory-usage): Optimize memory used by your application in development and production.
- [Migrating](/docs/app/guides/migrating): Learn how to migrate from popular frameworks to Next.js
- [Migrating to Cache Components](/docs/app/guides/migrating-to-cache-components): Learn how to migrate from route segment configs to Cache Components in Next.js.
- [Multi-tenant](/docs/app/guides/multi-tenant): Learn how to build multi-tenant apps with the App Router.
- [Multi-zones](/docs/app/guides/multi-zones): Learn how to build micro-frontends using Next.js Multi-Zones to deploy multiple Next.js apps under a single domain.
- [Offline support](/docs/app/guides/offline-support): How a Next.js app can recover when the network drops mid-fetch or mid-Server Action, and how to communicate that state to the user.
- [OpenTelemetry](/docs/app/guides/open-telemetry): Learn how to instrument your Next.js app with OpenTelemetry.
- [Optimizing prefetching](/docs/app/guides/optimizing-prefetching): Resolve per-link URL data, include session data in the App Shell, or defer expensive work to a later navigation stage.
- [Optimizing the static shell](/docs/app/guides/optimizing-the-static-shell): Learn how to use Cache Components to keep layouts, navigation, and useful loading states available while request-time content streams.
- [Package Bundling](/docs/app/guides/package-bundling): 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.
- [PPR Platform Guide](/docs/app/guides/ppr-platform-guide): A guide for platform engineers on implementing PPR support, from basic origin rendering to optimized CDN integration.
- [Prefetching](/docs/app/guides/prefetching): Learn how to configure prefetching in Next.js
- [Preserving UI state](/docs/app/guides/preserving-ui-state): Learn how React's Activity component preserves UI state across navigations in Next.js and how to control what resets.
- [Preventing Flash](/docs/app/guides/preventing-flash-before-hydration): Learn how to correct server-rendered content before the browser paints, avoiding visible flash when the page hydrates.
- [Production](/docs/app/guides/production-checklist): Recommendations to ensure the best performance and user experience before taking your Next.js application to production.
- [PWAs](/docs/app/guides/progressive-web-apps): Learn how to build a Progressive Web Application (PWA) with Next.js.
- [Public pages](/docs/app/guides/public-static-pages): 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.
- [Redirecting](/docs/app/guides/redirecting): Learn the different ways to handle redirects in Next.js.
- [Rendering Philosophy](/docs/app/guides/rendering-philosophy): Learn how Next.js treats static and dynamic rendering as a spectrum at the component level, and what this means for deployment.
- [Sass](/docs/app/guides/sass): Style your Next.js application using Sass.
- [Scripts](/docs/app/guides/scripts): Optimize 3rd party scripts with the built-in Script component.
- [Self-Hosting](/docs/app/guides/self-hosting): Learn how to self-host your Next.js application on a Node.js server, Docker image, or static HTML files (static exports).
- [Server Actions](/docs/app/guides/server-actions): How Server Actions work in Next.js, including the single-roundtrip response model, sequential dispatch, security, and caching integration.
- [Server and Client Boundary](/docs/app/guides/server-and-client-boundary): Learn where Server and Client Components run in the App Router and how the boundary between them works.
- [SPAs](/docs/app/guides/single-page-applications): Next.js fully supports building Single-Page Applications (SPAs).
- [Static Exports](/docs/app/guides/static-exports): Next.js enables starting as a static site or Single-Page Application (SPA), then later optionally upgrading to use features that require a server.
- [Streaming](/docs/app/guides/streaming): Learn how streaming works in Next.js and how to use it to progressively render UI as data becomes available.
- [Tailwind CSS v3](/docs/app/guides/tailwind-v3-css): Style your Next.js Application using Tailwind CSS v3 for broader browser support.
- [Testing](/docs/app/guides/testing): Learn how to set up Next.js with four commonly used testing tools — Cypress, Playwright, Vitest, and Jest.
- [Third Party Libraries](/docs/app/guides/third-party-libraries): Optimize the performance of third-party libraries in your application with the \`@next/third-parties\` package.
- [Upgrading](/docs/app/guides/upgrading): Learn how to upgrade to the latest versions of Next.js.
- [Videos](/docs/app/guides/videos): Recommendations and best practices for optimizing videos in your Next.js application.
- [View transitions](/docs/app/guides/view-transitions): Learn how to use view transitions to communicate meaning during navigation, loading, and content changes in a Next.js app.

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/docs/llms.txt](/docs/llms.txt)