Summary
Improve the og:image previews for better brand recognition and more informative social media cards.
Current State
- Implementation pages (
/{spec_id}/{library}): Show raw plot image from GCS
- Spec overview pages (
/{spec_id}): Show default og-image.png
Proposed Enhancements
1. Brand overlay for implementation images
Add pyplots.ai branding to implementation preview images:
┌─────────────────────────────┐
│ │
│ [Plot Image] │
│ │
├─────────────────────────────┤
│ 🎨 scatter-basic │
│ matplotlib · pyplots.ai │
└─────────────────────────────┘
Options:
- A) Generate branded images at impl-merge time (store in GCS)
- B) On-the-fly image composition (add endpoint
/og/{spec_id}/{library}.png)
2. Spec overview collage
Generate a composite og:image for spec overview pages showing multiple library implementations:
┌───────────┬───────────┐
│ matplotlib│ seaborn │
├───────────┼───────────┤
│ plotly │ bokeh │
└───────────┴───────────┘
scatter-basic · pyplots.ai
Options:
- A) Pre-generate collage at sync time when all impls are ready
- B) On-the-fly generation with caching
Acceptance Criteria
Technical Notes
- Consider using Pillow for image composition
- Could reuse
core/images.py infrastructure
- GCS storage:
plots/{spec_id}/og-overview.png for collages
Related
Summary
Improve the og:image previews for better brand recognition and more informative social media cards.
Current State
/{spec_id}/{library}): Show raw plot image from GCS/{spec_id}): Show defaultog-image.pngProposed Enhancements
1. Brand overlay for implementation images
Add pyplots.ai branding to implementation preview images:
Options:
/og/{spec_id}/{library}.png)2. Spec overview collage
Generate a composite og:image for spec overview pages showing multiple library implementations:
Options:
Acceptance Criteria
Technical Notes
core/images.pyinfrastructureplots/{spec_id}/og-overview.pngfor collagesRelated