Next.js Documentation (Canary)
Next.js is a React framework for building full-stack web applications. It provides Server Components, automatic code splitting, file-based routing, and built-in optimizations for production.
Navigation Guide
App Router (Recommended): references/01-app/ - The newer router with React Server Components support (220 files)
01-getting-started/ - Installation, project structure, core concepts
02-guides/ - Tutorials on authentication, caching, forms, data security
03-api-reference/ - Directives, components, file conventions, functions, config
Pages Router (Legacy): references/02-pages/ - The original Next.js router (148 files)
01-getting-started/ - Setup and migration guides
02-guides/ - Pages Router-specific tutorials
03-building-your-application/ - Routing, rendering, data fetching
04-api-reference/ - Pages Router API documentation
Architecture: references/03-architecture/ - How Next.js works under the hood (5 files)
Community: references/04-community/ - Contribution guidelines (2 files)
Key Entry Points
| Task |
Start Here |
| New to Next.js |
references/01-app/01-getting-started/01-installation.mdx |
| Project structure |
references/01-app/01-getting-started/02-project-structure.mdx |
| Layouts and pages |
references/01-app/01-getting-started/03-layouts-and-pages.mdx |
| Server vs Client Components |
references/01-app/01-getting-started/05-server-and-client-components.mdx |
| Data fetching |
references/01-app/01-getting-started/07-fetching-data.mdx |
| Caching |
references/01-app/02-guides/caching.mdx |
| Authentication |
references/01-app/02-guides/authentication.mdx |
| Forms |
references/01-app/02-guides/forms.mdx |
| API reference |
references/01-app/03-api-reference/index.mdx |
| Components (Image, Link, etc.) |
references/01-app/03-api-reference/02-components/ |
| Configuration |
references/01-app/03-api-reference/05-config/ |
| Pages Router setup |
references/02-pages/01-getting-started/ |
When to use
Use this skill when the user asks about:
- Next.js App Router or Pages Router
- Server Components and Client Components
- File-based routing, layouts, and navigation
- Data fetching and caching strategies
- Rendering (SSR, SSG, ISR, streaming)
- Middleware and API routes
- Image, Font, Link, Script optimization
- next.config.js configuration
- Deployment and production builds
How to find information
- First, read
references/STRUCTURE.md to see all 377 documentation files organized by directory
- Use the Navigation Guide above to identify the relevant section
- Start with the Key Entry Points for common tasks
- For App Router: explore
references/01-app/
- For Pages Router: explore
references/02-pages/
- For API details: check
03-api-reference/ within each router section
STRUCTURE.md contains a complete file listing - always check it first when searching for specific topics.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: nextjs-canary-docs3description: Local Next.js documentation reference (canary branch). Use when asked about Next.js features, App Router, Server Components, routing, data fetching, rendering, caching, styling, optimizations, configuration, or Next.js APIs. Use when this capability is needed.4---56# Next.js Documentation (Canary)78Next.js is a React framework for building full-stack web applications. It provides Server Components, automatic code splitting, file-based routing, and built-in optimizations for production.910## Navigation Guide1112**App Router (Recommended):** `references/01-app/` - The newer router with React Server Components support (220 files)1314- `01-getting-started/` - Installation, project structure, core concepts15- `02-guides/` - Tutorials on authentication, caching, forms, data security16- `03-api-reference/` - Directives, components, file conventions, functions, config1718**Pages Router (Legacy):** `references/02-pages/` - The original Next.js router (148 files)1920- `01-getting-started/` - Setup and migration guides21- `02-guides/` - Pages Router-specific tutorials22- `03-building-your-application/` - Routing, rendering, data fetching23- `04-api-reference/` - Pages Router API documentation2425**Architecture:** `references/03-architecture/` - How Next.js works under the hood (5 files)2627**Community:** `references/04-community/` - Contribution guidelines (2 files)2829## Key Entry Points3031| Task | Start Here |32|------|------------|33| New to Next.js | `references/01-app/01-getting-started/01-installation.mdx` |34| Project structure | `references/01-app/01-getting-started/02-project-structure.mdx` |35| Layouts and pages | `references/01-app/01-getting-started/03-layouts-and-pages.mdx` |36| Server vs Client Components | `references/01-app/01-getting-started/05-server-and-client-components.mdx` |37| Data fetching | `references/01-app/01-getting-started/07-fetching-data.mdx` |38| Caching | `references/01-app/02-guides/caching.mdx` |39| Authentication | `references/01-app/02-guides/authentication.mdx` |40| Forms | `references/01-app/02-guides/forms.mdx` |41| API reference | `references/01-app/03-api-reference/index.mdx` |42| Components (Image, Link, etc.) | `references/01-app/03-api-reference/02-components/` |43| Configuration | `references/01-app/03-api-reference/05-config/` |44| Pages Router setup | `references/02-pages/01-getting-started/` |4546## When to use4748Use this skill when the user asks about:49- Next.js App Router or Pages Router50- Server Components and Client Components51- File-based routing, layouts, and navigation52- Data fetching and caching strategies53- Rendering (SSR, SSG, ISR, streaming)54- Middleware and API routes55- Image, Font, Link, Script optimization56- next.config.js configuration57- Deployment and production builds5859## How to find information60611. **First**, read `references/STRUCTURE.md` to see all 377 documentation files organized by directory622. Use the Navigation Guide above to identify the relevant section633. Start with the Key Entry Points for common tasks644. For App Router: explore `references/01-app/`655. For Pages Router: explore `references/02-pages/`666. For API details: check `03-api-reference/` within each router section6768**STRUCTURE.md contains a complete file listing - always check it first when searching for specific topics.**6970---71> Converted and distributed by [TomeVault](https://tomevault.io/claim/jasonz-ncc42) — claim your Tome and manage your conversions.72<!-- tomevault:4.0:skill_md:2026-04-11 -->