themes-terminal/RECOMMENDED_ICONS.md
Alex Dunmow daab6750fe feat(terminal): Wave A full theme build (WO-TF-025)
Bring the terminal dev-tool/OSS-docs theme to full Wave A OVERRIDE-CONTRACT
compliance.

- 49 mandatory builtin overrides in templates/overrides/terminal/ (TTY chrome,
  re-skinned from the frozen builtin defaults; every content field, provider var,
  custom tag, data-bn-* attr and inline script preserved verbatim).
- 7 page templates (default, full-width, landing, article, blog-index, contact,
  auth) with TTY-window chrome, man-page article layout, and theme_mode-driven
  light/dark switching.
- GO BIG motion: dependency-free ASCII glyph-rain canvas on the hero override
  only (lazy-init, prefers-reduced-motion honored, static phosphor fallback).
- 4 persona blocks (manpage_header, code_console, keybind_table, boot_log);
  ascii_header/toc/footer blocks retired in favour of overrides + template
  furniture.
- 5 dual-mode presets (mode "both", all 19 tokens) with intentional paper-teletype
  light and phosphor dark sides.
- Bundled OFL mono fonts (JetBrains Mono, IBM Plex Mono) with LICENSES record;
  all font-family via var(--font-heading|body|mono, fallback).
- Themed email-safe wrapper (retained), master pages, and a seeded "grid" OSS
  dev-tool demo site (home, about, changelog + 3 posts, contact with
  row_inserted -> email-admins workflow, login).
- Declared required_icon_packs = [lucide, simple-icons].

Verified: make build exit 0, make verify exit 0, check-safety exit 0.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-05 12:41:04 +08:00

1.3 KiB

Recommended icons — Terminal

Icons render through the CMS sprite pipeline: <svg><use href="/icons/<pack>.svg#<name>"/></svg> (or the ::pack:name:size:: shorthand). The theme's overrides reference two bundled packs.

Required packs

Declared in plugin.mod as required_icon_packs = ["lucide", "simple-icons"] (forward-declared — the loader does not yet auto-install; install manually until it does).

Pack Used for Install
lucide UI glyphs the builtin/override templates use: arrow-right, check, chevron-down, chevron-left, chevron-right, x, terminal, cpu, mail, map-pin, download, play, radio, message-square Ships bundled with the CMS — no action needed.
simple-icons Author/social brand glyphs: github, x, linkedin, discord Ships bundled with the CMS — no action needed.

Both packs ship bundled with the CMS, so a fresh instance renders every override icon with no manual step. If you author blocks that reference other packs (e.g. tabler, phosphor), install them from /admin/icons (Browse -> install -> enable) before activation.

Note

Icon values in block content are stored as "pack:name" strings and split with |split:":"|first / |last. Never inline raw SVG path data for content icons — that bypasses the sprite system and the admin pack manager.