feat: more badges

[trueberryless]

Description

Implement new API endpoint for badges with these different types:

• version: Shows the latest or specific version of the package.
• license: Displays the package license (e.g., MIT, Apache-2.0).
• size: Shows the install size (via Bundlephobia) or unpacked size.
• downloads: Displays monthly download statistics.
• downloads-day: Displays daily download statistics.
• downloads-week: Displays weekly download statistics.
• downloads-month: Alias for monthly download statistics.
• downloads-year: Displays yearly download statistics.
• vulnerabilities: Shows the number of vulnerabilities found via OSV. /
• dependencies: Lists the total count of package dependencies.
• created: Displays the date the package was first published.
• updated: Displays the date of the most recent modification.
• engines: Shows the supported Node.js version range.
• types: Indicates if TypeScript types are included. /
• maintainers: Displays the total count of package maintainers.
• deprecated: Shows if the package is active or deprecated. /
• quality: NPMS.io quality score based on linting and tests.
• popularity: NPMS.io popularity score based on downloads and stars.
• maintenance: NPMS.io maintenance score based on activity.
• score: The overall NPMS.io combined score.

Thoughts

1. I would like to document those changes, but I am really not sure if we even have docs for the API endpoints, so I left it out for now.
2. I wonder if we should keep the old endpoint as well, but redirect to the version type, as with this implementation the old route would be invalid and return 404 🤔 EDIT: I played around with this idea a little bit and this mostly results just in conflicts as the routes overlap (e.g. the package version will be returned and if a specific version is specified without /version/, it tries to match the route to the [type] route, so it fails. IMO we should drop the old route entirely to keep it clean and maintainable.

Examples

Here are some example badges:

• Closes Improve npmx custom badge #341

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ready	Preview, Comment	Feb 2, 2026 11:26am
npmx.dev	Ready	Preview, Comment	Feb 2, 2026 11:26am

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
npmx-lunaria	Ignored		Feb 2, 2026 11:26am

[btea]

npmx.dev/docs/content/2.guide/1.features.md

Line 95 in 368e2d0

You can add custom npmx badges to your markdown files using the following syntax: `[](https://npmx.dev/YOUR_PACKAGE)`

I think we can synchronize the functionality in the documentation.

[danielroe]

would you mind adding some links to show what they look like?

I'm wondering whether it's worth adding so many different badges when there are already badge apis ... but that's only a slight niggle - would love to know what folk think

[trueberryless]

Can we get a docs preview please? 🙏 Locally the dev:docs errors very likely due to Nix shell limiations…

[trueberryless]

would you mind adding some links to show what they look like?

Sure (gonna include them in the description as well):

I'm wondering whether it's worth adding so many different badges when there are already badge apis ... but that's only a slight niggle - would love to know what folk think

Yeah, I noticed them getting more and more, because I discovered this dropdown menu as well 😅

Currently, I fetch all the data fresh from NPM as I didn't exactly know where to get the info from elsewhere (eg some utils function…). Ideally, I would like to fetch the data from cached npmx functions and also filter them by what is relevant and what not. Do you wanna suggest which ones would be nice and which are unnecessary?

[Gugustinette]

I find it very useful to centralize every badges into one platform, specially if we are on our way to centralize all npm-related data.

It's a bit annoying to search for a given badge, like downloads per week ; searching for a good one, having it down or unmaintained sometimes... Make sense to take care of it in npmx imo.

Love the badges color btw, they look awesome ! I'm just not sure about contrast issues on the orange and green ones. Might be worth asking our a11y experts.