Skip to content

feat: brand kit, animated README banner, and docs branding#68

Merged
joaomdsg merged 1 commit into
mainfrom
feat/branding-assets
May 31, 2026
Merged

feat: brand kit, animated README banner, and docs branding#68
joaomdsg merged 1 commit into
mainfrom
feat/branding-assets

Conversation

@joaomdsg

Copy link
Copy Markdown
Member

Adds a real brand identity, sourced from a Claude Design handoff bundle.

What's in it

branding/ (repo root) — the canonical logo kit

  • Wordmark (plain + amber-slash), bolt (filled + outline), 4 app icons, and the
    punch APNG animation, each with light/dark variants where theme matters.
  • Palette: ink #0b0b0f (light bg), cream #efece4 (dark bg), amber #ffbf00.
  • branding/README.md documents the <picture> embed pattern for each mark.

README banner

  • Static logo.svg → animated punch APNG in a theme-aware <picture>.
  • Verified to render on github.com and pkg.go.dev (both allow-list
    <picture> and rewrite relative srcset/src to raw URLs).

Docs site (just-the-docs)

  • Sidebar wordmark logo (cream letters + amber slash, reads on the dark sidebar)
    via site.logo.
  • SVG favicon (amber app icon) + theme-color for mobile chrome.
  • Assets vendored under docs/assets/branding/ because GitHub Pages serves only
    from docs/. Confirmed via a local Jekyll build (logo CSS, favicon, and
    assets all land in _site).

Cleanup

  • Removes the now-orphaned root logo.svg (zero references after the swap).

Reviewed

Adversarial review (rendering / completeness / hygiene) found no blockers.
All vendored SVGs verified script/external-ref free.

Deferred (follow-ups, not blocking)

  • No apple-touch-icon PNG (SVG favicon covers desktop; iOS home-screen tile
    would want a raster).
  • OG/social card still uses the product demo GIF (a stronger preview than a
    bare logo).
  • The two APNG variants are ~1.4MB each (only the theme-matching one is fetched).

Adds branding/ at repo root — a theme-aware logo kit exported from Claude
Design: wordmark (plain + amber-slash), bolt (filled + outline), four app
icons, and the punch APNG animation, with a README documenting embed usage.
Light files use ink (#0b0b0f), dark use cream (#efece4), amber is #ffbf00.

- README banner: static logo.svg -> animated punch APNG in a theme-aware
  <picture> (dark/light pair). Verified to render on github.com and
  pkg.go.dev (both allow <picture> and rewrite relative srcset/src).
- Docs site (just-the-docs): sidebar wordmark logo (amber-slash on the dark
  sidebar) via site.logo, plus an SVG favicon (amber app icon) and a
  theme-color meta. Assets vendored under docs/assets/branding/ since Pages
  serves only from docs/. Confirmed via a local Jekyll build.
- Remove now-orphaned root logo.svg (no remaining references).
@joaomdsg
joaomdsg merged commit 331a2c1 into main May 31, 2026
6 checks passed
@joaomdsg
joaomdsg deleted the feat/branding-assets branch May 31, 2026 12:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant