Transform your coding activity into beautiful year-in-review reports. Track your GitHub contributions or Claude Code usage — all processed client-side in your browser.
- 🎯 GitHub Wrapped: Discover how many years you've been coding, from your first commit to now
- 📊 Beautiful Visualizations: Year-long activity heatmaps, contribution streaks, top languages
- ⚡ Simple & Fast: Just enter your GitHub username or upload Claude Code data
- 📸 Share Ready: Download or copy your wrapped summary as a shareable image
- 🔒 100% Private: All processing happens in your browser, nothing uploaded to servers
- 💯 Free & Open Source: No costs, no tracking, no limits
- 🎨 Responsive Design: Works beautifully on desktop and mobile
The easiest way to get your Year in Code report:
- 🌐 Visit yearincode.xyz
- 📝 Enter your GitHub username
- 🎉 Get your wrapped report instantly!
What you'll discover:
- Years in Code: See which year of coding you're in (calculated from your very first commit!)
- Total Contributions: All your commits, PRs, and issues for the year
- Longest Streak: Your best consecutive contribution days
- Top Languages: Your most-used programming languages
- Peak Activity: Your most productive month and day of the week
- Total Stars: Stars earned across all your repositories
For Claude Code users who want to visualize their AI-assisted coding activity:
You need ccusage to generate your usage data. No installation needed:
# Check if you have Claude Code usage data
npx -y ccusage@latest dailyExport your Claude Code usage as JSON:
# For 2025 data (macOS/Linux)
npx -y ccusage@latest daily --since 20250101 --until 20251231 --json > ~/Desktop/my-wrapped-2025.json
# For 2025 data (Windows PowerShell)
npx -y ccusage@latest daily --since 20250101 --until 20251231 --json > $HOME\Desktop\my-wrapped-2025.json
# For 2024 data
npx -y ccusage@latest daily --since 20240101 --until 20241231 --json > ~/Desktop/my-wrapped-2024.json💡 Tip: Always include
@latestto ensure you're using the newest version of ccusage
- 🌐 Visit yearincode.xyz
- 🔄 Switch to "Claude Code" tab
- 📤 Upload your JSON file (drag & drop supported)
- 🎉 View your beautiful wrapped report!
What you'll get:
- 📊 Total Tokens: See your complete token usage for the year
- 🔥 Longest Streak: Your best coding consistency streak
- 🤖 Top 3 Models: Most-used Claude models (Sonnet, Opus, Haiku)
- 📅 Activity Heatmap: 365-day visualization of your coding activity
- 📸 Shareable Card: Beautiful summary card to download or share
Year in Code transforms your coding data into an engaging year-in-review experience:
- 🎁 Wrapped Experience: Inspired by Spotify Wrapped and GitHub Wrapped
- 🎯 Unique Insight: Discover which year of coding you're in — from your very first commit!
- 🚀 Multi-Tool Support: Works with GitHub and Claude Code
- 🔧 Simple to Use: No complex setup, just a username or a file upload
- 💝 Open Source: Free for everyone to use and contribute
- Node.js 18+ installed
# Clone the repository
git clone https://github.com/isaadgulzar/year-in-code.git
cd year-in-code
# Install dependencies
npm install
# Run development server
npm run devOpen http://localhost:3000 to see the app!
- GitHub Mode: Fetches public data from GitHub's API using the public GitHub Contributions API
- Claude Code Mode: Processes your JSON file 100% client-side in your browser — your data never leaves your computer!
All processing happens in your browser. We don't store or collect any of your data.
- Framework: Next.js 15 (App Router)
- Styling: Tailwind CSS
- Language: TypeScript
- Deployment: Vercel
- APIs: GitHub Contributions API (public data only)
# Run development server
npm run dev
# Build for production
npm run build
# Start production server
npm start
# Lint code
npm run lint- Click the button above
- Deploy - no environment variables needed!
# Build the app
npm run build
# Deploy to Netlify, Railway, Cloudflare Pages, etc.No environment variables required! The app works completely standalone with no backend dependencies.
When you use GitHub mode, we find your very first commit date across all your public repositories and calculate how many years have passed since then. This gives you a unique perspective on your coding journey!
Yes!
- GitHub mode: Only fetches public contribution data that's already visible on your GitHub profile
- Claude Code mode: Processes files entirely in your browser — nothing is uploaded to our servers
You need the ccusage CLI. No installation required:
# Check your usage first
npx -y ccusage@latest daily
# Then export as JSON for Year in Code
npx -y ccusage@latest daily --since 20250101 --until 20251231 --json > ~/Desktop/my-wrapped.jsonCurrently, each upload processes one year at a time. Multi-year comparison is on the roadmap!
Click the "Download" button to save your summary card as PNG, or use "Copy" to copy it to your clipboard for easy sharing on social media. You can also use "Share on X" for direct Twitter sharing!
Yes! Use this format: yearincode.xyz/2025/github/your-username
Example: yearincode.xyz/2025/github/isaadgulzar
- GitHub integration with "Years in Code" feature
- Direct link sharing for GitHub wrapped
- Support for more ccusage output formats
- Multi-year comparison view
- More detailed analytics (hourly breakdown, commit patterns)
- Custom color themes
- PDF export option
- More AI coding tools (Cursor, Copilot)
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
MIT License - see LICENSE file for details
This project wouldn't exist without:
- 🎵 Spotify Wrapped & GitHub Wrapped: Inspiration for the wrapped experience
- 🌐 GitHub Contributions API: Powers our GitHub integration
- 🔧 ccusage by @ryoppippi: The amazing CLI that powers Claude Code data generation
- 💜 Claude Code Community: For making AI-assisted coding amazing
- 🙏 Open Source: Built on the shoulders of giants (Next.js, Tailwind, html-to-image)
Special thanks to @winXzorin (Eren) for requesting the GitHub wrapped feature!
- 🐛 Report a bug
- 💡 Request a feature
- 💬 Join discussions
- ⭐ Star on GitHub - Show your support!
- 📊 ccusage - The official Claude Code usage analyzer CLI
- 🌐 GitHub Contributions API - Public GitHub contribution data
- 🌐 yearincode.xyz - Live demo and usage