CLI Overview

The TokiForge CLI is a powerful command-line tool for managing design tokens.

Installation

Global Installation

npm install -g tokiforge-cli@^1.0.0

Local Usage

npx tokiforge-cli@^1.0.0 <command>

Commands

init

Initialize TokiForge in your project.

tokiforge init

Creates:

• tokens.json - Default token definitions
• tokiforge.config.json - Configuration file

build

Build and export tokens to various formats.

tokiforge build

Generates files based on your tokiforge.config.json:

• CSS custom properties
• JavaScript/TypeScript exports
• SCSS variables
• JSON output

dev

Start development server with live theme preview.

tokiforge dev

Opens a preview server at http://localhost:3000 where you can:

• See all your themes
• Switch between themes
• Preview color tokens
• Live reload on token changes

lint

Validate token consistency and accessibility.

tokiforge lint

Checks:

• Token structure validity
• Color contrast ratios
• Duplicate token names
• Missing references

Configuration

Edit tokiforge.config.json to customize:

{
  "input": "./tokens.json",
  "output": {
    "css": "./dist/tokens.css",
    "js": "./dist/tokens.js",
    "ts": "./dist/tokens.ts",
    "scss": "./dist/tokens.scss"
  },
  "themes": [
    {
      "name": "light",
      "tokens": {}
    }
  ],
  "defaultTheme": "light",
  "prefix": "hf",
  "selector": ":root"
}

Workflow

1. Initialize - tokiforge init
2. Edit tokens - Modify tokens.json
3. Preview - tokiforge dev
4. Build - tokiforge build
5. Lint - tokiforge lint

Next Steps

• See Commands for detailed command documentation
• Learn about Configuration options