Astro Performance CLI

An open-source CLI tool that audits Astro sites for performance issues. It checks for image optimization, bundle sizes, render performance, edge compatibility, and more.

Why I built it

I was reviewing Astro codebases at work and finding the same 10 issues over and over. I automated them. Then I added 40 more checks. Then I open-sourced it.

Features

• 50+ automated checks across images, JS, CSS, fonts, hydration, and edge
• CI/CD integration — exit codes and JSON output for GitHub Actions
• Detailed reports with fix suggestions and links to docs
• Auto-fix mode for the 15 most common issues
• Zero config — works on any Astro project out of the box

Adoption

• 8.2k+ GitHub stars
• 340k+ weekly npm downloads
• Used by Astro, Vercel, Netlify, and Cloudflare in their CI templates
• Contributors: 47 community members

What I learned

A CLI is a UX problem, not a technical one. The hardest part was not the checks — it was designing the output so that a developer in a hurry could scan it in 10 seconds and know what to fix.