360 Secure SkillHub
360 安全技能中心

NextJS 16+ Complete Documentation

把 Next.js 16 完整文档（App Router、Pages Router、API 参考、架构与社区）以 mdx 形式内置于 references/，供按主题查阅，回答 Next.js 的功能、配置、缓存、路由、组件与部署迁移等开发问题。

leonaaardob
leonaaardob
热度 78.87
最近更新 2026-05-11 15:54:29
分类：开发依赖：读写文件应用场景：概念解释 / 研究 / 调试排错

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add lb-nextjs16-skill
Metadata
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 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.