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-app

Preset

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 design + code 双技能)+ ESLint + Stylelint(token-discipline)+ 真组件源码(button / card / input / form / table / sidebar 等)。

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 init
  --no-install        Skip dependency installation
  --force             Overwrite target directory if it exists
  -h, --help          Display help

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/                    # skills 源(source-mirror 模型,ADR 0013)
├── tokens/                        # 设计 token 真值(W3C JSON + Tailwind v4 @theme,ADR 0020)
│   ├── tokens.theme.css           # regenerable
│   ├── base.tokens.json           # regenerable
│   └── tokens.overrides.css       # frozen — 业务自定义覆盖
├── .qoder/skills/                 # AI skills mirror for Qoder(含 variant 设计 skill)
├── .claude/skills/                # AI skills mirror for Claude Code(含 variant 设计 skill)
├── AGENTS.md                      # skill 触发兜底（regenerable，ADR 0038）
├── src/
│   ├── components/ui/             # ui add 落地的真实组件(button / card / input / form / table 等,frozen)
│   ├── 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/ 加载。

但 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 input

Full lifecycle guide (tokens update, skills update, ui add, etc.) lives in the teamix-evo-manage skill — your IDE loads it from .qoder/skills/ or .claude/skills/ automatically.