preset.json

preset.json 是预设配置文件, 定义一组预设的 Registry 组合, 用于快速初始化项目。

示例

{
  "$schema": "https://registry.rackjs.com/schemas/preset.json",
  "name": "react-tutorial-project",
  "version": "1.0.0",
  "description": "React 教程项目预设, 包含 TypeScript、Vite、React Router 等",
  "author": "John Doe",
  "tags": ["react", "tutorial", "typescript"],
  "registries": ["runtimes/node", "build/vite", "frameworks/react"]
}

字段说明

$schema

• 类型: string
• 必填: 否
• 说明: Schema URL

{
  "$schema": "https://registry.rackjs.com/schemas/preset.json"
}

name

• 类型: string
• 必填: 是
• 说明: Preset 名称（kebab-case）

{
  "name": "react-tutorial-project"
}

version

• 类型: string
• 必填: 是
• 格式: 语义化版本（semver）
• 说明: Preset 版本

{
  "version": "1.0.0"
}

description

• 类型: string
• 必填: 否
• 说明: Preset 描述

{
  "description": "React 教程项目预设"
}

author

• 类型: string
• 必填: 否
• 说明: 作者信息

{
  "author": "John Doe"
}

tags

• 类型: string[]
• 必填: 否
• 说明: 标签

{
  "tags": ["react", "tutorial", "typescript"]
}

registries

• 类型: string[]
• 必填: 是
• 说明: Registry 列表, 可以指定版本号和语言变体

格式:

• 完整格式: @namespace/name[@version][:language]（用于非 @rack 命名空间）
• 简写格式: name[@version][:language]（CLI 会自动解析为 @rack/name，推荐用于 @rack 注册表）

版本号格式 (遵循 semver):

• 精确版本: runtimes/node@1.0.0 或 @rack/runtimes/node@1.0.0
• 不指定版本: runtimes/node（使用最新版本）

语言变体 (可选 :js 或 :ts 后缀):

• 单独固定为 JS 变体: frameworks/vue:js
• 与版本组合: frameworks/vue@1.0.0:ts
• 省略时继承项目级 rack.json.language（或 registry 的 defaultLanguage，最终回退到 ts）

{
  "registries": [
    "runtimes/node",
    "build/vite",
    "frameworks/react",
    "@company/internal-tool@1.0.0"
  ]
}