# SymbolFYI

> Comprehensive symbol and special character reference for developers and designers. 4,947 symbols with Unicode data, encoding in 11 formats (UTF-8, UTF-16, HTML entity, CSS, URL-encoded, etc.), 30 categories, 25 curated collections, 84 glossary terms, 75 guides across 8 series, and 9 interactive tools.

## Data Scope
- 4,947 symbols with full Unicode metadata (codepoint, name, block, script, general category)
- 11 encoding formats per symbol: UTF-8, UTF-16 BE/LE, UTF-32, HTML decimal/hex entity, CSS, URL-encoded, JSON, XML
- 30 symbol categories (mathematical, arrows, currency, punctuation, dingbats, etc.)
- 25 curated symbol collections (e.g., math operators, card suits, zodiac, chess)
- Unicode block and super-block browser (118+ blocks grouped into 20 super-blocks)
- 84 glossary terms covering Unicode encoding, typography, and character standards
- 75 guides across 8 series (Unicode fundamentals, typography, encoding, etc.)
- 9 interactive tools: search, text symbols, unicode lookup, character counter, symbol table, encoding converter, text diff, string length, HTML entity search
- Use case pages for common symbol needs (e.g., symbols for math, currency, music)
- N² symbol comparison pages (side-by-side encoding, properties, usage)

## 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).
- `/symbol/{slug}/` — Symbol detail with 11 encodings and Unicode properties (e.g. `/symbol/black-heart-suit/`)
- `/char/U+{codepoint}/` — Character by Unicode codepoint (e.g. `/char/U+2665/`)
- `/category/` — Browse all 30 symbol categories (e.g. `/category/`)
- `/category/{slug}/` — Category detail with symbols (e.g. `/category/math/`)
- `/collection/` — Browse 25 curated collections (e.g. `/collection/`)
- `/collection/{slug}/` — Collection detail (e.g. `/collection/zodiac-signs/`)
- `/block/` — Unicode blocks browser (e.g. `/block/`)
- `/block/{slug}/` — Block detail with characters (e.g. `/block/arrows/`)
- `/browse/` — Super-block browser (grouped blocks) (e.g. `/browse/`)
- `/browse/{slug}/` — Super-block detail (e.g. `/browse/symbols-and-punctuation/`)
- `/symbols-for/` — Use case index (symbols for specific needs) (e.g. `/symbols-for/`)
- `/symbols-for/{slug}/` — Use case detail (e.g. `/symbols-for/math/`)
- `/glossary/` — Symbol and Unicode glossary (84 terms) (e.g. `/glossary/`)
- `/glossary/{slug}/` — Glossary term definition (e.g. `/glossary/utf-8/`)
- `/guides/` — All guides (75 articles) (e.g. `/guides/`)
- `/guides/series/` — Guide series (8 series) (e.g. `/guides/series/`)
- `/guides/series/{slug}/` — Guide series detail (e.g. `/guides/series/unicode-fundamentals/`)
- `/guides/{slug}/` — Guide detail (e.g. `/guides/unicode-introduction/`)
- `/tools/` — Interactive tools index (9 tools) (e.g. `/tools/`)
- `/tools/{slug}/` — Tool page (e.g. `/tools/encoding-converter/`)
- `/compare/` — Symbol comparison index (e.g. `/compare/`)
- `/compare/{slug1}-vs-{slug2}/` — Compare two symbols (e.g. `/compare/em-dash-vs-en-dash/`)
- `/search/` — Search symbols by name, codepoint, or keyword (e.g. `/search/?q=arrow`)

