Skip to content

fix(assets): replace placeholder icon with real logo across all editions #5

Description

@Kotmin

Problem

Installed extension shows as a flat blue rectangle in the toolbar / about:addons, on already-installed builds.

Root cause (confirmed by inspection, not manifest wiring)

  • icons and action.default_icon (16/48/128 PNG) are correctly wired in all three manifests: apps/firefox-extension/manifest.json, apps/chrome-extension/manifest.json, apps/edge-extension/manifest.json.
  • The actual PNG assets (apps/shared/assets/icon-{16,48,128}.png, synced to every edition by scripts/sync-extension-lib.sh) are flat solid mid-blue placeholders — all four copies are byte-identical (md5 c6f9d757e31a5796a5ec83af6f3ed22c for the 128px file). No logo/glyph exists yet. This is a missing design asset, not a code defect.

What's needed

Real icon artwork exported at minimum 16x16, 48x48, 128x128 PNG, dropped into apps/shared/assets/ (single source, synced to all editions automatically).

Per-store extra requirements (sourced from official docs)

  • Firefox AMO: separate store-listing icon upload, 128x128 PNG/JPEG. SVG is allowed in the manifest and can react to prefers-color-scheme for light/dark toolbar themes (Chromium doesn't support this) — optional nice-to-have, not required. (MDN icons)
  • Chrome Web Store: the store-listing icon reuses the same 128x128 PNG, but wants a 96x96 "safe zone" — 16px transparent padding on each side inside the 128 canvas, no hard border or heavy drop shadow. Optional extra listing assets: small promo tile 440x280, marquee 1400x560, screenshots 1280x800 (or 640x400). (Chrome: Supplying images)
  • Edge Add-ons: separate "extension logo" upload, 300x300 recommended (128x128 minimum), transparent PNG, needs to read clearly in both Edge light/dark themes. Optional promo tiles 440x280 / 1400x560, up to 6 screenshots (640x480 or 1280x800). (Publish a Microsoft Edge extension)

Acceptance criteria

  • Real logo replaces the blue placeholder at all manifest sizes (16/48/128) in apps/shared/assets/, synced to all editions via the existing sync script.
  • Icon reads clearly at 16px in a toolbar, in both light and dark browser themes. (partial — see comment)
  • A 96px-safe-zone variant is prepared if the 128px file is reused directly as the Chrome Web Store listing icon.
  • (Deferred, only when store listings actually get created) promo tile / screenshot assets sized per store.

Out of scope here

Actual store listing creation/publishing — tracked in the Chrome/Edge parity issue.

Relates to docs/improvement-spec.md S6 (dev-id cleanup) and docs/ai/questions-for-K.md Q1/Q3.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions