← Commit history
README.md+29
@@ -78,6 +78,35 @@ no gradients, no emoji):   AppUserModelID that **carries the category**: the only way Win11 allows a taskbar tile to change   live. Grouped mode instead keeps one stable, pinnable `Adom.Pup` identity. +### Using pup's icons in your own tool (HD browser picker, launchers, menus)++If you are building a surface that offers "open a pup window" (a browser picker, a launcher tile, a+menu item), **use pup's real icon, not a stand-in.** The canonical, self-describing asset set lives+in the wiki repo at [`assets/pup-icons/`](assets/pup-icons/), in three formats:++- **SVG** (`pup-cat-*.svg`) — scalable, the right choice for a web/Tauri picker.+- **PNG** (`pup-cat-*-{32,48,128,256,512}.png`) — raster fallback / retina.+- **ICO** (`pup-cat-*.ico`) — Windows multi-size, for taskbar/shortcut contexts (256px frame is+  PNG-compressed, per the Vista+ rule, so it never renders as a generic document).++**For a launcher/picker item, use `pup-cat-default`** — the neutral teal browser-window tile. It is+what a pup window's taskbar button looks like before its content is known, so the picker previews the+real result. The five category icons above (`wiki`, `wiki-in`, `app`, `web`, `mixed`) are for+*showing an existing window's kind*, not for a generic "open pup" action.++Fetch any asset from the wiki without cloning:++```+https://wiki.adom.inc/api/v1/pages/adom-desktop-puppeteer-bridge/files/assets/pup-icons/pup-cat-default.svg+https://wiki.adom.inc/api/v1/pages/adom-desktop-puppeteer-bridge/files/assets/pup-icons/manifest.json+```++[`assets/pup-icons/manifest.json`](assets/pup-icons/manifest.json) is machine-readable: it maps each+icon id to its meaning, its glyph, and its file in every format, and names+`recommended_for_launcher` so a tool can pick the right one programmatically. Brand rule if you ever+redraw one: teal tile `#00b8b0` + dark-teal window body `#003d40` + a single-color teal glyph, no+gradients, shadows, or emoji.+ ## Real windows, one per type  Full windows as pup opens them (title bar, tabs, page). Note the tab title glyphs on the wiki pair
assets/pup-icons/manifest.jsonadded+106
@@ -0,0 +1,106 @@+{+  "schema": "pup-icons/v1",+  "brand": {+    "tile": "#00b8b0",+    "window_body": "#003d40",+    "note": "Teal rounded tile + dark-teal browser-window body + a monochrome teal glyph. Single color, no gradients/shadows/emoji (Adom brand icon law)."+  },+  "recommended_for_launcher": "pup-cat-default",+  "formats": {+    "svg": "scalable, ideal for web/Tauri pickers",+    "png": "raster at 32/48/128/256/512",+    "ico": "Windows multi-size (16-256, 256 PNG-compressed) for taskbar/shortcut contexts"+  },+  "icons": [+    {+      "id": "pup-cat-default",+      "kind": "launcher",+      "glyph": "teal tile + browser-window glyph (title dots + address bar)",+      "meaning": "A generic pup browser window. USE THIS for a launcher/picker item, a menu entry, or any 'open a pup window' affordance where the content category is not yet known.",+      "svg": "pup-cat-default.svg",+      "ico": "pup-cat-default.ico",+      "png": {+        "32": "pup-cat-default-32.png",+        "48": "pup-cat-default-48.png",+        "128": "pup-cat-default-128.png",+        "256": "pup-cat-default-256.png",+        "512": "pup-cat-default-512.png"+      }+    },+    {+      "id": "pup-cat-wiki",+      "kind": "category",+      "glyph": "open book",+      "meaning": "Adom wiki, PUBLIC view (logged out) \u2014 what the world sees.",+      "svg": "pup-cat-wiki.svg",+      "ico": "pup-cat-wiki.ico",+      "png": {+        "32": "pup-cat-wiki-32.png",+        "48": "pup-cat-wiki-48.png",+        "128": "pup-cat-wiki-128.png",+        "256": "pup-cat-wiki-256.png",+        "512": "pup-cat-wiki-512.png"+      }+    },+    {+      "id": "pup-cat-wiki-in",+      "kind": "category",+      "glyph": "book + person",+      "meaning": "Adom wiki, SIGNED IN \u2014 the user's logged-in view (private source, drafts, owner cards).",+      "svg": "pup-cat-wiki-in.svg",+      "ico": "pup-cat-wiki-in.ico",+      "png": {+        "32": "pup-cat-wiki-in-32.png",+        "48": "pup-cat-wiki-in-48.png",+        "128": "pup-cat-wiki-in-128.png",+        "256": "pup-cat-wiki-in-256.png",+        "512": "pup-cat-wiki-in-512.png"+      }+    },+    {+      "id": "pup-cat-app",+      "kind": "category",+      "glyph": "the Adom mark",+      "meaning": "An Adom app \u2014 localhost or a *.adom.cloud slug URL.",+      "svg": "pup-cat-app.svg",+      "ico": "pup-cat-app.ico",+      "png": {+        "32": "pup-cat-app-32.png",+        "48": "pup-cat-app-48.png",+        "128": "pup-cat-app-128.png",+        "256": "pup-cat-app-256.png",+        "512": "pup-cat-app-512.png"+      }+    },+    {+      "id": "pup-cat-web",+      "kind": "category",+      "glyph": "globe",+      "meaning": "The web \u2014 any other site.",+      "svg": "pup-cat-web.svg",+      "ico": "pup-cat-web.ico",+      "png": {+        "32": "pup-cat-web-32.png",+        "48": "pup-cat-web-48.png",+        "128": "pup-cat-web-128.png",+        "256": "pup-cat-web-256.png",+        "512": "pup-cat-web-512.png"+      }+    },+    {+      "id": "pup-cat-mixed",+      "kind": "category",+      "glyph": "two panes",+      "meaning": "Mixed \u2014 the window's tabs span more than one category.",+      "svg": "pup-cat-mixed.svg",+      "ico": "pup-cat-mixed.ico",+      "png": {+        "32": "pup-cat-mixed-32.png",+        "48": "pup-cat-mixed-48.png",+        "128": "pup-cat-mixed-128.png",+        "256": "pup-cat-mixed-256.png",+        "512": "pup-cat-mixed-512.png"+      }+    }+  ]+}\ No newline at end of file
assets/pup-icons/pup-cat-app.icoadded
⋯ 1 unchanged line ⋯
assets/pup-icons/pup-cat-app.svgadded+1
@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 244 244"><rect x="2" y="2" width="240" height="240" rx="35" fill="#00b8b0"/><rect x="44.0" y="55.7" width="156.0" height="132.6" rx="15.0" fill="#003d40"/><g transform="translate(66.308,66.308) scale(0.4565)"><path fill="#00b8b0" d="M173.76,70.24c-14.09-14.09-34.28-16.73-45.1-5.91-4.39,4.39-6.56,10.33-6.66,16.77h0v40.03c0,.48.39.88.88.88h39.52,0c6.64,0,12.77-2.16,17.28-6.66,10.82-10.82,8.18-31.02-5.91-45.1"/><path fill="#00b8b0" d="M70.24,173.76c14.09,14.09,34.28,16.73,45.1,5.91,4.39-4.39,6.56-10.33,6.66-16.77h0v-40.03c0-.48-.39-.88-.88-.88h-39.52,0c-6.64,0-12.77,2.16-17.28,6.66-10.82,10.82-8.18,31.02,5.91,45.1"/></g></svg>\ No newline at end of file
assets/pup-icons/pup-cat-default.icoadded
⋯ 1 unchanged line ⋯
assets/pup-icons/pup-cat-default.svgadded+1
@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 244 244"><rect x="2" y="2" width="240" height="240" rx="35" fill="#00b8b0"/><rect x="44.0" y="55.7" width="156.0" height="132.6" rx="15.0" fill="#003d40"/><g fill="none" stroke="#00b8b0" stroke-width="11" stroke-linecap="round"><line x1="44" y1="90" x2="200" y2="90"/></g><g fill="#00b8b0"><circle cx="63" cy="73" r="6.5"/><circle cx="85" cy="73" r="6.5"/><circle cx="107" cy="73" r="6.5"/></g><g fill="none" stroke="#00b8b0" stroke-width="11" stroke-linecap="round"><rect x="66" y="112" width="112" height="52" rx="9"/></g></svg>
assets/pup-icons/pup-cat-mixed.icoadded
⋯ 1 unchanged line ⋯
assets/pup-icons/pup-cat-mixed.svgadded+1
@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 244 244"><rect x="2" y="2" width="240" height="240" rx="35" fill="#00b8b0"/><rect x="44.0" y="55.7" width="156.0" height="132.6" rx="15.0" fill="#003d40"/><g transform="translate(68.96,76.92) scale(4.4200,3.7570)"><g fill="none" stroke="#00b8b0" stroke-width="2.04" stroke-linecap="round" stroke-linejoin="round"><rect x="2.0" y="3.6" width="13.0" height="10.8" rx="1.8"/><rect x="9.0" y="9.6" width="13.0" height="10.8" rx="1.8" fill="#00b8b0" stroke="none"/></g></g></svg>\ No newline at end of file
assets/pup-icons/pup-cat-web.icoadded
⋯ 1 unchanged line ⋯
assets/pup-icons/pup-cat-web.svgadded+1
@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 244 244"><rect x="2" y="2" width="240" height="240" rx="35" fill="#00b8b0"/><rect x="44.0" y="55.7" width="156.0" height="132.6" rx="15.0" fill="#003d40"/><g transform="translate(68.96,76.92) scale(4.4200,3.7570)"><g fill="none" stroke="#00b8b0" stroke-width="2.04" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9.0"/><path d="M3 12h18"/><path d="M12 3c2.6 2.7 3.9 5.7 3.9 9s-1.3 6.3-3.9 9c-2.6-2.7-3.9-5.7-3.9-9s1.3-6.3 3.9-9z"/></g></g></svg>\ No newline at end of file
assets/pup-icons/pup-cat-wiki-in.icoadded
⋯ 1 unchanged line ⋯
assets/pup-icons/pup-cat-wiki-in.svgadded+1
@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 244 244"><rect x="2" y="2" width="240" height="240" rx="35" fill="#00b8b0"/><rect x="44.0" y="55.7" width="156.0" height="132.6" rx="15.0" fill="#003d40"/><g transform="translate(68.96,76.92) scale(4.4200,3.7570)"><g fill="none" stroke="#00b8b0" stroke-width="2.04" stroke-linecap="round" stroke-linejoin="round"><g transform="translate(-1.8,-1.6) scale(0.82)"><path d="M12 5.5C10 3.9 7.4 3.1 5 3.1H3.2v17.8H5c2.4 0 5 .8 7 2.4"/><path d="M12 5.5c2-1.6 4.6-2.4 7-2.4h1.8v17.8H19c-2.4 0-5 .8-7 2.4"/><path d="M12 5.5v17.8"/></g><g fill="#00b8b0" stroke="none"><circle cx="17.6" cy="14.8" r="3.0"/><path d="M12.2 23.6c0-3.0 2.4-4.9 5.4-4.9s5.4 1.9 5.4 4.9z"/></g></g></g></svg>\ No newline at end of file
assets/pup-icons/pup-cat-wiki.icoadded
⋯ 1 unchanged line ⋯
assets/pup-icons/pup-cat-wiki.svgadded+1
@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 244 244"><rect x="2" y="2" width="240" height="240" rx="35" fill="#00b8b0"/><rect x="44.0" y="55.7" width="156.0" height="132.6" rx="15.0" fill="#003d40"/><g transform="translate(68.96,76.92) scale(4.4200,3.7570)"><g fill="none" stroke="#00b8b0" stroke-width="2.04" stroke-linecap="round" stroke-linejoin="round"><path d="M12 5.5C10 3.9 7.4 3.1 5 3.1H3.2v17.8H5c2.4 0 5 .8 7 2.4"/><path d="M12 5.5c2-1.6 4.6-2.4 7-2.4h1.8v17.8H19c-2.4 0-5 .8-7 2.4"/><path d="M12 5.5v17.8"/></g></g></svg>\ No newline at end of file