forge

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

面向企业后台和 SaaS 的 AI Native React 组件库

README.md

Forge

Forge

面向中文企业后台和 SaaS 的 React 组件库:组件、页面组件、模板,以及给编码助手的接入。

npm @forge-ui-official/core MIT License

官网 · 文档 · 组件 · 页面组件 · 模板

Forge 首页:标题“为日常工作,构建出色界面”,下方是可按组件、数据概览、财务、智能体、看板切换的组件墙

仓库镜像

平台 仓库
GitHub(权威) https://github.com/forge-ui/forge
Gitee https://gitee.com/forgeui/forge
AtomGit https://atomgit.com/bitlink/forge

官方开发与 Issue / Release 以 GitHub 为准;Gitee、AtomGit 为国内镜像。

人和 AI 按同一套规则做后台:设计 token、React 组件、AppLayout、70 个页面组件、业务模板,以及给 Claude Code、Codex、Cursor 用的 Skill 和 MCP 服务器。

为什么用 Forge

  • 整页有现成源码。 70 个页面组件覆盖看板首屏、数据列表、详情、表单、设置、认证和智能体产品页,用 shadcn 命令一行装进项目;订单、商品、客户、项目等多页模板可以直接改。
  • 视觉规范在组件里。 Button、Form、DataTable、Calendar、Chart、Card、Toolbar、Dialog 等走 @forge-ui-official/core。颜色、字体、圆角、边框和密度不用每页重写。
  • 后台壳已经装好。 AppLayout 带 sidebar、topbar、profile、notification、language switcher、team switcher 和 page header。
  • 编码助手按同一套规则写,还能自查。 Skill 和只读 MCP 服务器提供组件参数、页面组件和模板;写完用 check_code 或 forge-check 按审计清单检查。

快速开始

需要 React 19、Next.js 15 或以上、Tailwind v4,以及项目自行安装的 @solar-icons/react ^2.3.2。当前版本见上方 npm 徽章。

新项目

从 Forge Starter 开始。里面有登录、后台壳和加模块的流程。

git clone https://github.com/forge-ui/forge-starter.git
cd forge-starter
pnpm install
pnpm dev

已有项目

pnpm add @forge-ui-official/core
pnpm add -D tailwindcss @tailwindcss/postcss

在入口 CSS 里引入样式。@source 只保留和文件位置匹配的那一行,否则 Tailwind v4 扫不到组件里的 class。

@import "tailwindcss";
@import "@forge-ui-official/core/styles.css";

/* app/globals.css */
@source "../node_modules/@forge-ui-official/core/dist";

/* src/app/globals.css */
@source "../../node_modules/@forge-ui-official/core/dist";
import { AppLayout, Button, DataTable, SurfaceCard } from "@forge-ui-official/core";

更细的安装说明见文档站的快速开始。

页面组件

页面组件是复制进项目的源码,不在 core 包里。在页面组件目录挑一个,用 shadcn 安装:

npx shadcn@latest add https://www.forgeui.org/r/kanban-board.json

也可以在项目的 components.json 里登记命名空间,之后按名字安装:

{ "registries": { "@forge": "https://www.forgeui.org/r/{name}.json" } }

生态

做什么 从哪里开始
@forge-ui-official/core 组件、设计 token、AppLayout pnpm add @forge-ui-official/core
@forge-ui-official/agent 嵌进应用的 AI 助手:回答问题、调用接口、用 Forge 组件回答、操作页面 agent/README.md
Forge Starter 后台脚手架:登录、样板模块、加页面 git clone 后 pnpm dev
页面组件 70 个可复制的整页源码 npx shadcn@latest add https://www.forgeui.org/r/<name>.json
Forge Skill 与 MCP 让 Codex、Claude Code、Cursor 按组件和 token 写页面 curl -fsSL https://www.forgeui.org/setup.sh | bash
Forge Design Extension 在真实 Chrome 页面上点选、放置组件并改界面 独立仓库的 README

Forge Design Extension 是 Chrome 插件加本机桥接。它不替代组件库,也不替代 Starter。Starter 负责把后台跑起来,Design Extension 负责改已经跑起来的页面:点中要改的位置,侧边栏里的本地模型带着真实 selector 改文案、样式和交互,或把 Forge 组件写入源码;也可以从组件盘拖到锚点旁,确认后再写入。页面内容留在本机,不经过云端。安装方式是启动本机桥接,在 Chrome 里加载 extension/。

相关示例:forge-agent,一个基于 Forge 的 AI Agent 产品壳。

组件与模板

电商后台的商品列表
电商后台
电商仪表盘,含收入、订单和地图
仪表盘
组件页:按钮的效果与案例,可以直接操作
组件
智能体对话页,含思考过程、流式回答和输入栏
智能体
页面组件目录:按看板首屏、AI 与智能体、数据列表等分类的 70 个页面组件
页面组件
暗色主题的财务后台,含资产、支出和交易
暗色主题 · 财务后台

更多整页示例在模板目录:项目管理、客户关系、仪表盘外壳,以及 10 个已填数据的控制台。

给 AI 编码助手

一条命令装好 Forge Skill 和只读 MCP 服务器,自动识别本机的 Claude Code、Cursor、Codex:

curl -fsSL https://www.forgeui.org/setup.sh | bash

# 只装到当前项目,并放好 DESIGN.md
curl -fsSL https://www.forgeui.org/setup.sh | bash -s -- --scope project --design

# 检查是否装好
curl -fsSL https://www.forgeui.org/setup.sh | bash -s -- --check
用途
MCP 服务器 https://www.forgeui.org/api/mcp recommend 按一句需求给出模板、页面组件和组件;search、get_component、get_block、get_tokens 查细节;check_code 检查代码
页面检查 curl -fsSL https://www.forgeui.org/forge-check.mjs -o forge-check.mjs && node forge-check.mjs src,按审计清单报行号和改法,可放进 CI
DESIGN.md 视觉规则,遵循 google-labs-code/design.md 格式
llms.txt 文档索引;每个文档、组件、页面组件页面在地址后加 .md 就是 Markdown
AGENTS.md 不装插件时放在项目根目录的使用规则

仓库内给 AI 读的清单:docs/for-agents/README.md(入口)、components.md(组件用途)、inventory.json(全量导出)。

官网域名暂时不可用时,从 GitHub 获取同一份脚本:

curl -fsSL https://raw.githubusercontent.com/forge-ui/forge/main/public/setup.sh | FORGE_SITE=https://raw.githubusercontent.com/forge-ui/forge/main/public bash -s -- --mode skill
新项目提示词,复制给 Codex
请用 Forge 生态创建一个新的后台原型项目。

Forge 仓库地址:https://github.com/forge-ui/forge
Forge Starter 地址:https://github.com/forge-ui/forge-starter
Forge Design Extension 地址:https://github.com/forge-ui/forge-design-extension

请先确认本地已经安装或可读取 Forge Skill。
然后 clone Forge Starter 并初始化环境。
请确认项目已经安装 @forge-ui-official/core;如果 starter 没有带上,请执行 pnpm add @forge-ui-official/core。
同时确认入口 CSS 已引入 @forge-ui-official/core/styles.css,并且 Tailwind v4 已配置 @source 指向 @forge-ui-official/core/dist。
最后确认 pnpm dev、pnpm typecheck、pnpm build 都可用。

环境就绪后,先主动向我确认业务目标、用户角色、需要的页面/模块、核心数据对象、主要操作流程和验收标准。
我确认后,再开始设计并实现业务模块。

实现时请使用 Forge Skill;快开走 Forge Starter,在真实页面上改 UI 走 Forge Design Extension:
- Forge Skill 负责约束组件库、token、AppLayout 和基础样式。
- Forge Starter 负责后台壳、登录、业务样板和加模块流程。
- Forge Design Extension 负责在真实 Chrome 页面上点选、放置 Forge 组件并改界面。

页面实现优先使用 AppLayout 和 ForgeUI 组件,不要手写基础 Button/Card/Table/Form/Layout 样式。
页面布局可以按业务需要设计,但基础颜色、字体、圆角、边框、密度和响应式行为必须遵循 ForgeUI。

完成后运行 pnpm typecheck 和 pnpm build,并给出可访问地址、页面截图和剩余问题。

本地开发

仓库要求 Node.js >=22.13.0,包管理器由根目录 packageManager 固定为 pnpm 11.1.3。

pnpm install
pnpm dev

常用命令:

pnpm check           # 类型、lint 和全部测试(CI 跑的就是它)
pnpm build           # 构建组件包和文档站
pnpm typecheck       # 检查组件包和站点类型
pnpm core:build      # 只构建 @forge-ui-official/core
pnpm core:typecheck  # 只检查组件包类型
pnpm lint            # ESLint
路径 说明
core/ @forge-ui-official/core 源码
agent/ @forge-ui-official/agent 源码
blocks/ 页面组件源码,生成到 public/r/ 供 shadcn 安装
content/guides/ 使用指南(Markdown)
docs/for-agents/ 给 AI 的组件路由表和介绍表,先读 README.md
src/app/docs 文档页
src/app/components 组件展示和变体
src/app/cases 组件的效果与案例页(组件入口默认打开这里)
src/lib/mcp MCP 服务器;数据在构建时由 pnpm docs:mcp 生成
src/app/templates 完整后台模板和业务页
skills/forge-skill 可安装的 Forge Skill,给 Codex、Claude Code 和 Cursor 用
public/ 图片、llms.txt、DESIGN.md、setup.sh、forge-check.mjs 和 registry

License

源码使用 MIT License。图标使用 Solar Icons:React 实现为 MIT,480 Design 的图形为 CC BY 4.0。完整声明见 THIRD_PARTY_NOTICES.md。

Yorumlar (0)

Sonuc bulunamadi