Using the CLI

Install the compiler

Install the core package as a development dependency. Its binary is exposed as coordiation-css.

npm install -D @coordiation/css

Create the CSS input

Add the framework marker and split repeatable design decisions into local imports when useful.

@import "./theme.css";
@coordiation;

@co-theme {
  --co-color-brand-500: oklch(62.3% 0.214 259.815);
  --co-radius-card: 1rem;
}

Build once

Use one-shot mode in production builds and CI. Add --minify and explicit targets when the distributed CSS should be compact and its browser contract pinned.

coordiation-css \
  --input src/coordiation.css \
  --output dist/coordiation.css \
  --content src \
  --minify \
  --target chrome=111 \
  --target safari=15.4

Import or link the generated dist/coordiation.css from your application. The result contains static CSS only.

Watch during development

Add --watch to build immediately and then rescan after content changes. Portable content polling avoids relying on filesystem-specific recursive watch behavior.

coordiation-css \
  --input src/coordiation.css \
  --output dist/coordiation.css \
  --content src \
  --watch

Tune polling only when needed

The default interval is 250ms. Slower intervals reduce metadata checks in very large projects or on network and container-mounted filesystems.

coordiation-css -i src/coordiation.css -o dist/coordiation.css -c src --watch --poll 500

The minimum is 25ms. Unchanged files become scanner hits, unchanged compilation becomes a compiler hit, and no output write occurs when the final fingerprint is unchanged.

Recover and stop cleanly

A missing input or temporarily unavailable source root is reported once while the watcher remains active. Restore the file and the next successful poll rebuilds automatically. Press Ctrl+C, or send SIGTERM, to finish the active build and stop with a successful exit.

Coordiation CSS: watching 1 source root every 250ms.
Coordiation CSS: build 1 complete — 14 files, 82 candidates, 0 rejected, 0 scan hits, 14 misses, compile miss in 18ms.
Coordiation CSS: build failed — ENOENT: no such file or directory, open 'src/coordiation.css'
Coordiation CSS: build 2 complete — 14 files, 82 candidates, 0 rejected, 14 scan hits, 0 misses, compile hit in 4ms.
Coordiation CSS: watch stopped.