This project provides an api that serves a image file, of which the content is the date of the current day.
A dynamic, live-updating calendar widget for GitHub profiles.
Calendar-by-Cygra was built to bridge that gap. This project provides a lightweight, high-performance API that serves a dynamic image file reflecting the exact date of the current day. No more manual edits, no more outdated info—just a clean, automated badge that proves you are here, active, and building in real-time. ⚡
Customize your calendar widget by passing query parameters in the URL.
| ✨ Parameter | 📦 Type | 🧩 Description | 🎯 Default |
|---|---|---|---|
width |
number | Width of the generated image (in pixels). | 1200 |
height |
number | Height of the generated image (in pixels). | 100 |
textColor |
string | Text color (hex). Use %23 instead of #.Example: %23ffffff |
#000000 |
bgColor |
string | Background color (hex or transparent).Example: %23000000 |
#ffffff |
fontSize |
number | Font size of the text (in pixels). | 60 |
font |
string | Font family for the text. See → Available Fonts |
cheese-orange |
radius |
number | Corner roundness.0 = sharp • 50 = pill style |
0 |
title |
string | Custom text displayed inside the image. Use + for spaces |
Welcome! |
Customize the typography of your calendar using these unique font styles.
| Font Name | Visual Preview |
|---|---|
cheese-orange |
![]() |
bob |
![]() |
juicy-fills |
![]() |



