NextJS 16+ Complete Documentation

Complete Next.js 16 documentation in markdown format. Use when working with Next.js projects, building React applications, configuring routing, data fetching, rendering strategies, deployment, or migrating from other frameworks. Covers App Router, Pages Router, API routes, server components, server actions, caching, and all Next.js features.

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

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.