# ColorFYI

> Comprehensive color reference for developers and designers. 16.7M hex colors computed on-the-fly, 809 named colors (CSS, X11, Crayola, Pantone, RAL, NCS), 544 brand color palettes, 103 color theory glossary terms, 215 blog articles, and 6 interactive tools (WCAG contrast, converter, palette generator, shade generator, color blindness simulator, gradient generator).

## Data Scope
- 16.7M hex colors with RGB, HSL, HSV, CMYK, OKLCH values computed on-the-fly (<1ms)
- 809 named colors across 9 sources: CSS, X11, Crayola, Pantone, RAL, NCS, Brand, Cultural, Custom
- 544 brand color palettes (484 regular + 60 crypto) with 1,335 individual brand colors
- 23+ themed color collections (Pantone, Tailwind CSS, Radix UI, Ant Design, Obangsaek, Japanese Traditional)
- 103 color theory glossary terms with definitions and related resources
- 139 color name glossary entries with etymology, history, and cultural significance
- 215 blog articles across 8 categories (color theory, brand stories, design guides)
- 15 curated color palettes
- 6 interactive tools: WCAG Contrast Checker, Color Converter, Palette Generator, Shade Generator, Color Blindness Simulator, Gradient Generator
- Color harmonies: complementary, triadic, tetradic, split-complementary, analogous
- WCAG 2.1 contrast ratio with AA/AAA compliance checks
- Tailwind-style shade scales (50-950) for any color
- Color blindness simulation: deuteranopia, protanopia, tritanopia

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/color/{hex}/` — Color detail page for any 6-digit hex (e.g. `/color/FF6B35/`)
- `/color/{slug}/` — Named color by slug (e.g. `/color/tiffany-blue/`)
- `/color/named/` — Browse all 809 named colors with source filter (e.g. `/color/named/`)
- `/color/rgb-{R}-{G}-{B}/` — RGB redirect to hex detail (e.g. `/color/rgb-14-165-233/`)
- `/color/hsl-{H}-{S}-{L}/` — HSL redirect to hex detail (e.g. `/color/hsl-199-89-48/`)
- `/family/` — Color families (red, blue, green, ...) (e.g. `/family/`)
- `/family/{slug}/` — Color family detail (e.g. `/family/red/`)
- `/tone/` — Color tones (pastel, neon, earth, ...) (e.g. `/tone/`)
- `/tone/{slug}/` — Color tone detail (e.g. `/tone/pastel/`)
- `/design-system/` — Design system color palettes (e.g. `/design-system/`)
- `/design-system/{slug}/` — Design system detail (e.g. `/design-system/tailwind-css/`)
- `/meaning/` — Color meanings and symbolism (e.g. `/meaning/`)
- `/meaning/{slug}/` — Color meaning detail (e.g. `/meaning/passion/`)
- `/brands/` — Brand color palettes grouped by category (e.g. `/brands/`)
- `/brands/{slug}/` — Brand color palette detail (e.g. `/brands/google/`)
- `/brands/category/{cat}/` — Brand category page (e.g. `/brands/category/tech/`)
- `/collections/` — Themed color collections (e.g. `/collections/`)
- `/collections/{slug}/` — Collection detail (e.g. `/collections/korean-obangsaek/`)
- `/collections/category/{cat}/` — Collection category page (e.g. `/collections/category/cultural/`)
- `/glossary/` — Color name glossary index (e.g. `/glossary/`)
- `/glossary/{slug}/` — Color name: etymology, history, usage (e.g. `/glossary/cerulean/`)
- `/glossary/terms/{slug}/` — Color theory term definition (e.g. `/glossary/terms/hue/`)
- `/palettes/` — Curated color palettes (e.g. `/palettes/`)
- `/palettes/{slug}/` — Palette detail (e.g. `/palettes/sunset-warmth/`)
- `/blog/` — Color articles and guides (e.g. `/blog/`)
- `/blog/{slug}/` — Blog article (e.g. `/blog/korean-obangsaek/`)
- `/blog/category/{slug}/` — Blog category (e.g. `/blog/category/color-theory/`)
- `/tools/` — Interactive color tools index (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/contrast-checker/`)
- `/compare/` — Color comparison tool (e.g. `/compare/`)
- `/compare/{hex1}-vs-{hex2}/` — Compare two colors (e.g. `/compare/000000-vs-FFFFFF/`)
- `/compare/{hex1}-vs-{hex2}-vs-{hex3}/` — Compare three colors (e.g. `/compare/FF0000-vs-00FF00-vs-0000FF/`)
- `/graph/` — Interactive color knowledge graph (e.g. `/graph/`)
- `/search/` — Search named colors, brands, collections (e.g. `/search/?q=blue`)

