# graypegg/chromatism

:rainbow: A simple set of utility functions for colours.

Repository: https://github.com/graypegg/chromatism
Canonical: https://ross.abutalabs.com/products/chromatism
Language: JavaScript
License Family: other
Topics: hsl, tetrad, hue, rgb, ciexyz, chromatic-adaptation, triad, illuminants, color, color-modes, hue-shift, cielab, colour
Last push: 2024-03-09T18:23:17+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4022, "days_push": 907, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1763, forks 37 (observed 2026-08-28T04:05:32.930656+00:00)

## What it is
Chromatism is a small JavaScript utility library for colour manipulation, offering conversions between many colour modes (RGB, HSL, CIELAB, CIEXYZ, etc.) plus transformations like complementary, triad, and tetrad generation, hue shifting, blending, and greyscale/sepia filters. It also includes colour metering functions such as colour difference, colour temperature, and accessible foreground text colour determination.

## Use cases
- convert colors between rgb hsl cielab and other color spaces
- generate complementary triad and tetrad color palettes
- shift the hue or brightness of a color
- find an accessible text color for a background
- compute the difference between two colors
- create a fade or gradient between two colors
- apply chromatic adaptation for a white point

## When to choose
- you need a lightweight, dependency-free color utility in JavaScript for browser or Node
- you work with less common color spaces like CIELAB, CIEXYZ, or illuminants
- you need color harmony generation (triads, tetrads, complementary) or accessibility checks

## When to avoid
- you need GPU-accelerated or image-wide pixel processing rather than per-color operations
- you need a full color design system or theme generation framework
- you require an actively developed project with a guaranteed license

## Facets
- artifact type: library
- maturity: maintenance
- function: image-processing, ui-components
- domain: web-development, frontend, graphics
- platform: browser, cross-platform
- tags: color, color-conversion, color-spaces, hsl, rgb, cielab, ciexyz, color-harmony, accessibility, chromatic-adaptation, color-difference, javascript, nodejs

## Member repositories
- graypegg/chromatism (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:32.930656+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:26:45.688883+00:00, confidence not recorded.
  - readme: https://github.com/graypegg/chromatism (fetched 2026-08-28T04:05:32.930656+00:00, sha a5f8d3ed89e9)
- Data as of 2026-08-30T08:39:29.467469+00:00.