Next.js Documentation (v16.2.0-canary.30)

Complete Next.js 16 documentation embedded in markdown. Read from references/ to answer questions about Next.js features, configuration, and best practices.

Documentation Structure

All documentation is in references/ organized by topic:

Core Documentation

App Router (references/01-app/)

Modern Next.js architecture with React Server Components.

Getting Started:

• references/01-app/01-getting-started/installation.mdx - Setup new project

• references/01-app/01-getting-started/project-structure.mdx - File conventions

• references/01-app/01-getting-started/layouts-and-pages.mdx - Routing basics

• references/01-app/01-getting-started/data-fetching.mdx - Server data loading

• references/01-app/01-getting-started/css.mdx - Styling options

Guides:

• references/01-app/02-guides/authentication.mdx - Auth patterns

• references/01-app/02-guides/caching.mdx - Cache strategies

• references/01-app/02-guides/environment-variables.mdx - Env config

• references/01-app/02-guides/forms.mdx - Form handling

• references/01-app/02-guides/testing/ - Jest, Playwright, Vitest, Cypress

• references/01-app/02-guides/migrating/ - Migration guides (Vite, CRA, Pages → App)

• references/01-app/02-guides/upgrading/ - Version upgrade guides (14, 15, 16)

• references/01-app/02-guides/self-hosting.mdx - Self-hosted deployment

• references/01-app/02-guides/static-exports.mdx - Static HTML export

• references/01-app/02-guides/progressive-web-apps.mdx - PWA setup

API Reference:

• references/01-app/03-api-reference/ - Complete API docs (components, functions, config)

Pages Router (references/02-pages/)

Legacy Next.js architecture (still supported).

• references/02-pages/01-guides/ - Pages Router guides

• references/02-pages/02-api-reference/ - Pages API reference

Architecture (references/03-architecture/)

• references/03-architecture/nextjs-compiler.mdx - SWC compiler

• references/03-architecture/fast-refresh.mdx - Hot reload

• references/03-architecture/supported-browsers.mdx - Browser support

• references/03-architecture/accessibility.mdx - A11y features

Community (references/04-community/)

• references/04-community/contribution-guide.mdx - Contributing to Next.js

• references/04-community/rspack.mdx - Experimental Rspack support

Quick Reference

Common Tasks

When to Use This Skill

• User asks about Next.js features, configuration, or best practices

• Working on a Next.js project and need API reference

• Debugging Next.js behavior (caching, rendering, routing)

• Planning architecture (SSR vs SSG vs ISR)

• Migration questions (from other frameworks or older Next.js versions)

How to Navigate

1. Start with references/index.mdx for overview

2. For getting started: Read references/01-app/01-getting-started/

3. For specific topics: Read references/01-app/02-guides/<topic>.mdx

4. For API details: Search references/01-app/03-api-reference/

5. For legacy Pages Router: Use references/02-pages/

All files are .mdx (Markdown + JSX) but readable as plain markdown.