Agent guide

Use this page as a routing index. Read the smallest page that answers the current task instead of loading the entire documentation set.

The compact machine-readable route index is available at /llms.txt.

Choose the relevant page

• Install or create a first config: Getting started
• Understand references and config structure: Configuration
• Configure a token family: Colors, Spacing, Typography, or Primitives
• Run the CLI or call the API: Using CSS Forge
• Read or import the generated CSS, TS, or JSON: Output formats
• Integrate with a framework: Examples

Repository sources of truth

The root README.md is canonical. Its generated package copy at packages/cssforge/README.md should not be edited directly.

• Public exports
• Configuration types
• CLI implementation
• Generated reference source
• Example projects

Distribution

Each release publishes the same version to npm and to JSR.

• Install: npm install --save-dev @hebilicious/cssforge or pnpm add -D @hebilicious/cssforge
• Import: import { defineConfig } from "@hebilicious/cssforge";
• Run: the package exposes a cssforge executable, so run it directly (cssforge --mode all, or npx cssforge --mode all with npm)
• Deno: deno add jsr:@hebilicious/cssforge, then deno run -A jsr:@hebilicious/cssforge/cli
• Runtime: Node 24 or newer, which loads cssforge.config.ts without a loader or tsx

Agent workflow

1. Identify whether the task concerns installation, a token family, references, CLI behavior, or framework integration.
2. Read the matching focused page above.
3. Use the linked repository source when exact types or current runtime behavior matter.
4. Change the user’s config rather than generated CSS output.
5. Run the project’s existing CSS Forge generation command and inspect its declared output.

Context hint

For agents that accept URL context, the complete generated reference remains available from the repository README:

@https://raw.githubusercontent.com/Hebilicious/cssforge/refs/heads/main/README.md