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.
The set
Section titled “The set”| 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.
One icon per meaning
Section titled “One icon per 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.
Sizing
Section titled “Sizing”.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.
Colour
Section titled “Colour”- 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
currentColortoo. The Monero mark in the footer may take the accent because it is a link.
Why no stroke set
Section titled “Why no stroke set”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.
Accessibility
Section titled “Accessibility”- 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 anaria-label. The Hugo partialicon.htmlsets either form from itslabelparameter. - Never an icon-only control without an accessible name. Never colour alone: a status icon sits beside its word.
Where it is applied
Section titled “Where it is applied”- Repository:
assets/icons/phosphor/{regular,bold}/<meaning>.svg,assets/icons/brands/,assets/icons/manifest.json. - Hugo theme:
themes/noiz/assets/icons/<meaning>.svg(regular) andicons/bold/, inlined bylayouts/_partials/icon.html, which takesname, optionalweight(“bold”) andlabel. Lucide was swapped out on 2026-09-22; its files are kept beside the folder asicons-lucide.2026-09-22.bak/until the next theme release. - Design System artifact: the Icon card shows the vocabulary in both weights.
Do and do not
Section titled “Do and do not”- 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.