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 badge 
![Year Progress](https://awesometime.vercel.app/api)

Countdown to any date

Countdown badge 
![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:

--
DAYS
--
HRS
--
MIN
--
SEC

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

Week progress badge

The classic "days since" sign

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

More styles

Gradient style badge Minimal style badge Korean locale badge

14 built-in themes

Pass theme= on any badge, or use theme=auto to follow the viewer's OS/browser dark-mode setting.

tokyonight theme
tokyonight
dracula theme
dracula
nord theme
nord
gruvbox theme
gruvbox
onedark theme
onedark
monokai theme
monokai
cobalt theme
cobalt
synthwave theme
synthwave
solarized-dark theme
solarized-dark
github-dark theme
github-dark
radical theme
radical
ayu-dark theme
ayu-dark
![](https://awesometime.vercel.app/api?theme=dracula)

Use it as a library

npm install @jeongpd/awesometime
Source on GitHub · MIT License