## Browse Colors
- [All Named Colors (809)](http://localhost:8005/color/named/)
- [Color Families](http://localhost:8005/family/)
- [Color Tones](http://localhost:8005/tone/)
- [Design Systems](http://localhost:8005/design-system/)
- [Color Meanings](http://localhost:8005/meaning/)

## Interactive Tools
- [WCAG Contrast Checker](http://localhost:8005/tools/contrast-checker/)
- [Color Converter (HEX/RGB/HSL/CMYK/OKLCH)](http://localhost:8005/tools/converter/)
- [Palette Generator (Harmonies)](http://localhost:8005/tools/palette-generator/)
- [Shade Generator (Tailwind-style 50-950)](http://localhost:8005/tools/shade-generator/)
- [Color Blindness Simulator](http://localhost:8005/tools/color-blindness-simulator/)
- [Gradient Generator (CSS)](http://localhost:8005/tools/gradient-generator/)
- [Color Comparison Tool](http://localhost:8005/compare/)

## Brand Colors
- [All Brands (544)](http://localhost:8005/brands/)
- [Technology](http://localhost:8005/brands/category/tech/)
- [Social Media](http://localhost:8005/brands/category/social/)
- [Cryptocurrency](http://localhost:8005/brands/category/crypto/)
- [Fashion](http://localhost:8005/brands/category/fashion/)
- [Food & Beverage](http://localhost:8005/brands/category/food/)
- [Finance](http://localhost:8005/brands/category/finance/)
- [Design](http://localhost:8005/brands/category/design/)

## Color Collections
- [All Collections](http://localhost:8005/collections/)
- [Korean Obangsaek](http://localhost:8005/collections/korean-obangsaek/)
- [Japanese Traditional](http://localhost:8005/collections/japanese-traditional/)
- [Pantone Color of the Year 2025](http://localhost:8005/collections/pantone-2025/)
- [Tailwind CSS Colors](http://localhost:8005/collections/tailwind-red/)
- [Radix UI Colors](http://localhost:8005/collections/radix-tomato/)
- [Ant Design Colors](http://localhost:8005/collections/antd-red/)
- [Cultural](http://localhost:8005/collections/category/cultural/)
- [Design Systems](http://localhost:8005/collections/category/design/)

## Glossary
- [Color Name Glossary (139 entries)](http://localhost:8005/glossary/)
- [Color Theory Terms (103 terms)](http://localhost:8005/glossary/?view=terms)

## Blog
- [All Articles (215)](http://localhost:8005/blog/)
- [Korean Obangsaek: Five Directional Colors](http://localhost:8005/blog/korean-obangsaek/)
- [Psychology of Yellow](http://localhost:8005/blog/psychology-of-yellow/)
- [Color Theory](http://localhost:8005/blog/category/color-theory/)
- [Brand Stories](http://localhost:8005/blog/category/brand-stories/)
- [Design Guides](http://localhost:8005/blog/category/design-guides/)

## Palettes
- [Curated Palettes (15)](http://localhost:8005/palettes/)

## Knowledge Graph
- [Interactive Color Knowledge Graph](http://localhost:8005/graph/)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/color/{hex}/` | Full color info (RGB, HSL, HSV, CMYK, OKLCH, harmonies, shades) |
| GET | `/api/contrast/?fg={hex}&bg={hex}` | WCAG contrast ratio + AA/AAA compliance |
| GET | `/api/search/?q={query}` | Search named colors and brands |
| GET | `/api/harmonies/{hex}/` | Color harmonies (complementary, triadic, etc.) |
| GET | `/api/shades/{hex}/` | Tailwind-style shade scale (50-950) |
| GET | `/api/blindness/{hex}/` | Color blindness simulation |
| GET | `/api/compare/?colors={hex1},{hex2}` | Compare multiple colors |
| GET | `/api/mix/?colors={hex1},{hex2}` | Mix colors |
| GET | `/api/gradient/?from={hex}&to={hex}` | Generate gradient steps |
| GET | `/api/palette/{hex}/` | Palette suggestions for a color |
| GET | `/api/named-colors/` | List all named colors |
| GET | `/api/graph/` | Knowledge graph nodes and edges |
| GET | `/api/v1/colors/` | Named colors (DRF, paginated) |
| GET | `/api/v1/brands/` | Brands (DRF, paginated) |
| GET | `/api/v1/posts/` | Blog posts (DRF, paginated) |
| GET | `/api/v1/glossary/` | Glossary terms (DRF, paginated) |
| GET | `/api/v1/collections/` | Collections (DRF, paginated) |
| GET | `/api/v1/tools/` | Interactive tools (DRF, paginated) |
| GET | `/api/v1/faqs/` | FAQs (DRF, paginated) |
| GET | `/api/v1/search/?q={query}` | Unified search (DRF) |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://colorfyi.com/api/color/FF6B35/"
```

[API Docs](http://localhost:8005/developers/) · [OpenAPI Spec](http://localhost:8005/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install colorfyi` — [colorfyi](https://pypi.org/project/colorfyi/) — Color conversion, WCAG contrast, harmonies (v0.2.2)
- **npm**: `npm install @fyipedia/colorfyi` — [@fyipedia/colorfyi](https://www.npmjs.com/package/@fyipedia/colorfyi) — TypeScript color utilities (v0.1.2)
- **Embed Widget**: [colorfyi-embed](https://widget.colorfyi.com)

## Creative FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [FontFYI](https://fontfyi.com) — Google Fonts metadata, CSS generation, pairings
- [EmojiFYI](https://emojifyi.com) — 3,953 emojis, Unicode Emoji 16.0, 8 encodings
- [SymbolFYI](https://symbolfyi.com) — Symbol encoding in 11 formats, Unicode properties
- [UnicodeFYI](https://unicodefyi.com) — Unicode characters, 17 encodings, HTML entities

## Images (CDN)

OG images for all entities at https://cdn.colorfyi.com/og/{type}/{slug}.png
- https://cdn.colorfyi.com/og/homepage.png
- https://cdn.colorfyi.com/og/brands/google.png
- https://cdn.colorfyi.com/og/collections/korean-obangsaek.png

## Full Index
- [Full content index](http://localhost:8005/llms-full.txt)
- [XML Sitemap](http://localhost:8005/sitemap.xml)