SuperAPI AI 工具集

opinionated-nextjs-patterns

前端与建站

查看项目

更新于 10-16 03:46

技能介绍

用途:这是一套针对 Next.js 16(App Router)的、带明确立场的架构规则集,适合按同一套约定编写新代码、审查 PR、重构、设计功能以及新人理解现有代码结构。共 50 条规则,按执行生命周期影响排序,后端原则上无关,但以 Supabase 作为具体示例。

主要能力按优先级分为 8 类:授权与数据层访问(auth-,关键)、多租户(tenant-,关键,仅 SaaS 可选)、请求边界代理(proxy-,高)、服务端数据加载(server-,高)、变更:Action 与 Route Handler(mutate-,高)、客户端/服务端边界(client-,中高)、架构与服务(arch-,中)、表单与 UI 约定(ui-,中)。例如在数据层授权、用 requireUser() 集中认证、用 server-only 标记特权模块;用 React cache() 包装每请求加载器、用 Promise.all 并行加载;变更走类型化 action client,Zod schema 独立文件,写入后 revalidatePath()。结构为 Turbo monorepo,含自有的 @app/* 包,基于 next-safe-action、@supabase/ssr、@tanstack/react-query、react-hook-form + zod、shadcn/ui、next-intl、pino 等库,而非内置 starter kit。

使用方式:按需阅读 references 下的单条参考文件,包含详细说明与代码示例;_sections.md 说明分类结构与影响级别;assets/templates/_template.md 用于新增规则;AGENTS.md 为自动生成的目录。

限制:资料未提供安装命令、收费与价格信息;具体命令与完整代码示例需查看对应参考文件,暂未提供。