SuperAPI AI 工具集

nextjs-tinacms

前端与建站

查看项目

更新于 10-15 21:50

技能介绍

用途:该技能用于构建 Next.js 16 + React 19 + TinaCMS 网站,覆盖可视化编辑、基于 blocks 的页面构建和 SEO。技术栈偏好 Next.js App Router、TinaCMS、Tina Cloud、Vercel、Tailwind CSS 4 与 shadcn/ui,支持两种工作流:从零搭建新项目,或将 CMS 集成到已有 Next.js 15/16 项目。

主要能力:TinaCMS 3.x 提供 Git 支撑的内容管理、可视化点击编辑、GraphQL schema API;Next.js 16 使用 Turbopack 默认、"use cache"、proxy.ts 与异步 params;搭配 React 19 Server Components、Tailwind CSS 4 CSS-first 配置、shadcn/ui CLI v4,以及 Vercel 分析与部署钩子。

使用方式:快速开始命令为 npx create-next-app@latest my-site --typescript --tailwind --app --src-dir,随后 cd my-site 与 npx @tinacms/cli@latest init。本地开发命令是 tinacms dev -c "next dev",绝不能单独运行 next dev,否则本地 GraphQL 服务不会启动;打开 http://localhost:3000/admin/index.html 验证。构建命令须为 tinacms build && next build,顺序错误会报 Cannot find module '../tina/generated/client'。生产环境在 Vercel 上通过 NEXT_PUBLIC_TINA_CLIENT_ID 与 TINA_TOKEN 连接 Tina Cloud。

关键限制:服务端与客户端拆分是强制的,useTina() 需要 "use client",每个可编辑页面需要 Server Component 与 Client Component 配合;TinaCMS 3.x 仅支持 ESM,配置文件须用 import 语法;需固定精确版本,tinacms/generated/ 应被 gitignore,仅提交 tina-lock.json;@tinacms/cli 须 >= 2.1.8 以修复 CVE-2026-28792;Next.js 需 >= 16.0.10、Node.js >= 20.9.0。

其他功能:可在 .claude/settings.json 中配置钩子阻止编辑生成文件,并接入 context7、playwright 等 MCP 服务;参考文件涵盖 schema 设计、可视化编辑、SEO、部署与设置清单。费用、价格与平台细节暂未提供。