Skip to content

feat(landing): measured proof in the hero and READMEs, real download count - #215

Merged
jb-thery merged 3 commits into
developfrom
feature/landing-proof-and-counter
Oct 27, 2026
Merged

jb-thery merged 3 commits into
developfrom
feature/landing-proof-and-counter

Conversation

@jb-thery

Copy link
Copy Markdown
Member

Why

A content comparison with the homepages of eight successful open-source tools (vite.dev, zod.dev, trpc.io, biomejs.dev, orama.com, context7.com, mem0.ai, trychroma.com) found that 5 of 8 show a measured claim in the hero, and 7 of 8 show social proof. ragmir.com showed four qualitative tiles, and its only social proof, the npm download counter, rendered 0 in the served HTML: it started from 0 and counted up after hydration, so link previews, crawlers, agents reading the page, and readers without JavaScript saw "0 Ragmir downloads/month on npm".

Changes

  • Counter: starts from the build-time count and only animates later changes.
  • Hero: a proof line under the download count states the README benchmark (93% of real developer questions find the right file in the top 10, 40 ms median search on a 43,874-chunk monorepo) in English and French, linked to the benchmarks. The public contract test locks the numbers and the link.
  • READMEs: the same measured proof right under the tagline, as mem0, Zod, and Orama do.

Verification

  • Built page: the static HTML shows "1,534 Ragmir downloads/month on npm" (French: "1 534") and the proof line in both locales.
  • After the change, the landing carries every convention that at least half of the eight reference homepages share: install call to action, GitHub link, install command, measured claim, social proof, and code example.
  • Landing tests (25), Biome, public surface smoke, and the published README smoke pass.

The counter started from 0 and counted up after hydration, so the served HTML, link previews,
crawlers, agents reading the page, and readers without JavaScript saw "0 Ragmir downloads/month
on npm". It now starts from the build-time count and only animates later changes.
Most landing pages of successful open-source tools show a measured claim in the hero; Ragmir's
four hero tiles were qualitative. A proof line under the download count now states the README
benchmark (93% of real developer questions find the right file in the top 10, 40 ms median
search on a 43,874-chunk monorepo) in English and French and links to the benchmarks. The public
contract test locks the numbers and the link.
Like the READMEs of mem0, Zod, and Orama, both READMEs now state a measured proof right under
the tagline: 93% of real developer questions find the right file in the top 10 and median search
takes 40 ms on a 43,874-chunk monorepo, with a link to the benchmarks.
@jb-thery
jb-thery merged commit 736aa63 into develop Oct 27, 2026
12 checks passed
@jb-thery
jb-thery deleted the feature/landing-proof-and-counter branch October 27, 2026 17:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant