rack.json

rack.json is the project configuration file that defines the project's language, template, registry sources, and other information.

Example

{
  "$schema": "https://rackjs.com/schema/rack.json",
  "name": "my-project",
  "language": "ts",
  "template": "react-tutorial-project",
  "items": [
    "runtimes/node@1.0.0",
    "build/vite",
    "frameworks/react"
  ]
}

Field Descriptions

$schema

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

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

name

• Type: string
• Required: Yes
• Description: Project name

{
  "name": "my-project"
}

language

• Type: string
• Required: No
• Description: Project language

Common values:

• "ts" - TypeScript
• "js" - JavaScript

{
  "language": "ts"
}

template

• Type: string
• Required: No
• Description: Template name used

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

items

• Type: string[]
• Required: No
• Description: List of installed 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)

{
  "items": [
    "runtimes/node@1.0.0",
    "build/vite",
    "frameworks/react"
  ]
}