文档/介绍
介绍
Forge UI Kit 是什么、解决什么问题、跟市面其他 Kit 的关系。
Forge 是什么
Forge 是一套面向内部 ToB 交付的 React UI Kit,技术栈是 Next.js 16 · React 19 · Tailwind v4 · TypeScript 5,图标选用 solar-icon。
内容包括 60+ 组件、业务级模版(Ecommerce / Auth)以及 Dashboard Builder 8 种外壳,都从 Figma 设计稿 1:1 还原。团队拿它快速交付客户定制后台, 不必每个新项目都从零拼骨架。
为什么做这个
市面空白。开源 React/Next.js 生态里,没有同时满足「面向 AI agent 可理解 + 快速开发 + ToB 交付级」的 Kit。
纯 AI 生成不可靠。即便是 Figma Make 这类直出方案,也无法严格按照既有 UI 规范生成新页面——真实场景里要的是 「按规范设计新业务页」,但 AI 只是参考规范自由发挥,产物风格很难控制。
Forge 的解法。做一套 Claude Code / Codex 这类编程 Agent 能读懂的设计系统——人和 AI 对齐需求后,AI 100% 基于 Forge 组件产出固定风格的页面,人从展现层解放出来,专注业务逻辑和交付速度。
核心原则
四条最基础的硬规矩,新增组件和业务页都要遵守:
- Figma-First — Figma 是单一真相源, 复刻从 Dev Mode 原始代码开始,不靠截图或记忆。
- Token-Driven — 颜色、字号、圆角、阴影、间距走 CSS 变量,组件内不写
#hex和裸px。 - Kit Only — 业务页只允许 import Kit 组件, 禁止手搓
div复刻已有组件;pattern 重复 3 次立即抽到 Kit。 - AI-Readable — props 扁平语义化,每个组件配
<ApiTable>,让 AI agent 照表调用不用猜。
里面有什么
- 组件 — 60+ 基础组件,分 Foundations 和 Components 两组。
- 组件矩阵 — 每个组件所有变体、尺寸、状态、颜色矩阵铺开展示。
- 模版 — 用 Kit 拼好的整套业务页:Ecommerce Admin、Auth、Dashboard Builder。
- UI for Agents — Skill 插件 + AGENTS.md 约定,让 Claude Code / Codex 开箱即用地基于 Forge 产页面。