diff --git a/docs/superpowers/specs/2026-04-24-relicario-logo-refresh-design.md b/docs/superpowers/specs/2026-04-24-relicario-logo-refresh-design.md new file mode 100644 index 0000000..0771228 --- /dev/null +++ b/docs/superpowers/specs/2026-04-24-relicario-logo-refresh-design.md @@ -0,0 +1,250 @@ +# Logo refresh + extension palette shift — design + +**Date:** 2026-04-24 +**Scope:** Replace the existing arched-niche-with-blue-gem logo with a reliquary-faithful round chapel theca, and shift the extension's primary accent from GitHub-blue to a burnished gold that matches the new logo. Backgrounds and CLI feel preserved. + +## Goal + +The current logo reads as "modern shrine with a blue diamond" — visually correct in concept (a vessel that holds something precious) but blue-techy enough that the project's name (*relicario* — Spanish/Italian for *reliquary*) no longer comes through. The user wants more catholic-reliquary authenticity (gold, deep red, decorative finial) without the cross — closer to the user-supplied references of round-chapel theca reliquaries. + +The popup currently uses GitHub's dark-blue accent palette throughout. Once the logo shifts to gold, leaving the popup's blue accents in place would create visual whiplash between the toolbar icon and the popup body. The palette shift converts blue → gold and tunes the danger red toward the logo's theca tone, while keeping the dark backgrounds, monospace-ish text, and CLI restraint that define the project's voice. + +## Visual identity + +### Silhouette + +Round chapel-style theca with a fleur-de-lis finial and a compact pedestal. Inspired by user-supplied references of monstrance-style theca reliquaries (round display window in a gold ring, on a small turned base). No cross — the catholic visual vocabulary is preserved through the fleur-de-lis, the deep-red theca, and the burnished gold body. + +Composition (master, 220 × 240 viewBox): + +- **Pedestal** — y=202 to y=230 (28 units total, ~60% of the original draft): + - Stem cap: ellipse (cx=110, cy=202, rx=18, ry=4) + - Stem column: rect (x=98, y=202, w=24, h=12) with a darker knurl ring mid-stem (`ellipse cx=110 cy=208 rx=14 ry=3`) + - Base plate: rect (x=78, y=212, w=64, h=14, rx=2) + - Foot ring: ellipse (cx=110, cy=226, rx=44, ry=5) +- **Body** — circle (cx=110, cy=130, r=72) in gold; inner bezel ring (r=60) in deep gold; deep-red theca (r=56) with radial gradient + - Subtle upper-left bevel highlight: arc-stroke at top-left of body + - Soft glass glint on the theca: white ellipse @ 14% opacity, rotated −30° +- **Asterisk gem** (the "relic" inside the theca): + - 6 arms at 60° increments + - Each arm: lozenge (base width 8, slight bulge mid-arm, pointed tip at 36 from center) + - **Pinwheel facet split** — every arm is bright (`#f5d97a`) on the CCW side, dark (`#8a5e1c`) on the CW side + - Center hex facet (mid gold) + sparkle dot (off-white) for that "cut gem" read +- **Hinge collar** — small rect (x=98, y=50, w=24, h=10, rx=2) with a horizontal accent line, where the body meets the fleur +- **Fleur-de-lis** (rooted into the hinge collar, occupies y=−16 to y=50): + - Thicker stem (7 wide, 12 tall) + - Tie-band: rect 32 × 7, with a darker knot rectangle in the middle + - Center petal: tall teardrop with an inner shadow line and a small pearl at the tip + - Side petals: S-curve outward with a small dark accent on the outer curl + - Sized so the fleur is ~35% the body's diameter — present but doesn't dominate + +### 16 px treatment (favicon) + +Pedestal is dropped entirely — it would compress to 1–2 pixels of indistinct gold noise. The 16 px form is the bare medallion: round body + fleur on top. + +ViewBox 16 × 16: + +- Body: circle (cx=8, cy=9, r=6.5) gold; inner red theca (r=4.8) +- Gem: three crossing 1.2 px lines (vertical + two diagonals) in bright gold + a 0.7 px sparkle dot — reads as `*` at all zoom levels +- Fleur: three triangular tips above the body (center peak at y=0, side wings peaking at y=1, all bases on y=2.5) + +### Palette + +Backgrounds and text colors are unchanged from the existing GitHub-dark base — preserves the CLI feel. + +| Use | Old | New | +|-----|-----|-----| +| Logo gold (bright) | n/a | `#d2ab43` | +| Logo gold (mid) | n/a | `#aa812a` | +| Logo gold (deep) | n/a | `#7c5719` | +| Logo gold (highlight) | n/a | `#f5d97a` | +| Logo gold (shadow) | n/a | `#8a5e1c` | +| Logo red (theca bright) | n/a | `#9a1a1a` | +| Logo red (theca shadow) | n/a | `#3a0a0a` | +| **Primary button bg** | `#1f6feb` | `#7c5719` | +| **Primary button hover** | `#388bfd` | `#aa812a` | +| **Primary text / link** | `#58a6ff` | `#d2ab43` | +| **Focus ring / outline** | `#58a6ff` (often @ 30%) | `#aa812a` (@ 40%) | +| **Selected row tint** | `rgba(88,166,255,0.12)` | `rgba(170,129,42,0.11)` | +| **Selected row left-border** | `#58a6ff` / `#1f6feb` | `#aa812a` | +| **Danger fg** | `#f85149` | `#ab2b20` | +| **Danger emphasis bg** | `#da3633` | `#791111` | +| **Sig-block --blue** | `#1f6feb` | `#aa812a` (renamed `--gold`) | +| **TOTP ring stroke** | `#58a6ff` | `#d2ab43` | +| **Backgrounds** | `#0d1117` / `#161b22` / `#21262d` / `#30363d` | unchanged | +| **Text fg / muted / dim** | `#c9d1d9` / `#8b949e` / `#6e7681` | unchanged | +| **Status success** | `#3fb950` | unchanged | +| **Status warning** | `#d29922` | unchanged | + +The B/C midpoint gold ramp comes from RGB midpoints between two earlier candidate palettes (a "burnished" 10%-darker variant and an "antique" 20%-darker variant). + +## Files affected + +### New / replaced asset files + +- **`extension/icons/relicario-logo.svg`** — replace entirely with the new master (220 × 240 viewBox, gold/red). +- **`extension/icons/relicario-logo-16.svg`** — replace entirely with the bare-medallion 16 px version (16 × 16 viewBox). +- **`extension/icons/icon-16.png`** — regenerate from `relicario-logo-16.svg` via ImageMagick. +- **`extension/icons/icon-48.png`** — regenerate from `relicario-logo.svg` (the master) at 48 × 48. +- **`extension/icons/icon-128.png`** — regenerate from `relicario-logo.svg` at 128 × 128. + +### Code files touching colors + +- **`extension/src/popup/styles.css`** — bulk find-and-replace of the blue/red hex values per the table above. ~20 hits. +- **`extension/src/popup/components/types/login.ts`** — line 50: link color `#58a6ff` → `#d2ab43`. +- **`extension/src/popup/components/types/totp.ts`** — line 60: TOTP ring stroke `#58a6ff` → `#d2ab43`. +- **`extension/src/popup/components/generator-popover.ts`** — line 283: validation error color `#f85149` → `#ab2b20`. +- **`extension/src/popup/components/settings.ts`** — lines 28, 52, 53: blacklist-remove `#f85149` → `#ab2b20`; bar/toast active state `#1f6feb` → `#7c5719`. +- **`extension/src/content/capture.ts`** — lines 184, 195: hostname text `#58a6ff` → `#d2ab43`; save button bg `#1f6feb` → `#7c5719`. +- **`extension/src/content/icon.ts`** — lines 73, 203: ack-prompt button bg `#1f6feb` → `#7c5719`; title color `#58a6ff` → `#d2ab43`. +- **`extension/setup.html`** — strength-bar very-weak `#f85149` → `#ab2b20`; advice block left-border `#1f6feb` → `#aa812a`; match/test result fail `#f85149` → `#ab2b20`. (Strength bar's other gradient stops should be re-tuned to match — e.g., weak/medium/strong should still progress visually.) + +### Test files + +No new tests required — palette + logo are visual changes. Existing 124 Vitest + 155 Rust tests should remain green throughout (the changes are CSS hex strings + SVG markup; no behavior changes). + +## Acceptance + +- [ ] `extension/icons/relicario-logo.svg` matches the master design (gold body, red theca, asterisk gem with pinwheel facets, fleur-de-lis finial, compact pedestal). +- [ ] `extension/icons/relicario-logo-16.svg` matches the bare-medallion 16 px design (no pedestal). +- [ ] `extension/icons/icon-16.png`, `icon-48.png`, `icon-128.png` regenerated from the SVGs and visually correct at the toolbar. +- [ ] `git grep -nE '#(58a6ff|1f6feb|388bfd|f85149|da3633)' extension/` returns zero hits in `src/` and `setup.html` (it can still appear in `node_modules/`, `dist/`, `dist-firefox/` — those don't matter). +- [ ] `bun run build:all` passes for both Chrome and Firefox bundles. +- [ ] `bun run test` passes (124/124). +- [ ] `cargo test --workspace` passes (155/155). +- [ ] Manual smoke check: load `extension/dist/` in Chrome → toolbar icon shows the new logo → open popup → primary buttons (`+ New`, `autofill`, `save`) are gold-bg → focus rings on inputs are gold → selected list row has gold left-border + tint → danger buttons (trash, delete) are theca-red → TOTP countdown ring is gold. + +## Out of scope + +- The capture-prompt and ack-prompt content-script DOM (closed Shadow DOM): inline colors get updated, but no layout/UX changes. +- New icon sizes (256, 512, etc.). Current set is 16/48/128, matching `manifest.json`. +- Rendering paths that already use gold-friendly colors (success green, warning yellow). Those stay. +- Logo sizes for App Store / web favicon / social cards. None of those exist yet for this project; defer. + +## Open questions deferred to plan + +- **Setup-page strength bar color ramp:** β₀ used `#f85149 → #d29922 → #3fb950` for very-weak → medium → strong. The danger red is now `#ab2b20`; do we keep the warning yellow / success green unchanged for the gradient (mixed-temperature ramp), or also shift them toward the warmer family (e.g. amber instead of yellow)? Plan defaults to keeping yellow/green untouched — the bar's role is functional accessibility, and the universal red→yellow→green semantics are stronger than aesthetic coherence. +- **Sig-block class rename:** existing CSS classes are `sig-block--blue`, `sig-block--red`. After the swap, `--blue` no longer matches the rendered color. Plan options: (a) keep names, accept the mismatch (zero risk, semantically wrong), (b) rename to `--gold` / `--red` (touches all consumers — cheap to do and worth doing). Plan ships (b). +- **PNG regeneration tool:** project memory specifies ImageMagick (`magick`) over `rsvg-convert`. Plan will use `magick -background none -density 384 input.svg -resize 128x128 output.png` (and 48, 16) per memory. +- **WAR / CSP:** SVG files are loaded as extension-origin assets, no MV3 web-accessible-resources changes needed. Confirmed by inspecting current manifest (WAR is empty). + +## Master SVG (full source) + +Embedded for reference — implementation plan will copy this verbatim into `extension/icons/relicario-logo.svg`. + +```svg + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +``` + +## 16 px SVG (full source) + +```svg + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +```