# Paircolors

Paircolors is a web color palette generator for designers. It creates five-color palettes for interface work and labels each color by role:

- background
- surface
- text
- primary
- accent

The app supports mood prompts, seed-color generation, live UI previews, WCAG contrast checks, favorites, shareable palette URLs, and export formats for CSS variables, Tailwind config, design tokens, SwiftUI, and PowerPoint themes.

## Palette URL Format

Palette URLs use `/p/` followed by five hex colors without leading `#` characters:

`/p/background-surface-text-primary-accent`

Example:

`/p/fff4e6-ffd9a8-2a1810-e85d3c-7c2d8f`

This represents:

- background: `#fff4e6`
- surface: `#ffd9a8`
- text: `#2a1810`
- primary: `#e85d3c`
- accent: `#7c2d8f`

Legacy hash URLs like `/#fff4e6-ffd9a8-2a1810-e85d3c-7c2d8f` are still accepted by the app and normalized to `/p/fff4e6-ffd9a8-2a1810-e85d3c-7c2d8f`.

## Machine-Readable Data

Useful paths:

- `/palettes.json`: curated gallery palettes with names, authors, role labels, and share URLs.
- `/sitemap.xml`: crawlable URL list.
- `/robots.txt`: crawler policy.

The live app also emits JSON-LD for the currently selected palette.

## Suggested Agent Tasks

Agents can use Paircolors to:

- Extract accessible palette tokens for a design system.
- Convert a shared palette URL into role-labeled color tokens.
- Compare palette color contrast for UI usage.
- Generate CSS variables, Tailwind colors, or design token JSON from a palette.