# @getforma/create-app 中文文档

规范地址：https://npmcn.com/package/%40getforma/create-app/

版本：3\.2\.0
npm 元数据更新时间：2026-10-27T18:21:34.866Z
中文译文更新时间：2026-11-16T06:12:26.163Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40getforma/create-app
原文对照：https://npmcn.com/package/%40getforma/create-app/?lang=original
项目主页：https://getforma.dev/
源码仓库：https://github.com/getforma-dev/forma

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：493 kB，61 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-03-13T21:35:07.164Z
- 最新版本发布：2026-10-27T18:21:34.386Z
- 近 30 天下载量：2789（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

创建一个新的 Forma app — Rust + TypeScript SSR 框架

## 安装

```sh
npm install @getforma/create-app
```

也可以使用：`pnpm add @getforma/create-app`、`yarn add @getforma/create-app`、`bun add @getforma/create-app`

## README

# @ getforma/ 创建- app

[![npm version](https://img.shields.io/npm/v/@getforma/create-app.svg)](https://www.npmjs.com/package/@getforma/create-app) [![CI](https://github.com/getforma-dev/forma/actions/workflows/ci.yml/badge.svg)](https://github.com/getforma-dev/forma/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

脚手架 新的 [福玛](https://getforma.dev/) 应用程序 —— Rust 服务器 + TypeScript 前端,全线化.

> **此所坐之处.** 一个储存库,八个协调源包:
> 
> ```
> TS/JSX → @getforma/compiler → FMIR 3 → forma-ir → forma-server → HTML
>          @getforma/build joins the assets       @getforma/core adopts islands
>          @getforma/create-app supplies the templates; forma-ir-derive types props
> ```
> 
> **你在这里:** 前门 新来的? 读取 **[堆栈结构](https://github.com/getforma-dev/forma/blob/main/docs/ARCHITECTURE-3.0.md)** - 它解释了管道。 所有8个源包都住进去了 [getforma-dev/formata 数据格式](https://github.com/getforma-dev/forma) 并公布为一套. 现有0.6.x项目可沿用 [3.0 模板迁移](https://npmcn.com/package/%40getforma/create-app/docs/UPGRADING-3.0.md)。 。 。 .

## 使用量

使用坐标 `3.2.0` CLI(英语:CLI). 对于连接的本地路由器应用程序:

```sh
npx @getforma/create-app@3.2.0 my-routed-app --template native-router
```

对于未公布的源更改,撰稿人使用 [包装的候选工作流程](https://npmcn.com/package/%40getforma/create-app/#readme-development)。 。 。 .

```bash
npx @getforma/create-app@3.2.0 my-app
cd my-app
```

然后说:

```bash
# Build the frontend
cd admin && npm ci && npm run build && cd ..

# Start the Rust server
cargo run
```

开通http://localhost:30. 所有模板绑定到 `127.0.0.1` 默认 仪表板可以选择与 `FORMA_HOST`并警告你们, 因为它 `/api/*` 路径没有认证.

## 选项

```bash
npx @getforma/create-app@3.2.0 my-app --template dashboard
npx @getforma/create-app@3.2.0 my-app --template minimal
npx @getforma/create-app@3.2.0 my-app --dry-run
npx @getforma/create-app@3.2.0 --help
npx @getforma/create-app@3.2.0 --version
```

项目名称必须以小写字母开头, 只使用小写 字母、数字、连字符和下划线,最多64个字符。 名称 成为箱子的名字,所以CLI也拒绝 货物拒绝新的 软件包(如: `fn`, (中文(简体) ), `test`,构建目录名称,例如 `build`)和一个Windows设备名称(`con`, (中文(简体) ), `nul`);其信息命名规则. 它检查 在写出任何内容之前先写出名称, 并拒绝写入已经存在的路径 已存在.

## 模板

| 模板 | 渲染 | 说明 |
| --- | --- | --- |
| `dashboard` | 明确的浏览器渲染 | DevOps 管理面板 — 4页, 8 API 路由, SVG 图表, Tailwind CSS, Gruvbox 主题 16 Playwright 测试 |
| `minimal` | 浏览器,或本地 SSR 与 `npm run build:ssr` | Rust 服务器 + 一个逆变页面和一个关于页面的静态 |
| `native-router` | 具有可选自主导航的本地SSA | 持续布局,打出所有者分支,普通链接和历史 |

`native-router` (a) 列入3.2.0 出版了3.0/3.1档案。 对于未公布的修改,使用文件包装 候选工作流程和选择 `--template native-router` 从候选人CLI. 3.2套还加上: `@getforma/router` 到本模板和仪表板。 仪表板仍然是 明确的浏览器应用程序,保留版式和路由页面所有权. 最小模板保留了它现有的依赖图并渲染行为. 见其 [所有权和部署指南](https://npmcn.com/package/%40getforma/create-app/templates/native-router/README.md) 编辑 [连接的路由通过](https://npmcn.com/package/docs/ROUTING.md)。 。 。 .

仪表板明确使用客户端渲染. FMIR 编译器行走源 而不是执行它,只接受有文件记载的本地子集。 这个 以编码诊断拒绝不支持的本地源; 它不会发出 空占位符或默默地将本地路径更改为客户端渲染. 最低模板显示已宣布岛屿状态的本土渲染; 见 [允许的子集](https://npmcn.com/package/%40getforma/compiler/docs/subset.md) 财务报告和审定财务报表 [模板渲染指南](https://npmcn.com/package/%40getforma/create-app/docs/RENDERING-PHASES.md) 选择模式时 用于新模板.

## 你得到的东西

-   **Rust 服务器** (单位:千美元)`src/main.rs`)——轴+ `forma-server`: 有约束的页面渲染 `PageHandle<Props>` (或 `render_browser_shell` 每页 a `PageResponse` 携带其按要求提交的CSP非ce和 `Cache-Control: no-store`,从 `rust-embed`没有服务员,和a `tracing` 按代码和路由记录每个渲染错误的订阅者
-   **类型脚本前端** (单位:千美元)`admin/src/`——有JSX,信号,组件的FormaJS
-   **建设管道** (单位:千美元)`admin/build.ts`(b) —— `@getforma/build`: 捆绑、 内容散列、 Brotli/ gzip, 显示, 以严格模式显示, 所以构造服务器不能用它的代码和行实现构建失败
-   **A 类 `.gitignore`** 包括产出、秘密和(仪表板) 剧作家文物——刻意不忽略 `Cargo.lock`
-   **锁定文件** (单位:千美元)`admin/package-lock.json` 财务报告和审定财务报表 `Cargo.lock`持有这个repo的脚手架门所建造和使用的准确版本,所以一个新的工程从一个测试的集合开始,而不是从那天的解决开始

## 发展

```bash
npm test        # structural tests — builds the CLI explicitly first
npx tsc --noEmit
```

候选门需要一个网络和一个Rust工具链. 从仓库 根、 构建和输入源, 然后使用新工艺/ 工作目录 :

```bash
npm run build
node scripts/candidate-scaffold.mjs pack /absolute/path/to/candidate-artifacts
# Use the record SHA-256 printed by pack and this checkout's full Git commit.
node scripts/candidate-scaffold.mjs run /absolute/path/to/candidate-artifacts RECORD_SHA256 COMMIT /absolute/path/to/candidate-work /absolute/path/to/report.json
```

CI总是在Linux和Windows上运行完整的候选套房. 分开 在所有版本合适的协调包时运行实际公布的 CLI 已存在。 缺少或跳过候选人的工作 失败了释放门。 源锁 种子从不直接传递给未公布的注册安装.

脚手架将每个模板装入一个临时目录,从 模板的锁定文件 `npm ci`,构建前端,运行 `cargo check --locked`,然后启动每个编译的服务器并读取其 响应: 最小模板必须服务于服务器在服务器后发送的标记 `build:ssr`,仪表板必须服务于每个页面作为其宣布的浏览器外壳 其 CSP 非ce 匹配脚本标记; 本地路由器必须在所有三个浏览器引擎中通过打入的导航保留其布局, 每页必须回答 `Cache-Control: no-store` 每次取回时都有一个新的非ce, 没有注册服务 工人,离开 `/sw.js` 到福玛服务员的退休工人。 也运行 `npm audit signatures` 覆盖每个模板的安装, 失败于任意 `use of deprecated` 从模板的 Rust 发出警告,检查是否 构造服务器无法渲染失败 , 而最小的服务器拒绝从一个被截断的模块开始 对失败的渲染以自己的500来回答,既不包含错误,也不包含 空壳. 在原始的SSR HTML中必须显示一个单独的处理器值为7; 缺少/错误道具和不受约束的路径必须在听众打开前停止. 已打包的本地- 岛屿检查采用服务器值而无需初始写入 并检查静态路线是否要求所有三个引擎没有代码. 这个 仪表盘工具提示检查将API值作为文本保存在强制信任类型下. 目前的"八打包"候选门需要全部24个重控外加结构套间,没有跳过. 历史 3.0/3.1 套装保留了原来的控制.

| 文档 | 这是什么 |
| --- | --- |
| [捐款额](https://npmcn.com/package/%40getforma/create-app/CONTRIBUTING.md) | 设置,大门,审查员会问什么 |
| [文件/主题](https://npmcn.com/package/%40getforma/create-app/docs/TEMPLATES.md) | 模板解剖学,脚手架重写什么,如何添加一个 |
| [文件/更新-菲律宾](https://npmcn.com/package/%40getforma/create-app/docs/RENDERING-PHASES.md) | 明确的浏览器和本地 SSR 模式, 以及被允许的编译器子集 |
| [堆栈结构](https://github.com/getforma-dev/forma/blob/main/docs/ARCHITECTURE-3.0.md) | 整个管道及其推理. **如果你是新来的就从这里开始.** |
| [测试政策](https://github.com/getforma-dev/forma/blob/main/docs/TESTING.md) | 此堆栈中每个测试的标准都按 |

## 福玛堆栈的一部分

### 前端( TypeScript)

| 软件包 | 说明 |
| --- | --- |
| [@ getforma/ 核心](https://www.npmjs.com/package/@getforma/core) | 反应 DOM 库 - 信号、 h (), 岛屿、 SSR 水分 |
| [@ getforma/ 编译器](https://www.npmjs.com/package/@getforma/compiler) | FMIR 生成、编码诊断和建立安全部门改革一体化 |
| [@ getforma/ 构建](https://www.npmjs.com/package/@getforma/build) | 生产管道——捆绑、散货、压缩、明细表 |
| [@ getforma/ 路由器](https://npmcn.com/package/%40getforma/router/README.md) | 可选浏览器/本地导航和持续布局 |

### 后端( Rust)

| 软件包 | 说明 |
| --- | --- |
| [福玛尔](https://crates.io/crates/forma-ir) | FMIR 二进制格式、结构验证和原生 Rust 行走器 |
| [forma 服务器](https://crates.io/crates/forma-server) | Axum 中件: SSR, 资产服务, CSP 头 |

### 完整框架

| 软件包 | 说明 |
| --- | --- |
| [@ getforma/ 创建- app](https://www.npmjs.com/package/@getforma/create-app) | **这个包** - 脚手架堆满了 |

## 许可证

麻省理工学院

## 原始模板和已出版文物

入帐模板使用已申报道具并敲定了Pages API. 最小的宣布一个"反"岛 在其静态的家园标记和单独的 关于页面的空道具。 本地处理器从 7 开始,同时使用明确的浏览器 模式从 0 开始。 出版的3.0.0集包括岛屿综合收养 和静态路线检查; 后期考生需要自己包装的资质.

明确识别出源模板锁 **种子** 在协调部门 软件包版本。 他们保留所有外部的登记校验和,只省略 已知的 Forma 候选校验和, 在档案之前无法存在 都装好了 从实际存档字节中释放这些条目, 验证已发运的锁,并恢复所有十个源文件。 唯一来源 `template-lock-seeds.json` 标记从未被运出。 使用已打包的候选人 用于本地端到端开发的脚手架工作流程;复制源模板 手工不产生可安装的未公布的成套候选人.

脚手架上写着一个单独的应用程序身份 `admin/build.ts`。 。 。 . 有效工人姓名保持不变;已接受的项目名称有下划线或 64个字符使用可读前缀外加确定性的SHA-256后缀. 这个 保留已接受的 CLI 名称,而不合并不同的缓存名称空间。 这个 服务器启用的工人必须使用此功能 `app` 值为 `sw::configure_for_manifest(worker, &manifest)` 绑定前; 模板离开 工人离开。 见 [兼容性和迁移](https://npmcn.com/package/docs/compatibility.md)。 。 。 .

验证人: `tests/scaffold.test.ts`, (中文(简体) ), `scripts/release-template-lock.test.mjs` 在寄存器根,以及精确的艺术P17模板运行.

## 常见问题

### @getforma/create-app 是什么？

创建一个新的 Forma app — Rust \+ TypeScript SSR 框架

### 如何安装 @getforma/create-app？

在项目目录运行 npm install @getforma/create-app，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 create-app、create-forma-app，可以用 npx create-app 直接运行。

### @getforma/create-app 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/getforma\_\_create-app 是否存在。

### @getforma/create-app 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @getforma/create-app 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @getforma/create-app 可以商用吗？

@getforma/create-app 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @getforma/create-app 的下载量有多少？

根据 npm 官方下载统计，@getforma/create-app 在 2026/10/17 – 2026/11/15 这 30 天内被下载 2,789 次，日均约 93 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @getforma/create-app 还在维护吗？

最新版本 3\.2\.0 发布于 2026/10/28（19 天前）；至今共发布 26 个版本，其中过去 12 个月发布了 26 个；首次发布于 2026/03/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

