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

Task	File to Read
Setup new project	`references/01-app/01-getting-started/installation.mdx`
Routing & layouts	`references/01-app/01-getting-started/layouts-and-pages.mdx`
Data fetching	`references/01-app/01-getting-started/data-fetching.mdx`
Server actions	`references/01-app/03-api-reference/server-actions.mdx` (if exists)
Middleware	Search `references/01-app/02-guides/` or API reference
Caching strategies	`references/01-app/02-guides/caching.mdx`
Environment variables	`references/01-app/02-guides/environment-variables.mdx`
Testing setup	`references/01-app/02-guides/testing/`
Deploy self-hosted	`references/01-app/02-guides/self-hosting.mdx`
Migrate from Vite	`references/01-app/02-guides/migrating/from-vite.mdx`
Migrate from CRA	`references/01-app/02-guides/migrating/from-create-react-app.mdx`
Upgrade to v16	`references/01-app/02-guides/upgrading/version-16.mdx`

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

Start with references/index.mdx for overview
For getting started: Read references/01-app/01-getting-started/
For specific topics: Read references/01-app/02-guides/<topic>.mdx
For API details: Search references/01-app/03-api-reference/
For legacy Pages Router: Use references/02-pages/

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

NextJS 16+ Complete Documentation