apps/irix
Irix
Architectonic Color Palette
Irix is an architectonic color palette system based on Radix colors, with a set of CLI tools to apply it.
Read command transcript
$ uv run promptcode --fmt ansi --path ../doering-ai
doering-ai
$ uv run promptcode --fmt ansi --path ../../sublime/syntaxes/regex
regex
$ uv run promptcode --fmt ansi --path ../../corpus/journal/reports
corpus/j/reports
$ uv run colorcode show
override: blue (#032131)
effective: blue (#032131)
What it shows
What it is and what it demonstrates.
Irix is an architectonic color palette system built on Radix colors, with CLI tooling to generate, validate, and apply a coherent token set across web and terminal surfaces. It is the color backbone for this portfolio and several fleet tools.
The problem
A multi-surface portfolio and a fleet of CLI tools need one color system that stays perceptually uniform across light and dark themes, keeps accessible contrast at every step, and can be regenerated from a single source rather than hand-maintained in each consumer. Ad-hoc palettes drift, break contrast, and force per-project fixes.
The approach
Irix adapts Radix's role-and-step grammar into an architectonic token set: a fixed role vocabulary (ground, ink, structure, life, urgency) mapped to hue scales, with CLI commands to emit CSS variables, terminal palette entries, and validation reports from one declaration. The same generator produces the site's tokens and the Sublime color scheme, so a theme change propagates without manual sync.
What it demonstrates
A published, versioned palette library with CI, pre-commit hooks, typed source, and a test surface applies the same engineering care to the part of a product most teams treat as hand-tuning — design infrastructure treated as real software.
Repository evidence
Observable facts.
- Documentation
- 8 documentation files
- Test surface
- 12 test files
- Continuous integration
- Configured
- Pre-commit hooks
- Configured
- Typed source
- Configured
- Visual evidence
- Reproducible CLI demonstration
- Technologies
- py · pypi · web