Methodology
How Hue Codex calculates, ranks, and exports color.
Read the formulas, assumptions, edge cases, validation checks, and limits behind the tools, from WCAG contrast and OKLCH conversion to image extraction and export formats.
Trust boundary
What is standards-based vs Hue Codex heuristic?
Hue Codex separates external formulas from product guidance. WCAG contrast math and stable CSS color conversion are standards-based; palette ranking, role hints, color-difference bands, and CVD risk labels are Hue Codex heuristics for review.
Standards-based
Used when an external standard defines the formula, threshold, syntax, or data behavior. Examples include WCAG relative luminance, WCAG contrast thresholds, stable CSS Color 4 conversion behavior, and CSS named color definitions.
Hue Codex heuristic
Used when Hue Codex adds product judgment on top of the math. Examples include palette ranking, role hints, highest-contrast candidate recommendations, color-difference bands, image swatch scoring, and color-vision risk labels.
| User question | Standards-based part | Hue Codex heuristic part |
|---|---|---|
| Does this text pair pass? | WCAG luminance and contrast thresholds decide pass/fail from the raw ratio. | Suggested replacement colors rank candidates by search distance and usefulness. |
| Which palette colors should become roles? | WCAG metadata can flag readable foreground/background pairs. | Primary, accent, surface, semantic role hints, and palette ranking are Hue Codex guidance. |
| Are two colors different enough? | Delta E 76 and OKLab distance use documented color-space math. | Labels such as close variant, distinct palette color, or hue-only risk are review bands. |
Color Picker source of truth
Repair, distance, and export contracts.
The Color Picker uses three connected methodology pages. Together they define the role-scoped contrast decision, the bounded OKLab repair objective, and each separately labeled export contract.
Repair 2.0 and contrast
Raw WCAG ratios, alpha compositing, one-to-four-context validation, deterministic tie-breakers, exact sRGB revalidation, and known bounded-search limits.
Read repair methodologyOKLab distance objective
Defines the scaled Euclidean OKLab distance used by the minimal-change strategy and keeps it separate from CIE76 reference values and accessibility claims.
Read distance methodologyDTCG and Tailwind exports
Separates semantic CSS, Tailwind v4, Hue Codex token-style JSON, DTCG Format/Color, Resolver, legacy JavaScript, reports, and SCSS.
Read export methodologyGlobal caveats
Known limitations across all tools.
These limits apply across Hue Codex even when a specific tool has more detailed validation notes on its methodology page.
Generated palettes are starting points
Palette rankings, role hints, harmony choices, and semantic suggestions help begin a color system, but they still need brand, product, content, and component review.
Contrast is not full accessibility
WCAG contrast ratios are important standards-based checks, but accessible design also depends on typography, layout, state cues, labels, motion, interaction, and assistive technology behavior.
Image extraction is approximate
Extracted palettes depend on sampling, compression, transparency, canvas pixels, browser color management, and the image content selected for analysis.
Print values are not press proofs
CMYK and print-oriented values are communication aids, not press-ready conversions. Final print work needs ICC profiles, stock, ink limits, proofing, and vendor guidance.
Validation resources
Schemas and color-math fixtures for reproducible checks.
Download the public JSON fixture groups used for representative parsing, contrast, conversion, palette, export, and image-sampling regression checks, along with the export schemas and handoff fixtures.
Methodology library
Shared trust pages for the toolset.
Each page supports multiple tools so the formulas, standards, assumptions, validation examples, and caveats stay consistent across Hue Codex.
Coverage matrix
Which methodology pages explain each tool output.
This matrix follows the public Tools page order and uses the same methodology mapping shown on individual tool pages.
| Tool | Contrast | Conversion | Palette | Mixing | Gamut | Difference | CVD | Image | Export | Reference |
|---|---|---|---|---|---|---|---|---|---|---|
| Color Picker Tool group: Core tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Covered: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Color Converter Tool group: Core tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Covered: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Contrast Checker Tool group: Core tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Palette Generator Tool group: Core tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| CSS Color Generator Tool group: CSS tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Covered: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| CSS Gradient Generator Tool group: CSS tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Covered: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Color Harmonies Tool group: Palette tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Covered: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Tint, Shade, and Tone Generator Tool group: Palette tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Covered: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Accessible Text Color Tool group: Palette tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| CSS Named Colors Reference Tool group: Reference tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Covered: Reference methodology. |
| Color Glossary Tool group: Reference tools | Not applicable: Contrast methodology. | Not applicable: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Covered: Reference methodology. |
| Color Model Comparison Tool group: Reference tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Covered: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Gamut Checker Tool group: Reference tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Covered: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Color Difference Calculator Tool group: Reference tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Color Mixer Tool group: Adjustment tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Covered: Mixing methodology. | Not applicable: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Opacity Calculator Tool group: Adjustment tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Covered: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Color Temperature Adjuster Tool group: Adjustment tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Covered: Mixing methodology. | Covered: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Saturation and Chroma Adjuster Tool group: Adjustment tools | Not applicable: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Not applicable: Mixing methodology. | Covered: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Lightness Ladder Generator Tool group: Adjustment tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Covered: Mixing methodology. | Not applicable: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Gradient Palette Extractor Tool group: Adjustment tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Covered: Mixing methodology. | Not applicable: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Color Blindness Simulator Tool group: Accessibility tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Covered: Difference methodology. | Covered: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Accessible Pair Finder Tool group: Accessibility tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Covered: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Focus Ring Contrast Tool Tool group: Accessibility tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Link Color Checker Tool group: Accessibility tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Covered: CVD methodology. | Not applicable: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Image Eyedropper Tool group: Image tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Not applicable: Difference methodology. | Not applicable: CVD methodology. | Covered: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Image Palette Extractor Tool group: Image tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Covered: Palette methodology. | Not applicable: Mixing methodology. | Not applicable: Gamut methodology. | Covered: Difference methodology. | Covered: CVD methodology. | Covered: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |
| Duotone Generator Tool group: Image tools | Covered: Contrast methodology. | Covered: Conversion methodology. | Not applicable: Palette methodology. | Covered: Mixing methodology. | Covered: Gamut methodology. | Covered: Difference methodology. | Not applicable: CVD methodology. | Covered: Image methodology. | Covered: Export methodology. | Not applicable: Reference methodology. |