rack.json

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

Example

{
  "$schema": "https://registry.rackjs.com/schemas/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://registry.rackjs.com/schemas/rack.json"
}

name

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

{
  "name": "my-project"
}

language

• Type: string ("js" | "ts")
• Required: No
• Description: Project language

Allowed 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, @namespace/name@version, or @namespace/name:language (for non-@rack namespaces)
• Shorthand format: name, name@version, or name:language (CLI will automatically resolve to @rack/name, recommended for @rack registries)
• Language suffix (:js or :ts) is optional and specifies the language variant

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"]
}