diff --git a/README.md b/README.md
index 4357980..0b2ad86 100644
--- a/README.md
+++ b/README.md
@@ -182,6 +182,24 @@ Set via `cloudron env set` (process env):
 Injected into the built SPA by the Dockerfile (`<link>` + `<script>` after
 the `<title>` sed). What it does:
 
+**Palette source of truth**: the co-op homepage's own CSS variables —
+`--cream #faf8f5` (surfaces), `--wash #eef4ea` (panels/hover),
+`--green-deep #5b8c5a` (primary/submit), `--green-mid #6ba86b` (hover),
+`--green-light #7ab87a` (dark-mode accent), `--ink #2d3327` (text),
+`--muted #6b7a62` (secondary text), `--border #e8e2d8`. The `html.light` /
+`html.dark` blocks in `custom.css` map these onto LibreChat's Tailwind
+variables; keep them in sync when the homepage palette changes.
+
+**Logo & icons**: `assets/logo.svg` is the GREEN pine-dots vector (extracted
+from the homepage's inline SVG — keep the `xmlns` attribute, a standalone
+.svg is invalid without it). The earlier white-plate PNG variant was
+invisible on the cream background and only "flashed" against the dark
+loading screen. Favicons/PWA icons are the cream-plate + green-dots design
+rasterized from `design-assets/favicon.svg`. The Dockerfile also cache-busts
+the logo URL in the client bundle (`assets/logo.svg?v=3`) and deletes the
+stale precompressed `.gz`/`.br` siblings — bump `v=` whenever the logo
+changes, or browsers/service workers may keep serving an old cached copy.
+
 - **Colors** — LibreChat's Tailwind theme resolves every color through CSS
   variables set on `html.light` / `html.dark` (space-separated RGB):
   `--surface-primary`, `--surface-secondary/-tertiary/-hover/-submit/-submit-hover`,