Skip to content

Comments

fix(docs): match blog card images to post titles and fix broken badge#204

Merged
rubenmarcus merged 7 commits intomainfrom
fix/blog-cards-and-badge
Feb 19, 2026
Merged

fix(docs): match blog card images to post titles and fix broken badge#204
rubenmarcus merged 7 commits intomainfrom
fix/blog-cards-and-badge

Conversation

@rubenmarcus
Copy link
Member

Summary

  • Replace broken shields.io GitHub stars badge (showing INVALID) with custom "built with ralph-starter" badge with Ralph icon
  • Add dedicated og:image cards for 2 posts that were using another post's card image
  • Update all 14 card titles/subtitles to match actual blog post frontmatter
  • Fix "Five" → "5" on the AI agents comparison card

Details

Badge fix:
The shields.io/github/stars badge with for-the-badge style and custom colors was returning INVALID. Replaced with a custom PNG badge (includes @2x retina variant) showing Ralph icon + "built with ralph-starter".

Card image fixes:

Post Before After
Why autonomous AI coding loops work Showed "The Ralph Wiggum Technique" card Own card with correct title
Let your tests guide the AI Showed "Specs Are the New Code" card Own card with correct title
5 AI coding agents comparison Card said "Five" Card now says "5"

All other cards updated to match post titles more closely (lowercase, matching wording).

Test plan

  • Verify badge renders correctly in navbar
  • Verify all 14 blog posts show matching card images
  • Verify og:image tags match for social sharing

🤖 Generated with Claude Code

- Replace broken shields.io GitHub stars badge with custom "built with
  ralph-starter" badge (PNG with Ralph icon, includes @2x retina)
- Add dedicated card images for 2 posts that were using wrong cards:
  - why-autonomous-coding.md was showing "The Ralph Wiggum Technique" card
  - validation-driven-development.md was showing "Specs Are the New Code" card
- Update all card titles/subtitles to match actual blog post frontmatter
- Fix "Five AI Coding Agents" → "5 AI coding agents" on card image
- Regenerate all 14 blog card images with correct titles

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@github-actions
Copy link
Contributor

Issue Linking Reminder

This PR doesn't appear to have a linked issue. Consider linking to:

  • This repo: Closes #123
  • ralph-ideas: Closes multivmlabs/ralph-ideas#123

Using Closes, Fixes, or Resolves will auto-close the issue when this PR is merged.


If this PR doesn't need an issue, you can ignore this message.

@github-actions github-actions bot added bug Something isn't working documentation labels Feb 19, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Feb 19, 2026

🔗 Docs Preview

Preview URL: https://fix-blog-cards-and-badge.ralph-starter-docs.pages.dev

This preview was deployed from the latest commit on this PR.

@greptile-apps
Copy link
Contributor

greptile-apps bot commented Feb 19, 2026

Greptile Summary

This PR fixes documentation assets to ensure proper visual consistency. The broken shields.io GitHub stars badge (showing INVALID) has been replaced with a custom "built with ralph-starter" badge featuring the Ralph icon with retina display support. Two blog posts that were incorrectly using another post's card image now have their own dedicated og:image cards. All 14 blog card titles and subtitles have been updated in the image generation script to match the actual blog post frontmatter, including fixing "Five" to "5" on the AI agents comparison card.

Changes include:

  • Badge replacement with custom PNG assets (standard + @2x retina)
  • New dedicated card images for "why-autonomous-coding" and "validation-driven-dev" posts
  • Regenerated all 14 blog card images with corrected titles/subtitles
  • Updated blog post frontmatter to reference correct image paths

Confidence Score: 5/5

  • This PR is safe to merge with no risk
  • Documentation-only changes fixing visual assets with no code logic modifications. All changes are cosmetic updates to images, badge references, and image paths in markdown frontmatter.
  • No files require special attention

Important Files Changed

Filename Overview
docs/docusaurus.config.ts Replaced broken shields.io badge with custom PNG badge with retina support
docs/blog/2026-01-15-why-autonomous-coding.md Updated image path from ralph-wiggum-technique to dedicated why-autonomous-coding card
docs/blog/2026-01-20-validation-driven-development.md Updated image path from specs-new-code to dedicated validation-driven-dev card
docs/scripts/generate-blog-images.sh Updated all 14 card titles/subtitles to match blog frontmatter, fixed "Five" → "5"
docs/static/img/badge-built-with.png New custom badge PNG (standard resolution)
docs/static/img/blog/why-autonomous-coding.png New dedicated card image for "Why autonomous AI coding loops work" post
docs/static/img/blog/validation-driven-dev.png New dedicated card image for "Let your tests guide the AI" post

Last reviewed commit: fecb3a8

rubenmarcus and others added 6 commits February 19, 2026 01:16
- Regenerate dark badge with contrasting backgrounds (#1a1a1e / #333338)
- Add light variant badge (gray / amber)
- Create /badge page for users to customize and copy badge code
- Add badge section to README.md
- Move badge to footer, restore GitHub stars in navbar

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Ensure transparent alpha channel so the rx=8 rounded corners
from the SVG clip-path are preserved in the exported PNGs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Convert favicon-96x96.png to 14x14 base64 PNG for the shields.io
flat badge variant. The logo now shows the actual Ralph character
instead of a placeholder.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Upgrade Ralph logo from 14x14 to 32x32 base64 for sharper rendering
- Flat badge now renders at natural shields.io height (~20px) instead
  of being forced to 28px which made it look oversized and blurry

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Keep only Dark and Light custom badge variants which render
consistently at the right size and resolution.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@rubenmarcus rubenmarcus merged commit aede4d5 into main Feb 19, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant