这是什么?
Kargul Starter 是一个用于构建 Web 项目的样板工程,基于 Next.js 16、React 19 和 Tailwind CSS 4,并附带一套严格的构建规范。
这是现成的应用,还是供我在其上构建的起步模板?
它是一个起步模板(样板工程),不是成品应用。你克隆它并在其上构建自己的项目,遵循 CONVENTIONS.md 中的规则——该文件是组件、区块和页面必须如何构建的完整规范。
怎么把它跑起来?
运行 npm run dev 启动开发服务器,npm run build 做生产构建,npm run start 为该构建提供服务。npm run lint 运行 ESLint。
它基于什么构建?
技术栈是 Next.js 16、React 19 和 Tailwind CSS 4,并配置了 ESLint 用于代码检查。
开始自定义之前有什么要注意的吗?
在编写任何组件、区块或页面之前,你应当先读 CONVENTIONS.md——它定义了仓库其余部分所遵循的整套设计系统规范(布局令牌、字号层级等)。
在新项目上我首先需要配置什么?
在 lib/seo.ts 中设置 SITENAME、SITEURL、SITEDESCRIPTION 和 SITEROUTES(robots.ts、sitemap.ts 和页面元数据中的所有内容都由这些派生),把 app/globals.css 中的字号层级和内边距令牌调成符合你的设计,添加 1200x630 的 app/opengraph-image.jpg 及配套的 alt 文本文件,并替换默认的 Inter 字体。
avif 和 rive 这两个 npm 脚本是做什么的?
npm run to:avif 把图片转换为 AVIF 并报告其内联体积开销;npm run extract:avif 从 public/ 下的 .webm 视频中提取海报帧;npm run frame:rive 从 .riv 的 Rive 动画文件渲染一张静态海报图。
AGENTS.md 和 OPTIMIZATION.md 里写了什么?
AGENTS.md 收录面向在仓库中工作的编码智能体的 Next.js 版本说明,而 OPTIMIZATION.md 则解释(附测量数据)为什么 Rive 资源的加载被安排在页面的 LCP 事件之后。
What are similar projects?
workflow-editor, Next-js-Boilerplate, saas-starter, tailwind-nextjs-starter-blog, arc-library, NotionNext, react-starter-kit, rare-ui
Which topics is it in?
design-tokens, images, performance-optimization, javascript-framework, starter-kit, eslint, fonts, seo, boilerplate, reactjs, template, tailwindcss