A bird's-eye view of your year. See your entire Google Calendar on one screen.
Yearbird is a year-at-a-glance calendar visualization that syncs with your Google Calendar. See all 365 days on one screen with color-coded events, making it easy to spot patterns, plan ahead, and understand how you spend your time.
- 365-day view — See your entire year at once, no scrolling
- Google Calendar sync — Connects to your calendar with read-only access
- Color-coded categories — Events auto-categorized by type (work, travel, family, etc.)
- Multi-day events — Trips and projects shown as horizontal bars
- Privacy-first — Your data never leaves your browser, client-side only
- Free & open source — Host it yourself or use our Github hosted version
Year-at-a-glance grid |
Month-focused scroll mode |
Vertical expanded mode |
Event detail on hover |
Pick active calendars |
Hide noise with filters |
Fine-tune categories |
|
- Go to yearbird.com
- Click "Sign in with Google"
- See your year!
git clone https://github.com/mjaverto/yearbird.git
cd yearbird
npm install
npm run devOpen http://localhost:5173/yearbird/
npm run lint
npm run typecheck
npm run test
npm run test:ci- Vite + React 18 + TypeScript
- Tailwind CSS v4 + Catalyst UI Kit
- Google Identity Services (client-side OAuth)
- Google Calendar API v3
- GitHub Pages (static hosting)
Events are auto-categorized by keywords in their titles:
| Color | Category | Example Keywords |
|---|---|---|
| 🟣 Purple | Work | meeting, call, 1:1, sync |
| 🟢 Green | Races/Adventures | race, marathon, hike |
| 🟡 Yellow | Birthdays | birthday, bday |
| 🟠 Orange | Holidays/Trips | flight, hotel, vacation |
| 🔴 Red | Mini Adventures | reservation, concert |
| 🔵 Blue | Family | family, kids, anniversary |
| ⚪ Gray | Uncategorized | everything else |
Contributions are welcome! Please check the issues for things to work on.
MIT License — see LICENSE for details.