Getting started

Install emilyCSS, define tokens, generate CSS, and ship without runtime cost.

1. Install the package

Install emilyCSS in your project. The package is used at build time to generate static CSS and tooling JSON.

npm install emily-css

2. Create or update config

Use the setup wizard or edit emily.config.json directly. Define colours, spacing, typography, breakpoints, and output paths. New projects default to a stable single CSS filename.

npx emily-css init

3. Build for prod, watch for dev

Use build for purged/minified production CSS at output.css, and watch for full development CSS at output.fullCss.

npx emily-css build
npx emily-css watch

4. Link generated CSS

Reference the generated stylesheet in your app shell so utility classes are available in templates.

<link rel="stylesheet" href="./dist/emily.css">

5. Common follow-up commands

After setup: info shows a project overview without rebuilding. doctor checks for unknown classes. migrate generates a Tailwind mapping report. manifest regenerates tooling JSON. uninstall removes EmilyCSS from a project cleanly.

npx emily-css info
npx emily-css doctor
npx emily-css migrate
npx emily-css manifest
npx emily-css uninstall

Next step

When you're set up, use Utilities to inspect what your current config generated.