## Browse Symbols
- [All Categories (30)](http://localhost:8010/category/)
- [Mathematical Symbols](http://localhost:8010/category/math/)
- [Arrows](http://localhost:8010/category/arrows/)
- [Currency Symbols](http://localhost:8010/category/currency/)
- [Punctuation & Typography](http://localhost:8010/category/punctuation/)
- [Dingbats & Ornaments](http://localhost:8010/category/dingbats/)
- [Box Drawing & Block Elements](http://localhost:8010/category/box-drawing/)
- [Curated Collections (25)](http://localhost:8010/collection/)

## Browse by Unicode
- [Unicode Blocks (118+)](http://localhost:8010/block/)
- [Super Blocks (20)](http://localhost:8010/browse/)
- [Symbols by Use Case](http://localhost:8010/symbols-for/)

## Interactive Tools
- [Symbol Search](http://localhost:8010/tools/search/)
- [Text Symbols Picker](http://localhost:8010/tools/text-symbols/)
- [Unicode Lookup](http://localhost:8010/tools/unicode-lookup/)
- [Character Counter](http://localhost:8010/tools/character-counter/)
- [Symbol Table Generator](http://localhost:8010/tools/symbol-table/)
- [Encoding Converter](http://localhost:8010/tools/encoding-converter/)
- [Text Diff Tool](http://localhost:8010/tools/text-diff/)
- [String Length Analyzer](http://localhost:8010/tools/string-length/)
- [HTML Entity Search](http://localhost:8010/tools/html-entity-search/)
- [Symbol Comparison Tool](http://localhost:8010/compare/)

## Glossary
- [Symbol & Unicode Glossary (84 terms)](http://localhost:8010/glossary/)

## Guides
- [All Guides (75)](http://localhost:8010/guides/)
- [Guide Series (8)](http://localhost:8010/guides/series/)

## REST API

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

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/symbols/` | List all symbols (DRF, paginated) |
| GET | `/api/v1/symbols/{slug}/` | Symbol detail with 11 encodings |
| GET | `/api/v1/categories/` | List symbol categories |
| GET | `/api/v1/categories/{slug}/` | Category detail |
| GET | `/api/v1/collections/` | List symbol collections |
| GET | `/api/v1/collections/{slug}/` | Collection detail |
| GET | `/api/v1/glossary/` | Glossary terms (DRF, paginated) |
| GET | `/api/v1/glossary/{slug}/` | Glossary term detail |
| GET | `/api/v1/faqs/` | FAQs (DRF, paginated) |
| GET | `/api/v1/guides/` | Guide articles (DRF, paginated) |
| GET | `/api/v1/guides/{slug}/` | Guide detail |
| GET | `/api/v1/guide-categories/` | Guide categories |
| GET | `/api/v1/guide-series/` | Guide series |
| GET | `/api/v1/tools/` | Interactive tools (DRF, paginated) |
| GET | `/api/v1/search/?q={query}` | Search symbols by name or codepoint |
| GET | `/api/v1/stats/` | Site statistics |

```bash
curl -s "https://symbolfyi.com/api/v1/symbols/black-heart-suit/"
```

[API Docs](http://localhost:8010/developers/) · [OpenAPI Spec](http://localhost:8010/api/v1/schema/)

## Developer Tools
- **PyPI**: `pip install symbolfyi` — [symbolfyi](https://pypi.org/project/symbolfyi/) — Symbol encoding in 11 formats (v0.2.2)
- **npm**: `npm install symbolfyi` — [symbolfyi](https://www.npmjs.com/package/symbolfyi) — TypeScript symbol utilities (v0.1.2)
- **Embed Widget**: [symbolfyi-embed](https://widget.symbolfyi.com)

## Creative FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [ColorFYI](https://colorfyi.com) — Color science, WCAG contrast, 16.7M hex colors
- [FontFYI](https://fontfyi.com) — Google Fonts metadata, CSS generation, pairings
- [EmojiFYI](https://emojifyi.com) — 3,953 emojis, Unicode Emoji 16.0, 8 encodings
- [UnicodeFYI](https://unicodefyi.com) — Unicode characters, 17 encodings, HTML entities

## Images (CDN)

OG images for all entities at https://cdn.symbolfyi.com/og/{type}/{slug}.png
- https://cdn.symbolfyi.com/og/homepage.png

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