Skip to content

Iconography

Phosphor Icons, ruled 2026-09-22. Wade chose it over Lucide (the theme’s previous set), Tabler and Heroicons after a side-by-side of the four on the Noiz grounds, in the real components. The vendored set, its manifest and licence live in assets/icons/; the rules are here.

Set Phosphor Icons 2.1.1, MIT (@phosphor-icons/core)
Grid 256 units, drawn as filled paths, painted by currentColor
Weights used regular at 20px and larger; bold below 20px (1em inline in buttons, badges, feature ticks and body copy). Thin, light, fill and duotone are not used.
Brand marks Simple Icons, CC0 (Monero, Signal, X). Brand marks only, never for a UI meaning.
Noiz-drawn The reticle, and nothing else. It is a mark, not an icon: monochrome, never glowing.

Phosphor’s regular stroke is 1.5px at 24px and thins to under 1px at badge size on the black grounds, which is why the weight steps up below 20px. One rule, by size, not by meaning.

The vocabulary is the file name. assets/icons/manifest.json maps each meaning to the Phosphor source it is drawn from (menu is Phosphor’s list, server is hard-drives, zap is lightning), so markup and layouts never depend on an upstream name. A meaning gets one icon; an icon carries one meaning. Adding a meaning means adding a manifest entry and both weights, as assets/icons/README.md describes.

.icon is 1em and sits on the text baseline (vertical-align: -0.125em), so an inline icon follows the type size around it. .icon--md is 1.5rem and .icon--lg is 2rem for standalone use; card and hero icons sit at 24px or 32px. Never scale an icon by a fractional pixel size; the 256 grid renders cleanly at 16, 20, 24 and 32.

  • An icon inherits the text colour it sits in: color.semantic.text.* in copy, the button’s own ink inside a button.
  • Amber (color.semantic.accent.primary) only when the icon is the actionable element or a feature tick, the same rule as for links.
  • Never pillar-tinted: pillars carry no colour. Never glowing: phosphor sits on amber elements, and an icon is not one.
  • Brand marks are drawn monochrome in currentColor too. The Monero mark in the footer may take the accent because it is a link.

The base rule svg { fill: currentColor } is what paints Phosphor’s filled paths. A stroke set (Lucide, Tabler, Heroicons) needs fill: none on every glyph, and under the base rule renders as a solid blob. Mixing the two languages in one view is forbidden, and so is bringing a second set in for a missing glyph: find the meaning in Phosphor or ask for a ruling.

  • Decorative icons carry aria-hidden="true" focusable="false". This is the default.
  • An icon that carries meaning on its own (an icon-only button, a status glyph with no word) carries role="img" and an aria-label. The Hugo partial icon.html sets either form from its label parameter.
  • Never an icon-only control without an accessible name. Never colour alone: a status icon sits beside its word.
  • Repository: assets/icons/phosphor/{regular,bold}/<meaning>.svg, assets/icons/brands/, assets/icons/manifest.json.
  • Hugo theme: themes/noiz/assets/icons/<meaning>.svg (regular) and icons/bold/, inlined by layouts/_partials/icon.html, which takes name, optional weight (“bold”) and label. Lucide was swapped out on 2026-09-22; its files are kept beside the folder as icons-lucide.2026-09-22.bak/ until the next theme release.
  • Design System artifact: the Icon card shows the vocabulary in both weights.
  • Do use the bold weight for anything set below 20px. A row that mixes brand marks with UI glyphs (the footer social row) stays on regular throughout: brand marks have one weight.
  • Do keep a status icon beside its word.
  • Do not draw new UI glyphs; extend from Phosphor.
  • Do not tint an icon by pillar, and do not let one glow.
  • Do not scale below 16px.