create-teamix-evo
v0.9.1
Published
Scaffold a Vite + React + TypeScript project pre-wired with Teamix Evo design tokens, AI skills, and UI components.
Readme
create-teamix-evo
Scaffold a Vite + React + TypeScript project pre-wired with Teamix Evo design tokens, AI skills, and UI components.
Usage
# pnpm (recommended)
pnpm create teamix-evo my-app
# npm
npm create teamix-evo my-app
# yarn
yarn create teamix-evo my-appPreset
create-teamix-evo 通过 --variant 选定 preset,内置两个 preset:
opentrek(默认)— 探索者控制台:深色侧边栏(OpSidebar) + Dashboard / List / Detail / Form 四页面uni-manager— 云管控制台:顶部导航栏(UmTopbar) + 左侧树形子导航 + Dashboard / List / Detail / Form 四页面
每个 preset 自带:Vite + React + TS + Tailwind v4 + @teamix-evo/tokens(对应 variant)+ AI skills(Qoder + Claude + Codex design + code 双技能)+ ESLint + Stylelint(token-discipline)+ 真组件源码(button / card / input / form / table / sidebar 等)。
Preset 页面、菜单和表单文案是中文示例业务内容,用于开箱展示,不承诺应用级
多语言。Teamix Evo G11n 只负责已安装 UI/Biz-UI 的组件 chrome;项目需要繁体中文、
英文或更多语言时,由应用自己的 i18n 方案翻译这些业务文案,并同步宿主
<html lang dir>。
Options
create-teamix-evo <dir> [options]
Arguments:
dir Target directory (will be created if it does not exist)
Options:
--variant <name> Preset variant: opentrek | uni-manager (default: opentrek)
--pm <name> Package manager: pnpm | npm | yarn (auto-detected by default)
--no-git Skip Git repository initialization and commit (validation still runs)
--no-install Generate files only; requires --no-git
--force Overwrite target directory if it exists
-h, --help Display help默认启用 Git 时,CLI 会先建立没有 HEAD 的 main 仓库,再运行脚手架、唯一一次依赖安装和
typecheck/lint/lint:css/build;全部通过后才写入唯一的 chore: init teamix-evo 首次提交。失败可
保留 0-commit .git/ 供修复后重跑;唯一提交是硬性结果,worktree 状态不是成功门禁。--no-git
跳过建仓与提交,仍执行安装与验证;--no-install 必须配合 --no-git,且结果明确为未验证生成态。
What gets scaffolded
After the command finishes:
my-app/
├── .teamix-evo/ # 装机元数据(frozen / regenerable)
│ ├── config.json # 工程级 config (frozen)
│ ├── manifest.json # 装机产物清单(regenerable)
│ ├── tokens-lock.json # tokens 装机记录(variant + version, regenerable)
│ └── skills-lock.json # skill 版本 / scope / mirroredTo(ADR 0048)
├── .qoder/skills/ # AI skills mirror for Qoder(含 variant 设计 skill)
├── .claude/skills/ # AI skills mirror for Claude Code(含 variant 设计 skill)
├── .agents/skills/ # AI skills mirror for Codex / ChatGPT(含 variant 设计 skill)
├── AGENTS.md # skill 触发兜底(regenerable,ADR 0038)
├── src/
│ ├── tokens/ # 设计 token 唯一真值(ADR 0068)
│ │ ├── tokens.theme.css # regenerable
│ │ └── tokens.overrides.css # frozen — 业务自定义覆盖
│ ├── components/ui/ # ui add 落地的真实组件(button / card / input / form / table 等,frozen)
│ ├── lib/teamix-evo-g11n/ # 组件 G11n runtime + 三语言 catalog(按已装 entry 落地)
│ ├── pages/, layouts/, routes.tsx
│ ├── App.tsx, main.tsx, index.css
├── package.json, vite.config.ts, ...ADR 0020 之后,承载设计纲领/品牌/patterns 的
AGENTS.md/DESIGN.md/CLAUDE.md不再落到工程根 —— variant 设计 skill 自包含完整规则,由 IDE 经.qoder/skills//.claude/skills//.agents/skills/加载。但 ADR 0038 启用了另一类性质不同的
AGENTS.md—— 仅做 skill 触发兜底:从已装 SKILL.md frontmatter 动态抽取 TRIGGER / SKIP 索引结构、不复制 skill 正文。解决 description-based 触发的欠触发风险(用户 prompt 措辞偏移时,IDE 仍能先扫到 skill 触发条件)。
Next steps
cd my-app
pnpm dev # 启动开发服务器Want to add more UI components later? Inside the project:
npx teamix-evo ui add card table form inputFull lifecycle guide (tokens update, skills update, ui add, etc.) lives in the teamix-evo-manage skill — your IDE loads it from .qoder/skills/, .claude/skills/, or .agents/skills/ automatically.
