Glyphly · Precision Unicode Typography Studio & Specimen Lab

GLYPHLY is a high-craft, precision Unicode typography studio and aesthetic specimen laboratory. It transforms plain text into 180+ authentic mathematical, calligraphic, and cipher styles across 13 curated taxonomies—with live typographic telemetry, an architectural scale ruler, quick case transformations, instant clipboard copying, and zero visual slop.

---

Highlights

• ✦ 180+ Authentic Typographic Styles: Comprehensive math alphabets, blackletter Fraktur, cursive scripts, geometric boxed tiles, ancient runes, ciphers, combining diacritics, and glitch styles.
• ✦ Guaranteed Depth Per Taxonomy: Every single category contains at least 8 distinct, authentic styles (no sparse or 1-style categories).
• ✦ Rich Default Starred Collection: Boots with 9 curated favorites representing diverse typographic genres (Bold, Blackboard Double-Struck, Fraktur, Circled Spheres, Cyberpunk Shades, Tibetan Wings, Small Caps, Zalgo Glitch, SGA Galactic Script).
• ✦ Architectural Precision Scale Ruler: Interactive drafting ruler with live needle position indicator, percentage readout, and bidirectional drag-and-scroll navigation.
• ✦ Live Typographic Telemetry: Real-time evaluation of visual graphemes, UTF-16 code units, UTF-8 byte payload, word count, line count, characters-per-line (CPL), and readability metrics.
• ✦ Zero False Positives: Intelligent grapheme support detection that accurately handles symmetric inverted letters, phonetic glyphs, combining mark overlays, and lookup ciphers.
• ✦ Tactile Studio Controls: Quick case conversion pills (UPPER, lower, Title, ⇄ Flip), live font-size slider (14px–48px), and theme switching (Dark / Light).
• ✦ Responsive Editorial Layout: Dual-panel studio workstation on desktop with collapsible, gesture-friendly controls on mobile devices.
• ✦ Bespoke High-DPI Vector Favicon: Crisp squircle monogram with double-struck detailing and golden sparkle accent (✦), legible from 16px tab icons to 512px app displays.

---

Typographic Taxonomies (13 Curated Categories)

Every category is guaranteed to contain at least 8 unique styles:

Category	Styles	Description & Sample Output
Clean & Classic	9	Mathematical serif bold, sans bold, italic, monospace, and double-struck blackboard bold (𝐀𝐧𝐭𝐢𝐠𝐫𝐚𝐯𝐢𝐭𝐲, 𝔸𝕟𝕥𝕚𝕘𝕣𝕒𝕧𝕚𝕥𝕪).
Gothic & Script	8	Blackletter Fraktur, bold Fraktur, cursive script, bold script, and spaced variants (𝔄𝔫𝔱𝔦𝔤𝔯𝔞𝔳𝔦𝔱𝔶, 𝒜𝓃𝓉𝒾ℊ𝓇𝒶𝓋𝒾𝓉𝓎).
Squared Tiles	9	Squared letters, negative black tiles, enclosing squares, keycaps, and CRT terminal frames (🄰🄽🅃🄸🄶🅁🄰🅅🄸🅃🅈, 🅰🅽🆃🅸🅶🆁🅰🆅🅸🆃🆈).
Brackets & Frames	22	Japanese lenticular (【 】), corner quotes (『 』), double angle (《 》), Cyberpunk ASCII shades (░▒▓ ▓▒░), and Tibetan wings (꧁ ꧂).
Circled Spheres	8	White circled letters/digits, black bubbles, parenthesized glyphs, and combining bubble enclosures (Ⓐⓝⓣⓘⓖⓡⓐⓥⓘⓣⓨ, 🅐🅝🅣🅘🅖🅡🅐🅥🅘🅣🅨).
Vaporwave & Spaced	8	Fullwidth Zenkaku characters, aesthetic spaced tracking, middle-dot tracking, slash tracking, dash tracking, and pipe tracking (Ａｎｔｉｇｒａｖｉｔｙ, A · n · t · i).
Small Capitals	8	Phonetic small caps, dotted small caps, mathematical superscript, and chemical subscript (ᴀɴᴛɪɢʀᴀᴠɪᴛʏ, ᵃⁿᵗⁱᵍʳᵃᵛⁱᵗʸ, ₐₙₜᵢ).
Mirrored & Flip	8	180° upside-down rotation, mirrored reflection, backwards reversing, and tracked variants (ʎʇᴉʌɐɹƃᴉʇu∀, YTI⅃IVAYTIᙠA).
Zalgo & Glitch	8	Deterministic Zalgo void marks, cyber static, scanline overlays, corrupt strikes, and shaded redaction blocks (A̶n̶t̶i̶g̶r̶a̶v̶i̶t̶y̶, ▓▓▓▓▓▓▓▓▓▓▓).
Line & Strike	25	Single/double underline, strikethrough, wavy underline, overline, vector arrows, umlauts, lightning zigzag, and diagonal slashes (A̲n̲t̲i̲, A̶n̲t̲i̶).
Ancient Runes	16	Elder Futhark runes, Celtic Ogham, Ulfilas Gothic, Glagolitic, Phoenician, Coptic, Old Italic, and SGA Enchanting Table (ᚨᛒᚲ, ᚐᚁᚉ, 𐌰𐌱𐌲, ᒲ╎リᒷ).
Ciphers & Code	33	Morse code, Braille 6-dot matrix, ROT13 Caesar cipher, Atbash, Leet speak (1337), A1Z26 cipher, NATO phonetic, and raw 8-bit Binary bytes.
Symbols & Ornaments	18	Black & white stars (★, ☆), sparkle stars (✧, ✦), floral dingbats (✿), fleurons (❦), asterisms (⁂), peace (☮), yin-yang (☯), and crescent moons (☽ ☾).

