Iconography

Iconography lives under core.assets/assets/iconography/. Each named icon has a folder containing variant files (SVG/PNG).

Layout

core.assets/assets/iconography/

├── checkmark/

│   ├── checkmark.svg

│   └── checkmark-bold.svg

└── logo/

    └── logo.svg

Requesting icons

Path-style (recommended)

GET /iconography/checkmark

Serves the latest file by modification time. If only one file exists, it serves that file directly.

Query-string style

GET /iconography?name=checkmark

Specific variant

GET /iconography/checkmark?version=checkmark-bold.svg

GET /iconography?name=checkmark&version=checkmark-bold.svg

Listing available files

GET /iconography/checkmark?list

Returns a JSON array with all files, sizes, and modification times.

Version resolution

Request	Behavior

?version=stable	If stable.md exists → serve that file; otherwise → serve latest
?version=latest	Serve newest file by modification time
?version=<name>	Serve exact file match (by name, basename, or hashed prefix)
(no param)	Serve latest file by modification time

Available icons

Icon

Folder

Usage

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg>	checkmark/	Generic check / confirm
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>	x/	Close / dismiss (modals, toasts, alerts)
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/></svg>	document/	Article / document pages
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="12" y1="16" x2="12" y2="12"/><line x1="12" y1="8" x2="12.01" y2="8"/></svg>	toast-info/	Info toast icon
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"/><polyline points="22 4 12 14.01 9 11.01"/></svg>	toast-success/	Success toast icon
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z"/><line x1="12" y1="9" x2="12" y2="13"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>	toast-warning/	Warning toast icon
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="15" y1="9" x2="9" y2="15"/><line x1="9" y1="9" x2="15" y2="15"/></svg>	toast-error/	Error toast icon
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><line x1="8" y1="12" x2="16" y2="12"/></svg>	toast-neutral/	Neutral toast icon

Adding a new icon

1. Create a folder under core.assets/assets/iconography/<icon-name>/.


2. Place the SVG/PNG files inside.


3. The resolver picks up new files automatically — no build step needed.