Brand pillar · v0.15.2
brand-iconography Brand Iconography
Brand iconography system. Captures the systematic rules behind every icon the brand ships — weights, styles, grids, and production sources — independent of the individual assets enumerated in `AssetCatalog`.
$id · https://corpospec.com/schemas/v0.15.2/brand-iconography.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| grid | IconGrid | yes | The grid that icon shapes align to. |
| id | PathRef | yes | PathRef of this record (conventionally `brand/iconography`). |
| name | string | yes | Display name of the icon system (e.g. `"Unstarter Duotone"`, `"KICKGEIST Sport"`). |
| anti_patterns | string[] | — | Anti-patterns — how icons must NOT be used (e.g. "never rotate", "never apply drop shadows"). |
| color_usage | string? | — | Conventions for applying colour to icons (fill rules, duotone pairs, semantic-colour binding). |
| source_files | PathRef[] | — | PathRefs to production source files (SVG sets, Figma components, font-icon glyph maps). |
| variants | IconVariant[] | — | Variants (weights × styles × sizes) shipped by this system. |
Definitions
Shared types referenced within this schema.
IconGrid
Keyline grid used to align icon shapes.
type: object
IconStyle
Icon style (visual treatment family).
enum: "outlined", "filled", "rounded", "sharp", "two-tone"
IconVariant
A single icon variant in the system (e.g. "regular-outlined-24px").
type: object
IconWeight
Icon weight (stroke thickness family).
enum: "thin", "regular", "bold", "filled", "duotone"
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.15.2/brand-iconography.schema.json