open-index/open-npm huggingface dataset:
npm package: @hellohistory/create-matrix-app
Description: A CLI to scaffold Next.js Matrix Template
Latest version: 0.2.4

# @hellohistory/create-matrix-app

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

## 快速开始

```bash
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`：仅生成模板，不自动安装依赖。

示例：

```bash
# 跳过交互，使用 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，以避免界面回退到未翻译的占位符。