# blade47/next.js

> AI-generated documentation for github.com/blade47/next.js

## Technical docs: Architecture Overview

- [System Overview](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/getting-started/system-overview): Next.js delivers a comprehensive full-stack framework architecture designed to bridge server-side request processing, multi-paradigm rendering engines, and client-side hydration runtimes. By establ...
- [Quick Start](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/getting-started/quick-start): Next.js provides a robust command-line interface and tooling ecosystem designed to streamline project initialization, template configuration, development server bootstrapping, and diagnostic inspec...
- [Project Structure](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/getting-started/project-structure): The repository follows a structured monorepo topology orchestrated via pnpm workspaces and Turborepo task pipelines, establishing clear boundaries between core packages, applications, benchmarks, a...
- [Monorepo Workspace](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/getting-started/monorepo-workspace): The Monorepo Workspace provides the foundational architecture for developing, testing, and building Next.js and its associated tooling across multiple integrated packages and standalone application...

## Technical docs: Server Runtime

- [Server Request Lifecycle](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/server-runtime/server-request-lifecycle): The server request lifecycle governs how incoming HTTP connections are received, abstracted, processed, and rendered across different runtime environments. It coordinates server initialization, uni...
- [Routing and Normalization](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/server-runtime/routing-and-normalization): Routing and Normalization in Next.js serves as the foundational canonicalization engine responsible for parsing, validating, and transforming incoming HTTP request URLs, client transitions, and int...
- [Route Matching](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/server-runtime/route-matching): Route matching in Next.js is the foundational mechanism responsible for mapping incoming HTTP requests or client-side navigation paths to the correct App Router (app/) or Pages Router (pages/) exec...
- [Async Request Context](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/server-runtime/async-request-context): Async Request Context serves as the underlying execution tracking and scoping mechanism in Next.js, managing asynchronous data flow across server rendering passes, server actions, route handlers, a...
- [Stream Handling](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/server-runtime/stream-handling): Stream handling in Next.js bridges the gap between heterogeneous rendering environments—supporting Node.js Readable/PassThrough streams, standard Web ReadableStream instances, and incoming HTTP bod...

## Technical docs: Rendering Pipeline

- [App Server Rendering](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/app-router-rendering/app-server-rendering): App Server Rendering coordinates the server-side generation, request processing, and React Server Component (RSC) streaming lifecycle for Next.js App Router applications. It bridges base server req...
- [Staged Dynamic Rendering](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/app-router-rendering/staged-dynamic-rendering): Staged Dynamic Rendering is an advanced rendering architecture in Next.js that structures server-side rendering into discrete lifecycle stages—ranging from early static shell generation through run...
- [Server Actions](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/app-router-rendering/server-actions): Server Actions enable asynchronous functions defined on the server to be securely invoked from client components and form submissions, bridging client-side interactions and server-side mutations wi...
- [Route Handlers](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/app-router-rendering/route-handlers): Route Handlers in Next.js manage backend data endpoints and request dispatching across distinct execution runtimes and application models. They bridge incoming HTTP traffic with userland route logi...
- [Metadata Generation](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/app-router-rendering/metadata-generation): Metadata generation in Next.js provides a comprehensive, declarative system for defining, inheriting, and resolving document metadata and viewport configurations across the App Router hierarchy. By...
- [Instant Validation](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/app-router-rendering/instant-validation): Instant validation provides a compile-time and development-time verification mechanism for Next.js App Router applications to ensure that routes configured with instant navigation or static optimiz...

## Technical docs: Client Navigation

- [Client App Router](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/client-routing/client-app-router): The Client App Router subsystem serves as the core client-side orchestration engine for Next.js App Router applications. It manages the lifecycle of React Server Component (RSC) payload ingestion, ...
- [Router State Reducer](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/client-routing/router-state-reducer): The router state reducer manages asynchronous client-side navigations, state patches, and history traversals for the Next.js App Router by maintaining a centralized action queue and dispatch switch...
- [Client Segment Cache](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/client-routing/client-segment-cache): The Client Segment Cache is a specialized client-side data management system in Next.js designed to store and serve pre-fetched React Server Component (RSC) route trees and individual page segments...
- [Prefetching and PPR](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/client-routing/prefetching-and-ppr): Partial Prerendering (PPR) and prefetching form the architectural backbone of Next.js client-side navigation, optimizing application responsiveness by separating static shells from dynamic data str...
- [Navigation Boundaries](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/client-routing/navigation-boundaries): Navigation Boundaries form the core runtime error-interception and fallback mechanism in Next.js App Router. During client-side navigation, server rendering, or component tree execution, React rend...

## Technical docs: Caching and Export

