NextJS 16+ Complete Documentation

---

name: nextjs description: 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/.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.