GitHub Wrapped

Your year in code, Spotify Wrapped style

Visualize your GitHub journey with beautiful, interactive statistics

View Demo · Report Bug · Request Feature

---

Features

Statistics & Insights Total contributions, commits, PRs & issues Top programming languages with percentages Featured repositories by popularity Most productive day of the week Peak coding hours analysis Longest contribution streak Code review statistics

Personalization Developer Personality — Unique title based on your patterns Achievements — Unlockable badges for milestones Fun Facts — Interesting stats about your habits Night Owl or Early Bird detection

Display Modes

Terminal Mode	Classic Mode
Interactive terminal with typing animations	Clean, static presentation
~$ whoami style commands	// code comments styling

Share Everywhere

---

Quick Start

1. Visit the App

Go to alexbrea.github.io/github-wrapper

2. Enter Your Username

Type your GitHub username and choose your display mode

3. Explore Your Stats

Navigate through your personalized year in code

---

Using a Token (Recommended)

Why use a token?

Feature	Without Token	With Token
Public repos	Yes	Yes
Private repos	No	Yes
Real contribution count	No	Yes
Auto-detect username	No	Yes
API rate limit	60/hour	5,000/hour

Create Your Token

1. Click Create Token
2. Copy the generated token
3. Paste it in the app

Privacy First: Your token never leaves your browser. It's stored locally and only used for GitHub API calls.

---

Navigation

Action	Desktop	Mobile
Next slide	→ Space	Tap →
Previous	←	Tap ←
Exit	Esc	Tap ✕
Jump to slide	Click dots	Tap dots

---

Tech Stack

---

Project Structure

github-wrapper/
├── index.html          # Main app with Alpine.js
├── manifest.json       # PWA configuration
├── js/
│   ├── bundle.js       # Production bundle
│   ├── app.js          # Component logic
│   ├── constants/      # Config & i18n
│   └── services/       # API & utilities
└── README.md

---

Local Development

# Clone the repo
git clone https://github.com/AlexBrea/github-wrapper.git
cd github-wrapper

# Start a local server (choose one)
python3 -m http.server 8080    # Python
npx serve                       # Node.js
php -S localhost:8080          # PHP

# Open in browser
open http://localhost:8080

---

Privacy & Security

Aspect	Implementation
Processing	100% client-side
Token storage	Browser localStorage only
Analytics	None
Cookies	None
External calls	GitHub API only

---

Contributing

Contributions make the open-source community amazing. Any contributions are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

License

Distributed under the MIT License. See LICENSE for more information.

---

Star this repo if you found it useful

Built with Alpine.js, Tailwind CSS & GitHub API