SuperAPI AI 工具集

next-forge

前端与建站

查看项目

更新于 10-15 20:08

技能介绍

用途:next-forge 是用于构建 Next.js SaaS 应用的生产级 Turborepo 模板,提供 monorepo 结构,包含多个可部署应用与共享包,并集成认证、数据库、支付、邮件、CMS、分析、可观测性、安全等能力。

主要能力:仓库分为 apps 与 packages。apps 含 app(3000,主认证 SaaS 应用)、web(3001,营销站含 CMS 与 SEO)、api(3002,用于 webhook 和 cron 的无服务器 API)、email(3003,React Email 预览)、docs(3004,Mintlify 文档)、storybook(6006,设计系统组件)、studio(3005,Prisma Studio)。核心包包括 auth、database、payments、email、cms、design-system、analytics、observability、security、storage、seo、feature-flags、internationalization、webhooks、cron、notifications、collaboration、ai、rate-limit 等,以 @repo/<package-name> 导入。

使用方式:用 npx next-forge@latest init 初始化,CLI 会提示项目名和包管理器(bun、npm、yarn、pnpm)。随后在 packages/database/.env 设置 DATABASE_URL(推荐 Neon),运行 bun run migrate 迁移,按需在相应 .env.local 添加可选集成密钥,再用 bun run dev 启动。常用命令:bun run dev(全部)、bun dev --filter app(单应用)、修改 schema.prisma 后 bun run migrate、npx shadcn@latest add [component] -c packages/design-system、bun run bump-ui、bun run lint、bun run format、bun run test、bun run build、bun run analyze。部署 Vercel 时为 app、web、api 各建项目并指向 /apps/ 下对应目录,按项目配置环境变量。

限制:除数据库外集成均为可选,未设置对应环境变量时功能会被静默禁用,而非报错。page.tsx 和 layout.tsx 始终为服务端组件,客户端交互需拆分到带 'use client' 的文件。环境变量通过各包 keys.ts 配合 Zod 与 @t3-oss/env-nextjs 在构建时校验。本地 URL 已预配置,部署时需改为生产域名。官方未提供收费、价格等具体信息。