NextJS 16+ Complete Documentation

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.