DevWrapped 2025 🎁

A "Github Wrapped" style year-in-review for developers. Analyze your GitHub activity, visualize your coding habits, and get roasted by AI.

⚡ Features

• Deep Stats: Analyzes commits, languages, and star history.
• AI Powered: Uses Google Gemini to generate a personalized summary (and roast) of your coding style.
• Fast Caching: Built on Neon Postgres with unlogged tables for high-performance caching.
• Beautiful UI: Built with Tailwind CSS, Framer Motion, and shadcn/ui.
• Shareable: Generates a downloadable high-res card for social media.

Tech Stack

• Framework: Next.js 15 (App Router)
• Language: TypeScript
• Database: Neon (Serverless Postgres)
• AI Model: Google Gemini
• Styling: Tailwind CSS + Lucide React
• Deployment: Vercel

Getting Started

1. Clone the repo

git clone https://github.com/eddy1759/devwrapped.git

cd devwrapped

2. Install dependencies

pnpm install

3. Environment Setup

Create a .env file in the root directory:

# GitHub OAuth (Create at GitHub Developer Settings)
GITHUB_CLIENT_ID=your_client_id
GITHUB_CLIENT_SECRET=your_client_secret

DATABASE_URL='postgres://user:pass@ep-pooler.region.aws.neon.tech/neondatabase?sslmode=require'

GEMINI_API_KEY=your_gemini_key

# Auth
NEXTAUTH_URL=http://localhost:3000

4. Database Setup

Run this SQL in your Neon SQL Editor to create the cache table:

CREATE UNLOGGED TABLE IF NOT EXISTS dev_wrapped_cache (
    username TEXT PRIMARY KEY,
    data JSONB NOT NULL,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    expires_at TIMESTAMP WITH TIME ZONE NOT NULL
);

5. Run Locally

pnpm run dev

Deployment

1. Push code to GitHub.
2. Import project into Vercel.
3. Add the Environment Variables from step 3.
4. Deploy!
5. Important: Update your GitHub OAuth Application "Callback URL" to match your production domain: https://your-app.vercel.app/api/auth/callback/github.

📄 License

MIT License. Built for the developer community.