Skip to content

v1.0.0 — The distribution release

Latest

Choose a tag to compare

@vinpatel vinpatel released this 20 Apr 21:53
· 500 commits to main since this release

🎯 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 /scoreboard of 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_DIMENSIONS export 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, --browser for 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