@hellohistory/create-matrix-app

一个用于快速搭建 Matrix Next.js 模板项目的交互式 CLI。通过一步步的提示即可完成项目初始化，并支持在生成模板后立即使用偏好的包管理器安装依赖。

快速开始

npx @hellohistory/create-matrix-app@latest -n tip-calculator-large-groups -p npm

运行后你可以：

1. 输入项目名称（默认 my-matrix-app）。
2. 选择是否立即安装依赖。
3. 在需要安装依赖时选择包管理器（npm、yarn、pnpm 或 bun）。

完成后会自动写入模板的 package.json 项目名，并在必要时还原 .gitignore。

常用参数

• -n, --name <name>：指定项目名称。
• -y, --yes：跳过交互，直接使用默认值并启用自动安装。
• -p, --package-manager <manager>：指定包管理器，支持 npm、yarn、pnpm、bun。
• --no-install：仅生成模板，不自动安装依赖。

示例：

# 跳过交互，使用 pnpm 安装依赖
npx create-matrix-app -y -n my-app -p pnpm

# 只生成模板，稍后手动安装
npx create-matrix-app --no-install

开发提示

• 项目模板位于 template/ 目录。
• CLI 源码位于 bin/cli.mjs。
• 复制模板后会自动更新 package.json 的 name 字段并保持 JSON 缩进为 2 个空格。
• 若启用国际化并自定义导航标题，请同步更新 template/_overrides/i18n/messages/*.json 中的对应 key，以避免界面回退到未翻译的占位符。