CtrlCSS is a minimal utility class CSS generator.
It scans template files (e.g. .heex, .html) from stdin, extracts class names, matches them against a user-defined theme, and emits only the necessary CSS rules.
cat index.html | ctrlcss > styles.cssgit clone https://github.com/andreamancuso/ctrlcss.git
cd ctrlcss
go build -o ctrlcss ./cmd/ctrlcss- Go 1.18 or newer
Create a ctrlcss.theme.toml file in the working directory:
[spacing]
0 = "0"
1 = "0.25rem"
2 = "0.5rem"
4 = "1rem"
8 = "2rem"
12 = "3rem"
[colors]
white = "#ffffff"
black = "#000000"
blue-500 = "#3b82f6"
gray-800 = "#1f2937"CtrlCSS emits one CSS rule per line, based on matched classes.
| OS | Arch | Notes |
|---|---|---|
| Linux | amd64 | x86_64, standard builds |
| Linux | arm64 | ARMv8 / Apple Silicon |
| Linux | arm | ARMv7 / Raspberry Pi |
| Linux | riscv64 | Milk-V Mars, VisionFive, etc. |
| macOS | amd64 | Intel Macs |
| macOS | arm64 | M1/M2/M3 Macs |
| Windows | amd64 | 64-bit Windows |
| Windows | arm64 | Surface Pro (ARM) |
MIT