Introduction
# 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.