preset.json

preset.json is a preset configuration file that defines a predefined combination of registries for quick project initialization.

Example

{
  "$schema": "https://rackjs.com/schema/preset.json",
  "name": "react-tutorial-project",
  "version": "1.0.0",
  "description": "React tutorial project preset with TypeScript, Vite, React Router, etc.",
  "author": "John Doe",
  "tags": ["react", "tutorial", "typescript"],
  "registries": [
    "runtimes/node",
    "build/vite",
    "frameworks/react"
  ]
}

Field Descriptions

$schema

• Type: string
• Required: No
• Description: Schema URL

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

name

• Type: string
• Required: Yes
• Description: Preset name (kebab-case)

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

version

• Type: string
• Required: Yes
• Format: Semantic versioning (semver)
• Description: Preset version

{
  "version": "1.0.0"
}

description

• Type: string
• Required: No
• Description: Preset description

{
  "description": "React tutorial project preset"
}

author

• Type: string
• Required: No
• Description: Author information

{
  "author": "John Doe"
}

tags

• Type: string[]
• Required: No
• Description: Tags

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

registries

• Type: string[]
• Required: Yes
• Description: List of registries; version can be specified

Format:

• Full format: @namespace/name or @namespace/name@version (for non-@rack namespaces)
• Shorthand format: name or name@version (CLI will automatically resolve to @rack/name, recommended for @rack registries)

Version format (follows semver):

• Exact version: runtimes/node@1.0.0 or @rack/runtimes/node@1.0.0
• Without version: runtimes/node (uses latest version)

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