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.
Complete Next.js 16 documentation embedded in markdown. Read from references/ to answer questions about Next.js features, configuration, and best practices.
All documentation is in references/ organized by topic:
Modern Next.js architecture with React Server Components.
Getting Started:
references/01-app/01-getting-started/installation.mdx - Setup new projectreferences/01-app/01-getting-started/project-structure.mdx - File conventionsreferences/01-app/01-getting-started/layouts-and-pages.mdx - Routing basicsreferences/01-app/01-getting-started/data-fetching.mdx - Server data loadingreferences/01-app/01-getting-started/css.mdx - Styling optionsGuides:
references/01-app/02-guides/authentication.mdx - Auth patternsreferences/01-app/02-guides/caching.mdx - Cache strategiesreferences/01-app/02-guides/environment-variables.mdx - Env configreferences/01-app/02-guides/forms.mdx - Form handlingreferences/01-app/02-guides/testing/ - Jest, Playwright, Vitest, Cypressreferences/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 deploymentreferences/01-app/02-guides/static-exports.mdx - Static HTML exportreferences/01-app/02-guides/progressive-web-apps.mdx - PWA setupAPI Reference:
references/01-app/03-api-reference/ - Complete API docs (components, functions, config)Legacy Next.js architecture (still supported).
references/02-pages/01-guides/ - Pages Router guidesreferences/02-pages/02-api-reference/ - Pages API referencereferences/03-architecture/nextjs-compiler.mdx - SWC compilerreferences/03-architecture/fast-refresh.mdx - Hot reloadreferences/03-architecture/supported-browsers.mdx - Browser supportreferences/03-architecture/accessibility.mdx - A11y featuresreferences/04-community/contribution-guide.mdx - Contributing to Next.jsreferences/04-community/rspack.mdx - Experimental Rspack support| 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 |
references/index.mdx for overviewreferences/01-app/01-getting-started/references/01-app/02-guides/<topic>.mdxreferences/01-app/03-api-reference/references/02-pages/All files are .mdx (Markdown + JSX) but readable as plain markdown.