---

Technical Stack & Architecture

• Runtime & Package Manager: Bun (v1.4+)
• UI Framework: Preact (v10.26) for lightweight, zero-overhead DOM rendering
• Language: TypeScript (v7) in strict mode
• Bundler & Dev Server: Vite (v8)
• Linter & Formatter: Biome (v2)
• Test Suite: Vitest & Bun Test (188+ tests validating grapheme integrity, coverage, and category invariants)

Directory Structure

fancy-text/
├── public/
│   └── glyphly.svg             # Bespoke high-DPI vector squircle favicon
├── src/
│   ├── engine/
│   │   ├── engine.ts           # Intl.Segmenter cluster analysis & measure metrics
│   │   ├── engine.test.ts      # Comprehensive Vitest test suite (188 passing tests)
│   │   └── styles.ts           # 188+ style maps, lookup tables, and category metadata
│   ├── App.tsx                 # Studio layout, ruler navigation, controls, and specimen river
│   ├── index.css               # Editorial CSS design system & custom properties
│   └── main.tsx                # Application bootstrap
├── biome.json                  # Biome code formatting and linting configuration
├── index.html                  # HTML entrypoint with typography preconnects
├── package.json                # Project scripts and dependencies
├── tsconfig.json               # TypeScript compiler configuration
├── LICENSE                     # GNU General Public License v3.0
├── AGENTS.md                   # AI Agent engineering guidelines & code invariants
└── README.md                   # Documentation

---

Getting Started

Prerequisites

Ensure you have Bun installed (>= 1.4.0):

curl -fsSL https://bun.sh/install | bash

Installation

Clone the repository and install dependencies:

git clone https://github.com/quantavil/glyphly.git
cd glyphly
bun install

Development Server

Start the local Vite dev server with instant hot module replacement:

bun run dev

Visit http://localhost:5173/ in your browser.

Running Tests

Execute the comprehensive test suite across all 180+ styles and category constraints:

bun test

Or run Vitest in watch mode:

bun run test:vitest

Code Quality & Linting

# Check code formatting and linting rules
bun run lint

# Automatically format code using Biome
bun run format

Production Build

Typecheck and generate optimized production static assets in dist/:

bun run build

---

Deployment

Glyphly produces standard static assets that deploy anywhere in seconds:

Cloudflare Pages

• Build command: bun run build
• Build output directory: dist
• Environment variables: BUN_VERSION=1.4.2

Vercel / Netlify / GitHub Pages

• Build command: bun run build
• Publish directory: dist

---

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for complete terms and conditions.

Copyright (C) 2026 Glyphly Contributors.