nextjs-stack

作为主参考文档，串联起完整推荐的 Next.js 16+ 技术栈：App Router (nextjs-16)、Prisma 7 (prisma-7)、Better Auth 1.7 (better-auth)、shadcn/ui CLI 4.21 (nextjs-shadcn)、TanStack Form (nextjs-tanstack-form)、Zustand (nextjs-zustand)、Tailwind CSS 4 和 next-intl 4.14 (nextjs-i18n)——为每一层指向相应的子技能，而不是重复其内容。

说明禁止使用的替代方案（用 NextAuth.js 替代 Better Auth、用 Pages Router 替代 App Router、用 React Hook Form 替代 TanStack Form、默认使用客户端组件而非服务端优先），并提供技术栈决策依据、SOLID 模块结构、跨部分集成点和项目引导方面的参考资料。不涵盖路由内部机制、缓存或 proxy.ts 等核心框架 API 细节——这些内容请查阅 nextjs-16。

Next.js 完整技术栈

整合现代 Next.js 开发所需的全部框架文档的主技能。

Agent 工作流（必须遵循）

在进行任何实现之前，并行启动 3 个 Agent，每个 Agent 调用都指定一个 name：

1. fuse-ai-pilot:explore-codebase - 分析项目结构和现有模式
2. fuse-ai-pilot:research-expert - 核实所有技术栈技术的最新文档
3. mcp__context7__query-docs - 检查集成兼容性

实现后，运行 fuse-ai-pilot:sniper 进行验证。

---

概述

适用场景

• 从零开始创建 Next.js 16 项目
• 需要完整的推荐技术栈
• 构建带有身份验证的生产级应用
• 实现表单、状态管理和 UI 组件
• 了解各部分如何协同工作

技术栈

层	技术	技能参考
框架	Next.js 16（App Router，稳定版 16.3）	nextjs-16
数据库 ORM	Prisma 7（稳定版 7.10；8.0 仅为 RC）	prisma-7
身份验证	Better Auth 1.7	better-auth
UI 组件	shadcn/ui CLI 4.21.0	nextjs-shadcn
表单	TanStack Form	nextjs-tanstack-form
状态管理	Zustand	nextjs-zustand
样式	Tailwind CSS 4	tailwindcss
国际化	next-intl 4.14	nextjs-i18n

---

禁止的模式

• NextAuth.js - 请改用 Better Auth
• Pages Router - 新项目请使用 App Router
• React Hook Form - 请使用 TanStack Form
• 默认使用客户端组件 - 优先使用服务端组件

---

参考资料

详细指南位于 references/ 中，以便快速浏览此文件——只加载任务所需的内容：

文件	加载时机…
references/stack-decisions.md	需要说明技术选型的理由时（Better Auth 与 NextAuth、Prisma 与 Drizzle、TanStack Form 与 RHF、Zustand 与 Redux、shadcn/ui 与 MUI）
references/solid-architecture.md	设置或审查项目的模块/文件夹结构时
references/integration-points.md	将技术栈中的两个部分连接起来时（身份验证+数据库、表单+UI、状态+RSC、国际化+路由）
references/quick-reference.md	查找特定功能由哪个子技能文件介绍时（App Router、Prisma schema、Better Auth OAuth，……）
references/best-practices.md	发布前进行最终审查时
references/getting-started.md	按步骤引导全新项目时

如需框架特定的详细信息，请直接查阅相应子技能：nextjs-16、prisma-7、better-auth、nextjs-shadcn、nextjs-tanstack-form、nextjs-zustand、nextjs-i18n、solid-nextjs。