diff --git a/branding/README.md b/branding/README.md
index b788f6c..11e2df2 100644
--- a/branding/README.md
+++ b/branding/README.md
@@ -1,4 +1,40 @@
-# Developer Notes
+# cpp-linter — brand asset library
+
+Built from the org's existing mark: hand-drawn **amber circle + green check**, green serif
+wordmark, and the yellow **lint squiggle**. Colors: Gold `#F8C418` · Green `#48B888` ·
+Ink `#26241F` · Paper `#FAF6EE`.
+
+## Social preview images (1280×640 — GitHub: Settings → General → Social preview)
+
+| Repo | File |
+|------|------|
+| cpp-linter-action | `social/social-cpp-linter-action.png` |
+| cpp-linter-hooks | `social/social-cpp-linter-hooks.png` |
+| cpp-linter | `social/social-cpp-linter.png` |
+| cpp-linter-rs | `social/social-cpp-linter-rs.png` |
+| clang-tools-pip | `social/social-clang-tools-pip.png` |
+| clang-tools-docker | `social/social-clang-tools-docker.png` |
+| clang-tools-static-binaries | `social/social-clang-tools-static-binaries.png` |
+| clang-tools-wheel | `social/social-clang-tools-wheel.png` |
+| asdf-clang-tools | `social/social-asdf-clang-tools.png` |
+| cpp-linter.github.io | `social/social-cpp-linter.github.io.png` |
+
+## Org-level assets
+
+| Asset | File | Use |
+|-------|------|-----|
+| README hero banner | `social/org-readme-banner.png` | `.github/profile/README.md`, repo READMEs |
+| Avatar — light | `social/avatar-light.png` | Org/profile avatar (640×640) |
+| Avatar — dark | `social/avatar-dark.png` | Dark backgrounds |
+| Avatar — gold tint | `social/avatar-tint.png` | Accent / alt avatar |
+
+## Source artwork
+`icon.png` (transparent check mark) · `wordmark.png` (full lockup, transparent) ·
+`wordmark-text.png` (text-only, transparent) · `logo.png` / `banner.png` (originals on white).
+
+Browse everything live in **Brand Assets.dc.html**.
+
+## Developer Notes
 
 The *.xcf files in this folder are GIMP projects.
 
diff --git a/branding/banner.png b/branding/banner.png
new file mode 100644
index 0000000..74eb73c
Binary files /dev/null and b/branding/banner.png differ
diff --git a/branding/icon.png b/branding/icon.png
new file mode 100644
index 0000000..c83aef0
Binary files /dev/null and b/branding/icon.png differ
diff --git a/branding/social/avatar-dark.png b/branding/social/avatar-dark.png
new file mode 100644
index 0000000..797476e
Binary files /dev/null and b/branding/social/avatar-dark.png differ
diff --git a/branding/social/avatar-light.png b/branding/social/avatar-light.png
new file mode 100644
index 0000000..eac855e
Binary files /dev/null and b/branding/social/avatar-light.png differ
diff --git a/branding/social/avatar-tint.png b/branding/social/avatar-tint.png
new file mode 100644
index 0000000..e65e86b
Binary files /dev/null and b/branding/social/avatar-tint.png differ
diff --git a/branding/social/org-readme-banner.png b/branding/social/org-readme-banner.png
new file mode 100644
index 0000000..3f0e17d
Binary files /dev/null and b/branding/social/org-readme-banner.png differ
diff --git a/branding/social/social-asdf-clang-tools.png b/branding/social/social-asdf-clang-tools.png
new file mode 100644
index 0000000..02281f6
Binary files /dev/null and b/branding/social/social-asdf-clang-tools.png differ
diff --git a/branding/social/social-clang-tools-docker.png b/branding/social/social-clang-tools-docker.png
new file mode 100644
index 0000000..74e0373
Binary files /dev/null and b/branding/social/social-clang-tools-docker.png differ
diff --git a/branding/social/social-clang-tools-pip.png b/branding/social/social-clang-tools-pip.png
new file mode 100644
index 0000000..048be8d
Binary files /dev/null and b/branding/social/social-clang-tools-pip.png differ
diff --git a/branding/social/social-clang-tools-static-binaries.png b/branding/social/social-clang-tools-static-binaries.png
new file mode 100644
index 0000000..343569f
Binary files /dev/null and b/branding/social/social-clang-tools-static-binaries.png differ
diff --git a/branding/social/social-clang-tools-wheel.png b/branding/social/social-clang-tools-wheel.png
new file mode 100644
index 0000000..ab736e1
Binary files /dev/null and b/branding/social/social-clang-tools-wheel.png differ
diff --git a/branding/social/social-cpp-linter-action.png b/branding/social/social-cpp-linter-action.png
new file mode 100644
index 0000000..ffccac5
Binary files /dev/null and b/branding/social/social-cpp-linter-action.png differ
diff --git a/branding/social/social-cpp-linter-hooks.png b/branding/social/social-cpp-linter-hooks.png
new file mode 100644
index 0000000..38adf5c
Binary files /dev/null and b/branding/social/social-cpp-linter-hooks.png differ
diff --git a/branding/social/social-cpp-linter-rs.png b/branding/social/social-cpp-linter-rs.png
new file mode 100644
index 0000000..c6bba73
Binary files /dev/null and b/branding/social/social-cpp-linter-rs.png differ
diff --git a/branding/social/social-cpp-linter.github.io.png b/branding/social/social-cpp-linter.github.io.png
new file mode 100644
index 0000000..034f56b
Binary files /dev/null and b/branding/social/social-cpp-linter.github.io.png differ
diff --git a/branding/social/social-cpp-linter.png b/branding/social/social-cpp-linter.png
new file mode 100644
index 0000000..e3dc62d
Binary files /dev/null and b/branding/social/social-cpp-linter.png differ
diff --git a/branding/wordmark-text.png b/branding/wordmark-text.png
new file mode 100644
index 0000000..c503c64
Binary files /dev/null and b/branding/wordmark-text.png differ
diff --git a/branding/wordmark.png b/branding/wordmark.png
new file mode 100644
index 0000000..edf1577
Binary files /dev/null and b/branding/wordmark.png differ