create-nasti

一行命令创建 Nasti 项目

React + TanStack Router / React / Vue / Electron 开箱即用

用法

# npm
npm create nasti@latest

# pnpm
pnpm create nasti

# yarn
yarn create nasti

# bun
bun create nasti

按提示选择项目目录与模板即可。也可以在命令行直接指定：

# pnpm / yarn / bun 可直接传参
pnpm create nasti my-app --template react-tanstack

# npm 传参需要加 `--` 分隔
npm create nasti@latest my-app -- --template react-tanstack

模板

| 模板 | 说明 | | --- | --- | | react-tanstack | React + TanStack Router 文件式路由，构建期自动代码分割（头牌） | | react | 最小 React 单页应用 | | vue | Vue 3 单文件组件（SFC） | | electron-react | Electron 41+ 主进程 / Preload + React 渲染层 |

创建完成后：

cd my-app
npm install        # 若创建时未自动安装
npm run dev

Nasti 2.0 亮点

脚手架生成的项目默认基于 Nasti 2.0（Rolldown / Oxc 驱动）：

• per-chunk CSS 抽取 —— 生产构建按 chunk 自动拆分 CSS、带 hash 文件名并注入 <link>，零配置。

• 实验性完整打包 dev 模式 —— Web 模板（react / react-tanstack / vue）内置 dev:bundle 脚本，走 Rolldown 原生 dev 引擎提供内存打包产物：

  npm run dev:bundle        # = nasti dev --bundle

  默认 npm run dev 仍是标准开发模式；dev:bundle 为 opt-in 尝鲜，HMR 行为以标准 dev 为准。

• 调试输出 —— 任意 nasti 命令都可加调试 flag 观察内部流程：

  nasti build --verbose         # 全部 nasti:* 命名空间
  nasti dev -d build,hmr        # 仅指定命名空间
  nasti dev -f rolldown         # 按内容过滤
  nasti build --logLevel warn   # 调日志级别

命令行选项

| 选项 | 说明 | | --- | --- | | -t, --template <name> | 指定模板：react-tanstack / react / vue / electron-react | | --pm <name> | 指定包管理器：npm / pnpm / yarn / bun（默认自动探测） | | --install / --no-install | 是否自动安装依赖（默认询问） | | --git / --no-git | 是否执行 git init（默认询问） | | --overwrite | 目标目录非空时清空后继续 | | -h, --help | 查看帮助 |

包管理器

脚手架通过 npm_config_user_agent 自动探测你使用的包管理器（npm / pnpm / yarn / bun），安装命令与「下一步」提示都会与之匹配。也可用 --pm 显式指定。

系统要求

• Node.js ≥ 20
• electron-react 模板需要 Electron 41+（捆绑 Node 22 / Chromium 138）

License

MIT - Made by zixiao-labs