your annual developer recap, generated from real GitHub activity — Spotify Wrapped for your commit history
GitHub Wrapped analyzes a developer's public GitHub activity — commits, repositories, languages, and working hours — and turns it into a personalized, shareable annual recap, in the style of Spotify Wrapped. The goal isn't just to show numbers: it's to surface behavioral insights that help developers actually understand their habits, backed by an Analytics Engine that computes every statistic before any AI-generated narration touches it.
The platform connects via GitHub OAuth, syncs activity through a background job queue (never inline in an HTTP request), and generates a slide-by-slide Wrapped experience with public, shareable pages and auto-generated Open Graph images.
| - Full activity sync via GitHub REST + GraphQL, timezone-aware. | - Analytics Engine independent of GitHub, the DB, and the UI. |
| - AI-narrated insights over pre-computed statistics, never guessed. | - Shareable public Wrapped pages with auto-generated OG images. |
| - Badges, comparisons between users, and year-over-year tracking. | - Encrypted tokens, IDOR-safe endpoints, HMAC-verified webhooks. |
The objective of GitHub Wrapped is to transform raw GitHub activity into a visual, entertaining, and genuinely useful year-in-review — one developers actually want to share — while keeping every statistic traceable back to real data instead of an AI's best guess.
|
|
|
|
|
All heavy processing runs async, outside the lifecycle of an HTTP request — a user with tens of thousands of commits should never be limited by a serverless function timeout.
|
|
|
|
Deliberately decoupled from the GitHub API, the database, and the UI — testable with no network and no live database.
|
|
|
|
|
|
|
|
|
|
|
|
Prepared for production, not just for a demo.
|
|
|
GitHub (REST + GraphQL) → Data Collector → Job Queue (Inngest) → Database (PostgreSQL) → Analytics Engine → Insights Engine → Dashboard / Wrapped / SharingGitHub Wrapped is a hosted web app — there's nothing to install to use it.
- Go to the live app (link at the top of this README).
- Click "Connect with GitHub" and authorize the OAuth App.
- Wait for the first sync to finish (progress is shown on
/dashboard). - Open
/wrappedto see your recap, or share your public page once it's generated.
Private repositories are never analyzed unless you explicitly opt in from /settings.
Running your own instance requires a GitHub OAuth App, a PostgreSQL database, and an Inngest account. Full step-by-step setup (creating each of these, exact env vars, and deploying to Vercel) is in DOCS.
git clone https://github.com/emilymontec/github-wrapped.git; cd github-wrapped
npm installDATABASE_URL=POSTGRES_POOLED_URL
AUTH_SECRET=AUTH_SECRET
AUTH_URL=http://localhost:3000
GITHUB_CLIENT_ID=GITHUB_OAUTH_CLIENT_ID
GITHUB_CLIENT_SECRET=GITHUB_OAUTH_CLIENT_SECRET
TOKEN_ENCRYPTION_KEY=TOKEN_ENCRYPTION_KEY
INNGEST_EVENT_KEY=INNGEST_EVENT_KEY
INNGEST_SIGNING_KEY=INNGEST_SIGNING_KEY
GITHUB_WEBHOOK_SECRET=GITHUB_WEBHOOK_SECRET
WEBHOOK_BASE_URL=http://localhost:3000
HUGGINGFACE_API_KEY=HUGGINGFACE_API_KEY
HUGGINGFACE_MODEL=HUGGINGFACE_MODEL
MJ_APIKEY_PUBLIC=MJ_APIKEY_PUBLIC
MJ_APIKEY_PRIVATE=MJ_APIKEY_PRIVATE
MAILJET_FROM_EMAIL=MAILJET_FROM_EMAIL create the .env file and configure the environment variables — see .env.example for details on each one
npx prisma generate
npx prisma migrate devnpm run devApplication available at: http://localhost:3000
github-wrapped/
│
├── app/
│ ├── [username]/wrapped/[year]/
│ ├── account/
│ ├── analytics/
│ ├── api/
│ │ ├── auth/[...nextauth]/
│ │ ├── inngest/
│ │ └── webhooks/github/
│ ├── badges/
│ ├── comparisons/
│ ├── compare/
│ ├── dashboard/
│ ├── insights/
│ ├── score/
│ ├── settings/
│ ├── sync/
│ └── wrapped/
│
├── components/
│ ├── comparisons/
│ ├── dashboard/
│ ├── settings/
│ └── wrapped/
│
├── lib/
│ ├── analytics/
│ ├── auth/
│ ├── gamification/
│ ├── github/
│ ├── insights/
│ ├── jobs/
│ ├── notifications/
│ ├── ratelimit/
│ └── webhooks/
│
├── prisma/
│ ├── schema.prisma
│ └── migrations/
│
├── e2e/
├── public/
├── package.json
├── tsconfig.json
├── next.config.mjs
├── vercel.json
├── .env.example
└── README.mdCreate branch
git checkout -b feature/my-featureCommit changes
git commit -m "Add new feature"Push changes
git push origin feature/my-featureOpen a Pull Request describing the proposed changes.
Emily Monterrosa Castro - Full Stack Developer
GitHub · LinkedIn · Portfolio
AGPL-3.0.
See the LICENSE file for additional information.
If you want to know more about the system, please check the Documentation.