create-next-imagicma

一个极简项目脚手架，用于从本仓库模板快速生成新项目。支持双模板：hono 与 next。

模版源

• ../nextjs-app
• ../hono-app 如果要修改模版，请修改源头，然后执行 pnpm run sync-template 同步到当前模版目录，切记不可直接修改当前模版目录。

使用

npm install -g create-next-imagicma
create-next-imagicma <project-dir> [--template <hono|next>] [--port <1-65535>] [--theme <name>]

本地（未发布）使用示例：

cd /Users/alexliu/Project/imagicma-template
node ./create-next-imagicma/bin/create-next-imagicma.mjs demo-hono --template hono --port 5001
node ./create-next-imagicma/bin/create-next-imagicma.mjs demo-next --template next --port 5001

参数

• --template <hono|next>：选择模板。默认 hono。
• --port <number>：设置新项目默认端口。
  • next 模板：写入 next dev/start -p <port>
  • hono 模板：写入 /.imagicma/port.json，并同步 process-compose.yaml 的 PORT
• --theme <name>：设置默认主题（quadratic、nomad、honey、zen-garden、highlighter）。
• -v, --version：显示版本号。

依赖安装策略

• 优先 pnpm install
• 无 pnpm 时尝试 corepack pnpm install
• 仍不可用则回退 npm install

维护模板

在脚手架目录执行：

pnpm run sync-template

默认同步：

• ../nextjs-app -> template/
• ../hono-app -> template-hono/

可通过环境变量覆盖：

SOURCE_REPO_NEXT=/abs/path/to/nextjs-app \
SOURCE_REPO_HONO=/abs/path/to/hono-app \
pnpm run sync-template

兼容旧变量（仅 Next）：

SOURCE_REPO=/abs/path/to/nextjs-app pnpm run sync-template