- [Incremental Cache](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/caching-and-export/incremental-cache): The Incremental Cache powers Next.js rendering optimization and incremental static regeneration (ISR) by persisting and retrieving prerendered routes, data fetches, and function outputs across requ...
- [Function Caching](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/caching-and-export/function-caching): Function caching provides robust execution wrapping, key encoding, and response streaming capabilities for 'use cache' operations within the App Router architecture. It addresses challenges related...
- [Response Cache](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/caching-and-export/response-cache): The Response Cache subsystem is a server-level architectural component responsible for coordinating, batching, keying, and retaining rendered application payloads and HTML results across requests. ...
- [Static Export](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/caching-and-export/static-export): Static Export is a core Next.js build subsystem responsible for translating an application's compiled build artifacts into fully pre-rendered static assets, HTML pages, Server Components payloads (...

## Technical docs: Edge Sandbox

- [Edge Sandbox Context](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/edge-and-sandbox/edge-sandbox-context): The Edge Sandbox Context subsystem provides a controlled virtual machine execution environment for running Edge Runtime functions, middleware, and API routes within Next.js. Because Edge functions ...
- [Web Spec Adapters](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/edge-and-sandbox/web-spec-adapters): Web Spec Adapters form the bridging layer in Next.js that unifies native Node.js HTTP primitives (IncomingMessage, ServerResponse) and Web Standard Fetch API primitives (Request, Response, Headers,...
- [Middleware Execution](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/edge-and-sandbox/middleware-execution): Middleware execution in Next.js governs how incoming HTTP requests are intercepted, evaluated, and transformed before reaching core page handlers or router logic. By running custom code at the edge...

## Technical docs: Development Tools

- [Dev Server and HMR](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/development-and-diagnostics/dev-server-and-hmr): The Next.js development server and Hot Module Replacement (HMR) subsystem bridges local source files with browser-side execution, handling compilation orchestration, dynamic route resolution, and r...
- [Dev Error Overlay](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/development-and-diagnostics/dev-error-overlay): The Dev Error Overlay is Next.js's browser-based diagnostic interface designed to capture, transform, and render runtime errors, unhandled rejections, console errors, and hydration mismatches durin...
- [DevTools Panel](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/development-and-diagnostics/devtools-panel): The DevTools Panel provides an interactive, in-browser development overlay and command center designed to inspect, diagnose, and configure Next.js applications during local development. It surfaces...
- [MCP Tool Integration](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/development-and-diagnostics/mcp-tool-integration): The Next.js Model Context Protocol (MCP) tool integration provides a standardized interface for AI agents and external clients to interact directly with a running Next.js development server and bui...
- [Bundler Integration](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/development-and-diagnostics/bundler-integration): Next.js bundler integration coordinates compilation across multiple underlying bundler backends—specifically supporting Turbopack, Webpack, and Rspack. It manages CLI argument parsing, configuratio...
- [React Refresh Support](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/development-and-diagnostics/react-refresh-support): React Refresh Support (commonly known as Fast Refresh) in Next.js provides instant feedback during local development by updating React components in the browser without losing component state. The ...

## Technical docs: Build and Configuration

- [Configuration Loading](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/build-and-config/configuration-loading): Configuration loading in Next.js is responsible for discovering, transpiling, validating, and normalizing project configuration files (next.config.js, next.config.mjs, next.config.ts, and next.conf...
- [TypeScript Plugin](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/build-and-config/typescript-plugin): The Next.js TypeScript language service plugin enhances the development experience within the app directory by providing rich intellisense, inline documentation, and semantic diagnostics for entry ...
- [CLI Commands](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/build-and-config/cli-commands): The Next.js Command-Line Interface (CLI) serves as the primary orchestration and entry point for building, developing, serving, and diagnosing Next.js applications. Architected around Commander.js ...
- [Telemetry and Diagnostics](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/build-and-config/telemetry-and-diagnostics): Next.js incorporates a unified telemetry and diagnostics subsystem designed to collect anonymous build and development usage metrics, track process memory performance, record garbage collection sta...

## Technical docs: Ecosystem Packages

- [Create Next App](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/ecosystem-packages/create-next-app): Create Next App is the official command-line bootstrapping tool designed to set up new Next.js applications quickly and reliably. It automates the entire project initialization lifecycle, eliminati...
- [Codemod Transformations](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/ecosystem-packages/codemod-transformations): Codemod transformations automate the upgrade process for Next.js applications by programmatically modifying source code, configuration files, and project structures across major version boundaries....
- [Font Optimization](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/ecosystem-packages/font-optimization): Font Optimization (next/font) is a built-in Next.js subsystem engineered to eliminate external network requests for web fonts at runtime while automatically preventing Cumulative Layout Shift (CLS)...
- [ESLint Rules](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/ecosystem-packages/eslint-rules): The @next/eslint-plugin-next package provides custom static analysis rules designed specifically for Next.js applications. It enforces performance best practices, proper layout structures, and corr...
- [Third Party Components](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/ecosystem-packages/third-party-components): The @next/third-parties package provides a collection of performance-optimized components and utilities designed to seamlessly integrate popular third-party external libraries into Next.js applicat...
- [Bundle Analyzer](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/ecosystem-packages/bundle-analyzer): The Bundle Analyzer provides an interactive web application and command-line tool suite for inspecting, visualizing, and auditing Next.js application bundle compositions. By parsing structured bina...
- [Performance Benchmarking](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/ecosystem-packages/performance-benchmarking): Performance benchmarking provides rigorous automated tooling to measure, track, and compare the developer workflow speed and bundler efficiency of Next.js and Turbopack. It solves the core problem ...

## Technical docs: Testing Infrastructure

- [Test Runners](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/testing-infrastructure/test-runners): Test Runners in the Next.js repository encompass repository-level execution scripts, Jest configurations, CLI integration wrappers, and evaluation harness infrastructure designed to validate Webpac...
- [Server Testing Utilities](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/testing-infrastructure/server-testing-utilities): Server Testing Utilities provide experimental testing APIs and primitives designed to evaluate and verify Next.js server behavior—such as custom configuration routes and middleware matching rules—d...

## Technical docs: How It Works

- [Client Change Subscription Flow](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/technical/how-it-works/client-change-subscription-flow): The SubscribeToClientChanges to RemoveFreeCallWrapper execution flow handles real-time updates and diagnostic message processing between Turbopack and the Next.js development server. When code chan...

## User guide: Getting Started

- [Installation and Setup](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/getting-started/installation-and-setup): Setting up a new Next.js project is quick and straightforward. You can create a fully configured project automatically using our interactive setup tool, or you can build one manually from scratch. ...
- [Project Structure Overview](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/getting-started/project-structure-overview): The Next.js App Router uses a file-system routing mechanism where folders and special files define your application's routes, layouts, and user interface boundaries. Organizing your project structu...

## User guide: Core Concepts

- [Routing and Navigation](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/core-concepts/routing-and-navigation): The routing and navigation system allows you to define application pages, create nested layouts, handle route requests, and move between different routes seamlessly. By organizing files and folders...
- [Server Client Components](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/core-concepts/server-client-components): Choosing between React Server Components and Client Components is a key part of building web applications that load quickly and remain responsive. By default, components in your application are Ser...
- [Data Fetching Mutations](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/core-concepts/data-fetching-mutations): Data Fetching Mutations let you retrieve data directly on the server, stream dynamic content seamlessly to users, and trigger secure data updates using Server Actions.
- [Caching and Revalidation](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/core-concepts/caching-and-revalidation): Caching and revalidation help your application load instantly by storing the results of expensive operations, database queries, and page renders. Instead of recalculating data on every single reque...

## User guide: How-To Guides

- [Styling and Assets](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/how-to-guides/styling-and-assets): Styling your application involves configuring global styles, utilizing utility-first CSS frameworks like Tailwind, loading fonts, and managing static assets such as images. You can combine traditio...
- [Forms and Mutations](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/how-to-guides/forms-and-mutations): Interactive forms and mutations allow users to send data back to the server to update application state, save records, or perform actions. Next.js provides a specialized <Form> component and server...
- [Authentication and Security](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/how-to-guides/authentication-and-security): Implementing robust authentication and security practices protects user accounts, private routes, and sensitive application data. This guide covers how to handle login flows using cookies and serve...
- [Deployment and Hosting](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/how-to-guides/deployment-and-hosting): Deploying a production-ready Next.js application involves creating an optimized build and hosting it on a cloud platform or self-hosted environment. Next.js provides built-in tools to prepare your ...

## User guide: Configuration

- [Environment and Configuration](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/configuration/environment-and-configuration): Managing runtime settings, customizing project options, and handling environment variables are crucial tasks when building applications. This guide covers how to customize your project settings usi...
- [Testing Your Application](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/configuration/testing-your-application): Testing your Next.js application ensures your features work reliably across different environments and build setups. Next.js provides built-in tools and configuration support for automated testing,...

## User guide: Troubleshooting

- [Error Handling Debugging](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/troubleshooting/error-handling-debugging): The error handling and debugging system helps you capture runtime exceptions, manage not-found or access-restricted states, and resolve rendering or hydration discrepancies. During development, err...
- [Upgrading and Migration](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/guide/troubleshooting/upgrading-and-migration): Keeping your Next.js application up-to-date ensures you have access to the latest performance improvements, security patches, and new features like the App Router, Turbopack, and React updates. Nex...

## Optional

- [Full Documentation](https://www.doc0.dev/docs/8f4009b0-65bd-4480-9b00-e201f0914bb3/llms-full.txt): Complete documentation content in a single file