adeelahmad · Oct 4, 2026 · Oct 4, 2026
diff --git a/README.md b/README.md
@@ -1,3 +1,10 @@
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/brand/lens-horizontal-dark-tagline.svg">
+    <img src="docs/brand/lens-horizontal-light-tagline.svg" alt="Lens: Your life. Your AI." width="360">
+  </picture>
+</p>
+
 # Lens
 
 An archive for recorded speech and video. Lens transcribes recordings in batches, recognises speakers by voice within

diff --git a/cloudron/logo.png b/cloudron/logo.png
diff --git a/docs/brand/README.md b/docs/brand/README.md
@@ -0,0 +1,39 @@
+# Lens brand
+
+The Search Lens identity, v1.0 (4 October 2026). These are the files the repository uses; the full kit (app icons for
+every platform, social images, CLI banners, print PDFs) is kept outside the repository.
+
+| File | Use |
+| --- | --- |
+| `lens-horizontal-light.svg`, `lens-horizontal-dark.svg` | Mark and wordmark on light or dark surfaces |
+| `lens-horizontal-*-tagline.svg` | The same, with "Your life. Your AI." |
+| `lens-mark-colour.svg` | The mark alone: app icons, favicons, avatars |
+| `lens-mark-ink.svg`, `lens-mark-white.svg` | One-colour mark for tinted or monochrome surfaces |
+| `lens-github-social-light-1280x640.png` | The repository's social preview (GitHub settings, General) |
+| `lens-open-graph-light-1200x630.png` | Link previews |
+| `lens.css`, `lens-colours.json` | Brand colours and type |
+
+## Colours
+
+| Token | sRGB |
+| --- | --- |
+| Blue | `#1A73E8` |
+| Red | `#EA4335` |
+| Green | `#34A853` |
+| Gold | `#F9AB00` |
+| Ink | `#202124` |
+| White | `#FFFFFF` |
+
+The web app's `nextjs-frontend/app/styles/tokens.css` uses the same values. Type is DM Sans.
+
+## Rules
+
+- Keep one ring-band width of clear space around the artwork.
+- Use the mark without the wordmark for icons and favicons; keep the memory dot in every variant.
+- The SVGs are outlined paths, so they need no font installed.
+
+## Where it is used
+
+- Web app: `nextjs-frontend/components/ui/lens-mark.tsx`, `app/icon.svg`, `app/favicon.ico`, `app/apple-icon.png`,
+  `app/manifest.ts` and `public/pwa/`.
+- Packages: `cloudron/logo.png`, `packaging/synology/icons/`, `packaging/qnap/qpkg/icons/`.
diff --git a/docs/brand/lens-colours.json b/docs/brand/lens-colours.json
@@ -0,0 +1,22 @@
+{
+  "brand": {
+    "blue": "#1A73E8",
+    "red": "#EA4335",
+    "green": "#34A853",
+    "gold": "#F9AB00"
+  },
+  "neutrals": {
+    "ink": "#202124",
+    "white": "#FFFFFF",
+    "secondary": "#5F6368",
+    "muted": "#80868B",
+    "surface": "#F8F9FA",
+    "border": "#DADCE0"
+  },
+  "type": {
+    "family": "DM Sans",
+    "wordmarkWeight": 750,
+    "bodyWeight": 500
+  },
+  "source": "Uploaded Aladdin design-system tokens; gold is #F9AB00."
+}
diff --git a/docs/brand/lens-github-social-light-1280x640.png b/docs/brand/lens-github-social-light-1280x640.png
diff --git a/docs/brand/lens-horizontal-dark-tagline.svg b/docs/brand/lens-horizontal-dark-tagline.svg
diff --git a/docs/brand/lens-horizontal-dark.svg b/docs/brand/lens-horizontal-dark.svg
diff --git a/docs/brand/lens-horizontal-light-tagline.svg b/docs/brand/lens-horizontal-light-tagline.svg
diff --git a/docs/brand/lens-horizontal-light.svg b/docs/brand/lens-horizontal-light.svg
diff --git a/docs/brand/lens-mark-colour.svg b/docs/brand/lens-mark-colour.svg
diff --git a/docs/brand/lens-mark-ink.svg b/docs/brand/lens-mark-ink.svg
diff --git a/docs/brand/lens-mark-white.svg b/docs/brand/lens-mark-white.svg
diff --git a/docs/brand/lens-open-graph-light-1200x630.png b/docs/brand/lens-open-graph-light-1200x630.png
diff --git a/docs/brand/lens.css b/docs/brand/lens.css
@@ -0,0 +1,14 @@
+:root {
+  --lens-blue: #1A73E8;
+  --lens-red: #EA4335;
+  --lens-green: #34A853;
+  --lens-gold: #F9AB00;
+  --lens-ink: #202124;
+  --lens-white: #FFFFFF;
+  --lens-secondary: #5F6368;
+  --lens-muted: #80868B;
+  --lens-surface: #F8F9FA;
+  --lens-border: #DADCE0;
+  --lens-blue-tint: #E8F0FE;
+  --lens-font: "DM Sans", system-ui, -apple-system, sans-serif;
+}
diff --git a/packaging/qnap/qpkg/icons/Lens.gif b/packaging/qnap/qpkg/icons/Lens.gif
diff --git a/packaging/qnap/qpkg/icons/Lens_80.gif b/packaging/qnap/qpkg/icons/Lens_80.gif
diff --git a/packaging/qnap/qpkg/icons/Lens_gray.gif b/packaging/qnap/qpkg/icons/Lens_gray.gif
diff --git a/packaging/synology/icons/lens_16.png b/packaging/synology/icons/lens_16.png
diff --git a/packaging/synology/icons/lens_24.png b/packaging/synology/icons/lens_24.png
diff --git a/packaging/synology/icons/lens_256.png b/packaging/synology/icons/lens_256.png
diff --git a/packaging/synology/icons/lens_32.png b/packaging/synology/icons/lens_32.png
diff --git a/packaging/synology/icons/lens_48.png b/packaging/synology/icons/lens_48.png
diff --git a/packaging/synology/icons/lens_64.png b/packaging/synology/icons/lens_64.png
diff --git a/packaging/synology/icons/lens_72.png b/packaging/synology/icons/lens_72.png