diff --git a/docs/THEMING.md b/docs/THEMING.md
index 9fa9cb2..5c1aa93 100644
--- a/docs/THEMING.md
+++ b/docs/THEMING.md
@@ -137,3 +137,20 @@ Self-hosted variable fonts via Fontsource (woff2, no external requests):
Font sizes use `clamp()` for fluid scaling (see the `h1`-`h4` rules in
`global.css`).
+
+---
+
+## Icons and motifs
+
+- **Icons:** `` (Astro) and `` (React
+ islands) render the Patiun stroke icon set in `src/lib/brand-icons.ts`. Call
+ sites can use either the brand name (`dice`) or the mdi name (`dice-multiple`);
+ `brandIconAliases` maps one to the other. Only third-party logos (GitHub,
+ LinkedIn, Steam, ...) fall back to mdi. The gold star accent uses
+ `--icon-gold` (deep gold on Starlight, flat gold inside `.on-sky`). The file is
+ generated from the brand source (`newicons.py`); add icons there.
+- **Motifs:** `` shows a brand motif from `public/motifs/`,
+ copied from the brand files with ring text outlined to paths. `-light` files
+ are the Starlight recolor. One focal motif per surface, kept faint.
+- **Gold accents:** image frames, quote bars, dividers and rules use
+ `--color-gold`; teal stays for links, buttons and icons.
diff --git a/public/brand/patiun-seal.svg b/public/brand/patiun-seal.svg
new file mode 100644
index 0000000..60c4a59
--- /dev/null
+++ b/public/brand/patiun-seal.svg
@@ -0,0 +1,76 @@
+
\ No newline at end of file
diff --git a/public/motifs/astrolabe.svg b/public/motifs/astrolabe.svg
new file mode 100644
index 0000000..9423cf6
--- /dev/null
+++ b/public/motifs/astrolabe.svg
@@ -0,0 +1,2 @@
+
\ No newline at end of file
diff --git a/public/motifs/layered-seal.svg b/public/motifs/layered-seal.svg
new file mode 100644
index 0000000..9a8952d
--- /dev/null
+++ b/public/motifs/layered-seal.svg
@@ -0,0 +1,2 @@
+
\ No newline at end of file
diff --git a/public/motifs/transmutation-seal-light.svg b/public/motifs/transmutation-seal-light.svg
new file mode 100644
index 0000000..cdf9a07
--- /dev/null
+++ b/public/motifs/transmutation-seal-light.svg
@@ -0,0 +1,2 @@
+
\ No newline at end of file
diff --git a/public/motifs/tria-prima-array-seal-light.svg b/public/motifs/tria-prima-array-seal-light.svg
new file mode 100644
index 0000000..723826e
--- /dev/null
+++ b/public/motifs/tria-prima-array-seal-light.svg
@@ -0,0 +1,2 @@
+
\ No newline at end of file
diff --git a/src/components/Icon.astro b/src/components/Icon.astro
index 15efe5a..3cfa314 100644
--- a/src/components/Icon.astro
+++ b/src/components/Icon.astro
@@ -2,17 +2,17 @@
/**
* Icon.astro
* ---------------------------------------------------------------------------
- * Inline mdi (Material Design Icons) renderer. Pulls icon path data at build
- * time from `@iconify-json/mdi/icons.json` and emits a single inline