Skip to content

exisz/IsItStable

Repository files navigation

🔍 IsItStable.com

Evidence-based stability scores for npm packages. Because latest doesn't mean greatest.

Website npm version npm downloads License: MIT GitHub Issues Sponsor

🌐 Website: isitstable.com · 📦 npm: is-it-stable · 🐙 GitHub: exisz/IsItStable


What is this?

IsItStable answers one question: "Should I update?"

Every tracked package version gets a stability score backed by evidence: referenced GitHub issues, download stats, and community votes via GitHub reactions.

Install & Usage (CLI)

No install needed — just run:

npx is-it-stable openclaw

Or install globally:

npm install -g is-it-stable
is-it-stable openclaw

How it works

  1. Version issues are created in this repo with the format [v2026.4.23] PackageName
  2. Each issue contains a factual stability score, a brief comment, and evidence links
  3. You vote by reacting on the issue: 👍 = stable, 👎 = unstable
  4. The website reads from GitHub Issues via API — no database needed

API

All endpoints return JSON with Cache-Control headers.

GET /api/v1/{package}/verdict

Latest stability score for a package.

{
  "package": "openclaw",
  "version": "2026.4.23",
  "status": "score-only",
  "score": 82,
  "comment": "Ship it and sleep like a baby.",
  "thumbsUp": 12,
  "thumbsDown": 1
}

GET /api/v1/{package}/versions

All tracked versions for a package.

GET /api/v1/{package}/latest-stable

Best-scoring version. Includes an install command.

GET /api/v1/{package}/{version}

Detailed info for a specific version including referenced issues and stats.

Request a new package

Open an issue requesting the package you want tracked.

Development

pnpm install
pnpm dev

Optionally set GITHUB_TOKEN in .env.local for higher API rate limits:

GITHUB_TOKEN=ghp_...

Built with

Contributing

  1. Fork this repo
  2. Create a feature branch
  3. Submit a PR

For version score requests, open an issue instead.

Sponsors

These legends help keep the lights on:

Sponsors

Want to join them? Become a sponsor → 💛

License

MIT

About

Is It Stable? — Version stability verdicts for npm packages. Because upgrading shouldn't require courage.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

27 stars

Watchers

0 watching

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors