Skip to content

feat(brand): social-share cards, social kit & brand book#79

Merged
potiuk merged 1 commit into
apache:mainfrom
potiuk:feat/social-cards-and-brand-book
Jul 10, 2026
Merged

feat(brand): social-share cards, social kit & brand book#79
potiuk merged 1 commit into
apache:mainfrom
potiuk:feat/social-cards-and-brand-book

Conversation

@potiuk

@potiuk potiuk commented Jul 10, 2026

Copy link
Copy Markdown
Member

What & why

Sharing a Magpie link on social media showed the framework's default icon,
because BaseLayout emitted no Open Graph / Twitter meta tags at all — so
scrapers had nothing to use and fell back to a guess. This adds proper share
tags site-wide, plus a brand book and a ready-to-upload social-media kit.

Changes

  • Social-share meta (BaseLayout.astro): og:* / twitter:* tags +
    canonical on every page. summary_large_image pointing at a new branded
    1200×630 card (public/og-image.png). Pages can override via an image
    prop (the /brand page does).
  • Social-media kit (public/brand/): avatars (400, 1000) and banners sized
    per platform — X (1500×500), LinkedIn (1128×191), Fosstodon/Mastodon
    (1500×500), Bluesky (3000×1000).
  • Brand book (/brand): logo & mark with downloads, color palette (pulled
    from theme.css so it can't drift), typography, the social kit, and
    naming/trademark guidance.
  • Footers: added a "Brand assets" link under Project in both the shared
    SiteFooter and the landing-page footer.

Provenance / licensing

All artwork is rendered from the existing mark.svg and the project's own
self-hosted fonts (Jost & Inter, both OFL-1.1 — already bundled via
@fontsource). Only flat PNGs ship; no new font files or dependencies.

Notes

  • Social platforms cache unfurls aggressively — previously-shared links may keep
    showing the old preview until their cache expires (force-refresh via each
    platform's card validator).
  • Banner keeps key content centred; some platforms overlay the avatar on the
    banner's lower-left.

🤖 Generated with Claude Code

Links unfurled on social media fell back to the framework default icon
because BaseLayout emitted no Open Graph / Twitter meta tags. Add a full
set of share tags to every page, defaulting to a new branded 1200x630
card, plus a /brand brand book and a ready-to-upload social-media kit.

- BaseLayout: og:*/twitter:* tags + canonical; summary_large_image with
  the 1200x630 card (public/og-image.png); per-page image override prop.
- public/brand: avatars (400, 1000) and banners for X, LinkedIn,
  Fosstodon/Mastodon and Bluesky at each platform's recommended size.
- New /brand page: logo & mark, color palette (from theme.css),
  typography (all OFL-1.1), the social kit, and naming/trademark usage.
- Footer (both the shared SiteFooter and the landing footer): add a
  'Brand assets' link under Project.

Artwork is rendered from the existing mark.svg and the project's own
self-hosted OFL-1.1 fonts (Jost/Inter); only flat PNGs ship.
@potiuk potiuk merged commit e88b506 into apache:main Jul 10, 2026
1 check passed
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