forge-starter
Health Uyari
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Basarisiz
- exec() — Shell command execution in .agents/skills/hairline-create/build.mjs
- exec() — Shell command execution in .agents/skills/hairline-create/look.mjs
- spawnSync — Synchronous process spawning in .agents/skills/hairline-create/look.mjs
- process.env — Environment variable access in .agents/skills/hairline-create/look.mjs
- exec() — Shell command execution in .agents/skills/hairline-create/validate.mjs
- spawnSync — Synchronous process spawning in .agents/skills/hairline-create/validate.mjs
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Next.js admin starter on Forge UI: auth, RBAC, OpenAPI module generator, Ask AI and agent skills. AI 原生的中文后台脚手架。
Forge Starter
AI 原生的企业级 B 端脚手架 — 用 Forge UI 搭管理后台时,把登录、列表、详情、RBAC 样板和 Agent skills 已经定过的选择收进同一套壳,人和 Coding Agent 从同一起点开工。
这是可 fork / Use this template 的起点,不是可直接售卖的成品 SaaS,也不是「克隆下来就有一家公司」的全家桶。边界见下方「适合 / 不适合 / 取舍」。
Live Demo · Use this template · 文档索引 · Forge UI · 官网
仓库镜像
| 平台 | 仓库 |
|---|---|
| GitHub(权威) | https://github.com/forge-ui/forge-starter |
| Gitee | https://gitee.com/forgeui/forge-starter |
| AtomGit | https://atomgit.com/bitlink/forge-starter |
60 秒上手
需要 Node.js 22.14+、pnpm 11、Docker(或自备 Postgres)。
方式 A — Use this template(推荐)
- 打开 Use this template 生成自己的仓库
- Clone 后执行下方命令
方式 B — Clone
git clone https://github.com/forge-ui/forge-starter.git
cd forge-starter
cp .env.example .env
# 设 POSTGRES_PASSWORD,并同步写进 DATABASE_URL(特殊字符需 URL 编码)
docker compose up -d --wait
pnpm install && pnpm db:migrate && pnpm db:seed && pnpm dev
本地打开 http://localhost:3000。线上预览:https://starter.forgeui.org/。
更完整的环境变量、种子与排错见下方「快速开始」与 docs/setup.md。组件库:forge-ui/forge · 官网:forgeui.org。
不需要 /ref 下的 30 多个参考页时,运行 pnpm simple 预览、pnpm simple --yes 删除,只留编程助手要抄的两个样板,见 docs/reference-pages.md。
它解决谁的什么问题
你要做的是内部系统或运营后台,希望页面看起来像 Forge 自己的产品,并且希望同事或编程助手加一个模块时不要漂成另一套 UI。
组件、颜色和页面骨架有约定。账号管理是可以抄的重样板。Agent 的工作被拆成「先数据与接口,再页面,再对照清单审计」。这些事如果每次都靠临场发挥,后台会慢慢长得不像同一个产品。
适合谁
- 要用
@forge-ui-official/core做 B 端或内部后台的人 - 接受 PostgreSQL,也接受「登录用户」和「业务数据」分表
- 希望 Agent 按仓库里的 skill 加模块,而不是一次把整套样板抄死
不适合谁
- 想换成 MUI、Ant Design 或一整套 shadcn 的项目。这里缺的能力记成
FORGE-GAP,不要悄悄手搓一套 - 还没准备数据库就想做完整的增删改查。
AUTH_MODE=demo只是登录不查用户表,业务表照样要 Postgres - 需要开箱的 OAuth、SSO、审批流、订阅计费或消息中心
- 希望 Forge Agent 自己改数据库。它能查、能提议;真正写入要回到页面原来的保存
取舍
这些是故意的,不是还没做完。
- 登录只有用户名或邮箱加密码。 会话是 httpOnly cookie。邮件只走 SMTP,没有云邮件 SDK。重置链接只发到注册邮箱。
- demo 是给开发和看界面用的。 任意密码都能进。没写
AUTH_MODE时开发环境就是 demo。生产进程会拒绝 demo,也会拒绝没有AUTH_SECRET的启动。确要做公开演示,设置ALLOW_INSECURE_AUTH=true,并换一个独立库。 - 密钥至少 32 位。 开发时 demo 可以不写,用的是仓库里那把内置演示密钥。写了但不够长,不会再悄悄退回去。
- 应用切换存在浏览器本地。 外部系统的认证方式只是占位,不是真 SSO。
- RBAC 是目录加一个角色字段,不是完整的身份系统。 有角色、菜单、权限三个页面。侧栏能不能看见,要同时满足菜单配置、当前应用勾选,以及角色的
:read。没有把登录用户拖进角色的界面。local模式下公开注册固定是只读,管理员要改users.role_code。demo 里对得上的用户名走种子角色,其余用户名是超级管理员,方便试用,不要把它当成安全边界。 - Forge Agent 不会自己写库。 读可以马上做。写入和删除先出确认,再填进页面自己的表单或删除确认。没接模型时,几条示范问题用本地规则回答。它不读仓库源码,也不生成页面。
- 结构变更有两条路。 新环境、CI 和生产用
pnpm db:migrate。开发时对着自己的库改 schema,可以用pnpm db:push,它不写迁移记录,生产默认拒绝执行。 - 没有 ESLint。 提交前的机器检查是
pnpm check:TypeScript、规范绊线、规范脚本自检与通用规范漂移检查。离线会明确跳过远端检查,不代表完整通过;机器检查不代替页面审计。
现在仓库里实际有什么
上一版 README 写过「没有 RBAC」。角色、菜单、权限和 lib/rbac 已经在仓库里,那句话作废。
| 有 | 边界 |
|---|---|
| 登录、注册、找回、重置;个人资料和改密 | 无 OAuth、社交登录 |
| 工作台,指标接的是业务账号 | 不是一份可配置的报表产品 |
| 账号管理:列表、表单弹窗、全页详情 | 样板。登录用户在 users,业务账号在 admin_accounts,不要混 |
| 角色、菜单、权限 | 见上面的取舍。菜单目录本身进不了侧栏 |
| 模型服务:供应商列表加模型卡片 | 密钥只留在服务端。Forge Agent 优先用这里启用的模型,没有再用 ASK_AI_LLM_* |
| Forge Agent harness | 任务可以暂停、恢复;人在页面上确认后才保存。见 docs/ask-ai-harness.md |
| 应用管理 | 浏览器本地登记。外部认证是占位 |
Agent skills、/ref 参考页 |
参考页默认不进菜单。生产默认关闭 |
从 OpenAPI 生成模块:pnpm module:openapi |
对接已有后端,只生成读取(类型、service、只读 API、菜单、Forge Agent 读取);写入要在页面阶段接 |
没有审批流、支付、订阅、积分、通知中心、IM、多租户。
快速开始
需要 Node.js 22.14 或更新、pnpm 11、Docker。也可以不用 Docker,自己准备 Postgres,把 DATABASE_URL 指过去。
cp .env.example .env
# 设一个 POSTGRES_PASSWORD,并把同样的密码写进 DATABASE_URL(特殊字符要做 URL 编码)
# 开发可保持 AUTH_MODE=demo。要真注册登录:AUTH_MODE=local,并换掉 AUTH_SECRET(至少 32 位)
docker compose up -d --wait
pnpm install
pnpm db:migrate
pnpm db:seed
pnpm dev
pnpm db:migrate 要在 pnpm install 之后。数据库刚起来就失败的话,等健康检查通过再跑一次;上面的 --wait 就是在等这件事。第二次执行会跳过已经应用的迁移。
demo 登录之后,账号管理、角色、模型这些页面仍然要库。没有 DATABASE_URL,这些 CRUD 做不了。
环境变量、种子角色和命令说明在 docs/setup.md。
文档
人和 Agent 不要从同一页读起。索引在 docs/README.md。
| 谁 | 先读 |
|---|---|
| 人 | 本页,然后 docs/setup.md、docs/product.md |
| Agent | AGENTS.md,然后它点名的那几份规范 |
docs/history/ 是做过的审计和发布记录,不是当前规范。
许可证
MIT。版权人 forge-ui contributors,2026。
相关:Forge UI · Forge Design
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi