create-app-dock

Create an AppDock workspace, either as a micro-frontend or a single application, with or without the demo pages.

npx create-app-dock@latest my-app
# 或
pnpm create app-dock my-app

创建结果的第一行会打印 CLI 版本（如 create-app-dock v0.1.4），可用 create-app-dock --version 单独查看，避免误用旧版本。npx create-app-dock@latest 是拿到最新版的推荐方式。

The initializer also accepts the npm-style alias:

pnpm init app-dock my-app --template default

pnpm 装到了旧版本（没有形态/示例选项）？ 不带版本号的包名本应按 registry 的 latest 标签解析，但 pnpm 的 create / dlx 会缓存解析结果（~/Library/Caches/pnpm/dlx、 ~/Library/Caches/pnpm/v11/metadata，Linux 为 ~/.cache/pnpm/...），个别环境会长期停留在旧版本。排查顺序：先 npm view create-app-dock version 确认最新版 → 再删缓存重试 → 仍旧就换入口：

npx create-app-dock@latest my-app              # 推荐：npx 每次重新解析 latest
pnpm create app-dock@<version> my-app          # 精确版本兜底，<version> 换成当前最新版

生成结果首行的 create-app-dock vX.Y.Z 会显示实际使用的版本。

Options

| 选项 | 说明 | | ------------------- | ------------------------------------------------------------------------------------ | | --micro | 微前端形态（默认）：基座 + application/* 子应用 + qiankun + 子应用脚手架脚本 | | --single | 单应用形态：移除 qiankun、子应用目录与子应用脚手架，仅保留 main-app + common | | --examples | 包含示例页面（默认）：工作台、寻源、供应商、招募、招标、公司设置、消息中心等原型页面 | | --no-examples | 不包含示例页面：保留布局、主题、公共库与开发工具页，并生成一个最小首页 /home | | --force | 覆盖非空目录（谨慎使用） | | --template <name> | 模板名称，目前仅支持 default | | --version, -v | 打印 CLI 版本 | | --help, -h | 显示帮助 |

不带形态/示例选项时会在终端中交互选择：

项目形态：(1) 微前端（默认） (2) 单应用 >
是否包含示例页面（工作台 / 寻源 / 供应商等）？(Y/n) >

在非交互环境（CI、管道）中未传选项时，使用默认值：--micro --examples。

示例

# 交互式
pnpm create app-dock my-app

# 微前端 + 示例（默认组合）
pnpm create app-dock my-app --micro

# 单应用 + 不含示例
pnpm create app-dock my-app --single --no-examples

生成后

cd my-app
pnpm install
pnpm dev

构建产物：main-app/dist（压缩 + 混淆）与 main-app/dist-debug（不压缩、带 sourcemap）；图标 sprite 输出为 main-app/dist/app-icons.svg；图标字典 SQL 在 sql/ 下（pnpm gen:icon-sql 可重新生成）。容器与流水线：根目录 Dockerfile、Jenkinsfile。

单应用形态的可用命令：dev、dev:mock、dev:supabase、build、build:mock、build:supabase、check、fix 以及 Supabase 相关脚本；微前端形态额外包含 dev:select、build:select、create:app、delete:app、 gen-micro-apps。