Beta
These docs are in progress. Some pages are incomplete or may change. Report a problem
Developer docs
Icon composition
Shape × symbol × variant mental model behind every DTPR icon.
Developer docs menu
Every DTPR icon is a 36×36 SVG composed on demand from three independent inputs:
shape (from category) + symbol (from element) + variant (default | dark | context color) → SVG
This composition is deterministic. The same (version, element_id, variant) triple always returns a byte-identical SVG, and the response carries a long Cache-Control header and an X-DTPR-Content-Hash for cache invalidation.
In this section
- Shapes — the primitive shape family and how a category picks one.
- Symbols — release-pinned symbol SVGs and the
symbol_idlink. - Composed variants —
default,dark, and{ kind: 'colored', color }; the inner-color luminance rule. - URLs — how to derive and discover icon URLs.
- Figma plugin — generate a Figma component library of every icon.
Related
- REST: icon routes — the HTTP surface.
- MCP:
get_icon_url— the MCP tool that resolves these URLs. - Concepts: icon — the plain-language definition of an icon and how it relates to shapes and symbols.