Get help with Color Pair Studio

Answers, tips, and a direct line to support.

Latest version: 0.1.0 • Platform: macOS • Response time: 1–2 business days

Quick Start (3 steps)

  1. Paste a HEX or RGB. The inputs and color well stay in sync.

  2. Choose a mode.

    • Approximator—start from a system color and nudge Hue/Sat/Brightness (ΔE00 + WCAG live).

    • Derived Pair—generate a named Light/Dark asset pair with contrast guardrails.

  3. Export. ⌘E or Export… to copy SwiftUI snippet/asset instructions.

Keyboard Shortcuts

  • Generate: ⏎

  • Export Snippet: ⌘E

  • Toggle Light/Dark Preview: ⌘L

  • More Range (Approximator): ⌘R

How-to cards

Approximator

  • Paste hex (e.g., #9BBF9B) → choose base color shown → adjust Hue / Saturation / Brightness.

  • Watch ΔE00 (lower is closer) and WCAG (PASS/FAIL).

  • (Optional) Fix Contrast nudges brightness until AA passes.

  • Export Snippet… to copy SwiftUI code (uses .hueRotation/.saturation/.brightness).

Derived Pair

  • Paste hex → adjust Bias to balance Light vs. Dark twins.

  • See per-twin badges (white-text AA, background ≥3:1).

  • Export to Assets + SwiftUI for step-by-step asset naming and usage.

FAQs

  • What’s the difference between Approximator and Derived Pair?
    Approximator keeps you on system colors + modifiers (quick, flexible). Derived Pair creates a named Light/Dark asset that matches brand intent and autocompletes in Xcode.

  • Why does my color fail contrast?
    Some hues require darker/lighter adjustments to meet WCAG AA (4.5:1). Use Fix Contrast or pick a nearby brand-approved tint.

  • What does ΔE00 mean?
    It’s a perceptual difference score. <1 ≈ indistinguishable, 1–2 slight, 2–5 noticeable, >5 obvious.

  • Export shows no code on first try?
    Update to v0.1.0 or later; ⌘E and Export buttons open the sheet on first press.

  • Can I save color history?
    Not yet—on the roadmap. For now, copy snippets to a note or repo snippet file.

  • Does the app collect data?
    No. On-device only; no analytics. See Privacy below.

  • System requirements?
    macOS 14 or later; Apple silicon or Intel.

Troubleshooting

  • Export sheet doesn’t appear: Ensure you’re on v0.1.0+. Try ⌘E or the Export button; quit/relaunch if needed.

  • Colors look different between monitors: macOS color profiles can vary; ΔE00 is computed consistently, but visuals vary with display calibration.

  • Contrast still fails after Fix Contrast: Some targets can’t pass with white text while staying close to brand. Consider using black text or a brand-approved darker tint.

Known limitations (v0.1.0)

  • No project-level color history yet.

  • “More Range” can produce looks that feel less “native”—use judiciously.

  • Save-panel export omitted by design; export is copy-only.

Release notes

0.1.0 (Build 1)

  • Approximator with ΔE00 and WCAG badges, Fix Contrast, ⌘E.

  • Derived Pair with Bias, twin PASS/FAIL badges, export instructions, ⌘E.

  • ⌘L Light/Dark preview toggle.

  • Accessibility labels/values for key controls.

Privacy

Color Pair Studio runs entirely on your device and does not collect personal data. No accounts, no analytics, no network calls beyond macOS/App Store services.

Questions? support@touchdigitalsoftware.com