iridis

Chromatic pipeline for dynamic palette derivation. OKLCH-native, contrast-enforced, schema-validated, plugin-extensible.

Documentation

The full documentation is published at https://studnicky.github.io/iridis/. The site runs the live engine against its own brand palette; every chrome and syntax token on the page is the output of engine.run().

• Getting started — install, the smallest possible pipeline, the shape of the output.
• Try it out — edit seed colors and a role schema in the browser; the page recomputes through the engine on every keystroke.
• Pipeline, Role schemas, ColorRecord — engine concepts.
• Contrast and Accessibility calculations — WCAG 2.1 AA/AAA, APCA Lc targets, CVD simulation.
• Recipes — end-to-end snippets for the CLI, cascading CSS variables, and the Vue + Capacitor sample app.
• Reference — per-color-space pages (Hex, RGB, HSV, CMYK, OKLCH) and accessibility-standards pages (WCAG 2.1, APCA).

Requirements

Node.js >= 24 (matches engines.node in package.json).

Install

npm install @studnicky/iridis

Output targets (CSS variables, Tailwind, VS Code themes, native chrome, RDF graphs) ship as separate plugin packages; install only what you need:

npm install @studnicky/iridis-stylesheet @studnicky/iridis-tailwind @studnicky/iridis-vscode

License

MIT — see LICENSE.

Changelog

See CHANGELOG.md and the GitHub releases.