| 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 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 options
Guides:
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 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 guidesreferences/02-pages/02-api-reference/ - Pages API reference
Architecture (references/03-architecture/)
references/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 features
Community (references/04-community/)
references/04-community/contribution-guide.mdx - Contributing to Next.jsreferences/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
- Start with
references/index.mdx for overview
- For getting started: Read
references/01-app/01-getting-started/
- For specific topics: Read
references/01-app/02-guides/<topic>.mdx
- For API details: Search
references/01-app/03-api-reference/
- For legacy Pages Router: Use
references/02-pages/
All files are .mdx (Markdown + JSX) but readable as plain markdown.
