diff --git a/README.md b/README.md
index 75d499ed..544aedad 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
+
+
+
+
+ 
+
+
+
# AgentKeys
Credential broker for AI agents. A master (human) delegates scoped, revocable access to third-party service credentials (OpenRouter, OpenAI, etc.) to agent sandboxes — without ever handing the agent the raw keys.
diff --git a/docs/assets/brand/README.md b/docs/assets/brand/README.md
new file mode 100644
index 00000000..02381fad
--- /dev/null
+++ b/docs/assets/brand/README.md
@@ -0,0 +1,48 @@
+# AgentKeys brand assets
+
+This folder contains the project logo set generated from the supplied AgentKeys mark. All generated logo and icon variants use transparent backgrounds.
+
+Theme naming:
+
+- `light` assets use a black mark for light surfaces.
+- `dark` assets use a white mark for dark surfaces.
+- Unsuffixed assets are transparent light-theme fallbacks for conventional filenames.
+
+## Files
+
+- `agentkeys-logo-source.png` - original source image.
+- `agentkeys-logo-light-1024.png`, `agentkeys-logo-light-512.png`, `agentkeys-logo-light-256.png` - transparent light-theme logos.
+- `agentkeys-logo-dark-1024.png`, `agentkeys-logo-dark-512.png`, `agentkeys-logo-dark-256.png` - transparent dark-theme logos.
+- `agentkeys-logo-1024.png`, `agentkeys-logo-512.png`, `agentkeys-logo-256.png` - transparent light-theme fallback logos.
+- `favicon-light.ico`, `favicon-dark.ico`, `favicon.ico` - multi-size browser favicons.
+- `favicon-light-16x16.png`, `favicon-light-32x32.png`, `favicon-light-48x48.png` - transparent light-theme favicon PNGs.
+- `favicon-dark-16x16.png`, `favicon-dark-32x32.png`, `favicon-dark-48x48.png` - transparent dark-theme favicon PNGs.
+- `favicon-16x16.png`, `favicon-32x32.png`, `favicon-48x48.png` - transparent light-theme fallback favicon PNGs.
+- `apple-touch-icon-light.png`, `apple-touch-icon-dark.png`, `apple-touch-icon.png` - transparent 180px touch icons.
+- `android-chrome-light-192x192.png`, `android-chrome-light-512x512.png` - transparent light-theme web app icons.
+- `android-chrome-dark-192x192.png`, `android-chrome-dark-512x512.png` - transparent dark-theme web app icons.
+- `android-chrome-192x192.png`, `android-chrome-512x512.png` - transparent light-theme fallback web app icons.
+- `site.webmanifest` - minimal web manifest that references the generated app icons.
+
+For HTML pages, use:
+
+```html
+
+
+
+
+
+
+
+
+```
+
+For inline display, use:
+
+```html
+
+
+
+
+
+```
diff --git a/docs/assets/brand/agentkeys-logo-1024.png b/docs/assets/brand/agentkeys-logo-1024.png
new file mode 100644
index 00000000..99f3d181
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-1024.png differ
diff --git a/docs/assets/brand/agentkeys-logo-256.png b/docs/assets/brand/agentkeys-logo-256.png
new file mode 100644
index 00000000..2d60f022
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-256.png differ
diff --git a/docs/assets/brand/agentkeys-logo-512.png b/docs/assets/brand/agentkeys-logo-512.png
new file mode 100644
index 00000000..9a176961
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-512.png differ
diff --git a/docs/assets/brand/agentkeys-logo-dark-1024.png b/docs/assets/brand/agentkeys-logo-dark-1024.png
new file mode 100644
index 00000000..d967e1fe
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-dark-1024.png differ
diff --git a/docs/assets/brand/agentkeys-logo-dark-256.png b/docs/assets/brand/agentkeys-logo-dark-256.png
new file mode 100644
index 00000000..390de852
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-dark-256.png differ
diff --git a/docs/assets/brand/agentkeys-logo-dark-512.png b/docs/assets/brand/agentkeys-logo-dark-512.png
new file mode 100644
index 00000000..14484f7f
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-dark-512.png differ
diff --git a/docs/assets/brand/agentkeys-logo-light-1024.png b/docs/assets/brand/agentkeys-logo-light-1024.png
new file mode 100644
index 00000000..99f3d181
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-light-1024.png differ
diff --git a/docs/assets/brand/agentkeys-logo-light-256.png b/docs/assets/brand/agentkeys-logo-light-256.png
new file mode 100644
index 00000000..2d60f022
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-light-256.png differ
diff --git a/docs/assets/brand/agentkeys-logo-light-512.png b/docs/assets/brand/agentkeys-logo-light-512.png
new file mode 100644
index 00000000..9a176961
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-light-512.png differ
diff --git a/docs/assets/brand/agentkeys-logo-source.png b/docs/assets/brand/agentkeys-logo-source.png
new file mode 100644
index 00000000..08699a0c
Binary files /dev/null and b/docs/assets/brand/agentkeys-logo-source.png differ
diff --git a/docs/assets/brand/android-chrome-192x192.png b/docs/assets/brand/android-chrome-192x192.png
new file mode 100644
index 00000000..73fa8c2d
Binary files /dev/null and b/docs/assets/brand/android-chrome-192x192.png differ
diff --git a/docs/assets/brand/android-chrome-512x512.png b/docs/assets/brand/android-chrome-512x512.png
new file mode 100644
index 00000000..f71fe263
Binary files /dev/null and b/docs/assets/brand/android-chrome-512x512.png differ
diff --git a/docs/assets/brand/android-chrome-dark-192x192.png b/docs/assets/brand/android-chrome-dark-192x192.png
new file mode 100644
index 00000000..df2bc3c5
Binary files /dev/null and b/docs/assets/brand/android-chrome-dark-192x192.png differ
diff --git a/docs/assets/brand/android-chrome-dark-512x512.png b/docs/assets/brand/android-chrome-dark-512x512.png
new file mode 100644
index 00000000..a2775cca
Binary files /dev/null and b/docs/assets/brand/android-chrome-dark-512x512.png differ
diff --git a/docs/assets/brand/android-chrome-light-192x192.png b/docs/assets/brand/android-chrome-light-192x192.png
new file mode 100644
index 00000000..73fa8c2d
Binary files /dev/null and b/docs/assets/brand/android-chrome-light-192x192.png differ
diff --git a/docs/assets/brand/android-chrome-light-512x512.png b/docs/assets/brand/android-chrome-light-512x512.png
new file mode 100644
index 00000000..f71fe263
Binary files /dev/null and b/docs/assets/brand/android-chrome-light-512x512.png differ
diff --git a/docs/assets/brand/apple-touch-icon-dark.png b/docs/assets/brand/apple-touch-icon-dark.png
new file mode 100644
index 00000000..383b693b
Binary files /dev/null and b/docs/assets/brand/apple-touch-icon-dark.png differ
diff --git a/docs/assets/brand/apple-touch-icon-light.png b/docs/assets/brand/apple-touch-icon-light.png
new file mode 100644
index 00000000..23b363e5
Binary files /dev/null and b/docs/assets/brand/apple-touch-icon-light.png differ
diff --git a/docs/assets/brand/apple-touch-icon.png b/docs/assets/brand/apple-touch-icon.png
new file mode 100644
index 00000000..23b363e5
Binary files /dev/null and b/docs/assets/brand/apple-touch-icon.png differ
diff --git a/docs/assets/brand/favicon-16x16.png b/docs/assets/brand/favicon-16x16.png
new file mode 100644
index 00000000..86b2373e
Binary files /dev/null and b/docs/assets/brand/favicon-16x16.png differ
diff --git a/docs/assets/brand/favicon-32x32.png b/docs/assets/brand/favicon-32x32.png
new file mode 100644
index 00000000..ab5db8b3
Binary files /dev/null and b/docs/assets/brand/favicon-32x32.png differ
diff --git a/docs/assets/brand/favicon-48x48.png b/docs/assets/brand/favicon-48x48.png
new file mode 100644
index 00000000..8531ef1f
Binary files /dev/null and b/docs/assets/brand/favicon-48x48.png differ
diff --git a/docs/assets/brand/favicon-dark-16x16.png b/docs/assets/brand/favicon-dark-16x16.png
new file mode 100644
index 00000000..47ddc1c8
Binary files /dev/null and b/docs/assets/brand/favicon-dark-16x16.png differ
diff --git a/docs/assets/brand/favicon-dark-32x32.png b/docs/assets/brand/favicon-dark-32x32.png
new file mode 100644
index 00000000..791dd548
Binary files /dev/null and b/docs/assets/brand/favicon-dark-32x32.png differ
diff --git a/docs/assets/brand/favicon-dark-48x48.png b/docs/assets/brand/favicon-dark-48x48.png
new file mode 100644
index 00000000..3c6db81d
Binary files /dev/null and b/docs/assets/brand/favicon-dark-48x48.png differ
diff --git a/docs/assets/brand/favicon-dark.ico b/docs/assets/brand/favicon-dark.ico
new file mode 100644
index 00000000..1a7d463a
Binary files /dev/null and b/docs/assets/brand/favicon-dark.ico differ
diff --git a/docs/assets/brand/favicon-light-16x16.png b/docs/assets/brand/favicon-light-16x16.png
new file mode 100644
index 00000000..86b2373e
Binary files /dev/null and b/docs/assets/brand/favicon-light-16x16.png differ
diff --git a/docs/assets/brand/favicon-light-32x32.png b/docs/assets/brand/favicon-light-32x32.png
new file mode 100644
index 00000000..ab5db8b3
Binary files /dev/null and b/docs/assets/brand/favicon-light-32x32.png differ
diff --git a/docs/assets/brand/favicon-light-48x48.png b/docs/assets/brand/favicon-light-48x48.png
new file mode 100644
index 00000000..8531ef1f
Binary files /dev/null and b/docs/assets/brand/favicon-light-48x48.png differ
diff --git a/docs/assets/brand/favicon-light.ico b/docs/assets/brand/favicon-light.ico
new file mode 100644
index 00000000..1a60f41c
Binary files /dev/null and b/docs/assets/brand/favicon-light.ico differ
diff --git a/docs/assets/brand/favicon.ico b/docs/assets/brand/favicon.ico
new file mode 100644
index 00000000..1a60f41c
Binary files /dev/null and b/docs/assets/brand/favicon.ico differ
diff --git a/docs/assets/brand/site.webmanifest b/docs/assets/brand/site.webmanifest
new file mode 100644
index 00000000..6837abd9
--- /dev/null
+++ b/docs/assets/brand/site.webmanifest
@@ -0,0 +1,19 @@
+{
+ "name": "AgentKeys",
+ "short_name": "AgentKeys",
+ "icons": [
+ {
+ "src": "android-chrome-light-192x192.png",
+ "sizes": "192x192",
+ "type": "image/png"
+ },
+ {
+ "src": "android-chrome-light-512x512.png",
+ "sizes": "512x512",
+ "type": "image/png"
+ }
+ ],
+ "theme_color": "#ffffff",
+ "background_color": "#ffffff",
+ "display": "standalone"
+}