Repository navigation
🎯 Why v1.0.0
AEOrank started as a CLI that scored a URL. Over the last month it became an open-source AEO toolkit: a scoring engine, 10 file generators, 11 framework plugins, a GitHub App that posts Check Runs on every PR, a hosted dashboard, and a marketing site that scores a 92/100 on its own scanner.
This release is the line in the sand.
✨ What's new since v0.1.0
Platform
- GitHub App is fully live: webhook → QStash async scan → GitHub Check Run + PR comment. Install once, get an AEO grade on every PR with zero YAML.
- Dashboard v2 (
app.aeorank.dev) ported the marketing site's design system — monospace, crop-mark aesthetic, receipt-style score cards. - Marketing site v2 (
aeorank.dev) relaunched as the "AEO Inspector" — light, monospace, open-source forward. Public/scoreboardof 100 real scans. - Docs site (
docs.aeorank.dev) now hosts the full scoring reference, framework guides, and API docs.
Scoring engine
- Per-page scoring on a 0–75 scale with
PAGE_LEVEL_DIMENSIONSexport so plugin authors can surface partial breakdowns. - New CLI flags:
--page <path>for single-page reports,--pillar <name>to drill into one of the 5 pillars,--browserfor SPA scanning via Playwright. - Attribution generator — every generated file carries a short "generated by aeorank.dev" header, so a developer who encounters one in the wild has a path back to the tool.
Security
- All 80 Dependabot alerts (3 critical, 25 high, 43 moderate, 11 low) resolved in a single sweep. pnpm overrides pin 26 transitive packages to patched versions.
- Direct bumps:
@clerk/nextjs→ 7.2.3 (middleware auth-bypass fix),next→ 16.2.4 (DoS + smuggling + CSRF fixes),astro→ 5.18.1 (reflected XSS, auth bypass, path traversal).
Community
- CONTRIBUTING.md — a 30-minute on-ramp to your first PR.
- CODE_OF_CONDUCT.md (Contributor Covenant 2.1).
- Issue + PR templates — structured forms, security disclosures routed to private advisory flow.
- FUNDING.yml — GitHub Sponsors enabled.
- Seeded good-first-issues — Hugo, Jekyll, and SolidStart plugins + a scoring check + two CLI features, all scoped and reviewable.
📊 By the numbers
- 13 framework plugins on npm
- 36 scoring criteria across 5 pillars
- 10 AI-readable file generators
- 675 tests across 13 packages
- 0 vulnerabilities
- 92/100 — AEOrank's score on itself
🚀 Install
# CLI — one command
npx aeorank-cli scan https://your-site.com
# GitHub App — zero YAML
# → https://github.com/apps/aeorank
# Framework plugin
npm install @aeorank/next # or astro, nuxt, remix, sveltekit, gatsby, shopify, 11ty, vitepress, docusaurus🙏 Thanks
Powered by Linx Agency and Mindtrades. Built in the open under the MIT License.
If AEOrank saves you a $299/mo subscription, the best thank-you is sending it to one person who also needs it. The Share section of the README has one-click links for X, HN, Reddit, and LinkedIn.
Full changelog: v0.1.0...v1.0.0