badgesize.io

What It Is

BadgeSize is an online badge service for developers that generates size badges based on the content length of any accessible file. It can read files from GitHub repositories, npm packages, CDN services, or self-hosted endpoints, and displays the size based on the Content-Length returned by the file host. Typical use cases include showing the size of build artifacts, scripts, stylesheets, or package files in a project README.

Core Features and Technical Details

Functionally, BadgeSize has a very narrow but clear focus: generating “file size” badges. By default, the displayed size does not include the size of response headers; it focuses on the file content size that end users actually receive. The service also supports requesting a specific compression type. However, if the origin server does not provide a Content-Length for that compression format, the result may fall back to the full uncompressed size. There is also an internal maximum file size limit, though the exact threshold is not disclosed.

In terms of scalability, it fetches files on demand and caches results internally. Its caching mechanism combines a FIFO-style item-count cache, a minimum cache period of 24 hours, and the origin server’s Cache-Control / Expires headers. When npm package files are served via a CDN, the internal cache and badge result may be set to 1 year to reduce request volume and hosting costs.

Pricing, API, and Ecosystem

The reviewed content does not disclose any pricing plans, payment methods, or commercial packages. In terms of usage, the page mentions that the service can be called via formatted URLs with optional parameters, and provides links to Usage Details and Examples. However, the main text does not include concrete API parameter examples, and no SDK information was found. Ecosystem integration mainly centers on GitHub README files, npm, CDNs, and any accessible URL. Support is handled through Issues or requests in a public GitHub repo.

Pros, Cons, and Best-Fit Users

Its advantages are that it is simple and straightforward, requires no changes to project code, and is well suited for open-source maintainers who want to display artifact sizes. Its caching design also helps control costs and reduce requests to origin servers. The drawbacks are also clear: the status page explicitly states that the site and service are incomplete and under construction. It is currently in an alpha testing/evaluation stage, with no formal timeline for leaving alpha and no higher-level support commitments.

Access from China and Alternatives

The reviewed content does not provide information about access from mainland China, network connectivity, or payment, so China accessibility can only be marked as unknown. If you need a more mature general-purpose badge service, consider shields.io or badgen.net. If stability and control are priorities, you can also calculate file sizes in your CI workflow and generate static badges yourself.