| Palette colors look disconnected | Random generation may produce unrelated hues or extreme saturation | Try Smart or Harmony mode, reduce saturation and establish a consistent base hue. |
| Changing the palette loses my favorite color | The chosen swatch was not locked | Lock it before regenerating or shuffling the others. |
| HEX input is rejected | The value may use unsupported characters or a malformed length | Enter a valid HEX color such as #10B981 and retry. |
| Keyword palette does not match my idea | Curated keyword mappings are interpretive rather than remote language understanding | Try a more concrete keyword or start from an explicit base color. |
| AI mode did not generate detailed text | The AI-labelled mode uses local color heuristics rather than a conversational LLM | Use keyword mode for colors, not natural-language design explanations. |
| Uploaded image produces unexpected colors | Dominant backgrounds, compression or lighting may skew extraction | Use a cleaner image, remove irrelevant background or select desired extracted colors manually. |
| Brand HEX differs from extracted logo | Antialiasing and color processing can change pixel values | Use the authoritative brand style guide and lock its exact HEX code. |
| Generated colors fail contrast | Hue harmony does not imply sufficient luminance difference | Adjust text or surface colors until the specific WCAG ratio passes. |
| A palette passes AA but is hard to read | Passing a ratio is only one usability factor | Review font size, weight, context, background images and device display conditions. |
| Text over gradient disappears in one area | Gradient brightness changes across positions | Test the entire text region and consider a solid background or overlay. |
| Colors look the same in a color-blindness preview | Hue information may collapse in that simulated vision mode | Add lightness contrast, direct labels, patterns or icons. |
| Dark theme looks overly bright | The light palette was reused without rebalancing | Generate or refine a distinct dark-mode ramp and retest contrast. |
| Tailwind export does not match my configuration | Tool output and project naming or version expectations may differ | Check generated keys against your Tailwind version and configuration file. |
| Figma token import fails | A plugin may expect a different token schema | Inspect exported JSON and map it to the target plugin requirements. |
| CSS colors work but names are confusing | Generated variable names may not match project semantics | Rename them to background, foreground, primary and related role-based tokens. |
| Saved palettes are gone | Browser storage may have been cleared or a different profile opened | Restore from an exported file if available; use backups for important work. |
| Offline palette library is unavailable | App assets may not be cached in this browser | Open the site online first and check browser offline settings. |
| Image upload does not open | The browser may reject the file or lack resources | Try a common supported image type with a smaller file and reload the page. |
| PDF swatches look different in print | Color profiles and physical reproduction differ from browser display | Confirm printer settings and request a physical proof for production. |
| Copied values do not paste | Clipboard permission or browser restrictions may block copying | Use a supported secure browser context or select and copy the value manually. |
| Keyboard shortcuts do not respond | Focus may be inside a form or a browser shortcut may take precedence | Click the palette workspace and inspect the page shortcut guidance. |
| Colors do not match across devices | Displays have different gamuts, calibration and brightness | Use documented color values and inspect on representative target displays. |
| Gradient CSS behaves differently in another browser | Rendering and feature support may vary | Test exported code in target browsers and simplify unsupported styles. |
| Too many colors compete for attention | The design lacks a clear role hierarchy | Choose one dominant color, reserve accents and use neutrals for content surfaces. |