awesometime

Pretty, dynamic SVG badges for your GitHub README — year progress, doomsday-style countdowns, and a library to build your own.

Year progress — drop this in your README

![Year Progress](https://awesometime.vercel.app/api)

Countdown to any date

![Countdown](https://awesometime.vercel.app/api?type=countdown&date=2027-01-01&label=2027)

The image above updates on a caching schedule (see the README), not every second — that's the right tradeoff for something embedded in a static page. This ticks live because it's plain JavaScript on this page, not the badge itself:

Any period — day, week, month, quarter, year

The classic "days since" sign

![](https://awesometime.vercel.app/api?type=dayssince&date=2026-08-01&label=Last%20Incident)

More styles

Use it as a library

npm install @jeongpd/awesometime