✨ Features

• 🎨 8 beautiful SVG cards — stats, rating graph, heatmap, difficulty, contests, badges, streak, dashboard
• 🎭 9 built-in themes — GitHub Dark/Light, Dracula, Nord, Catppuccin, Tokyo Night, Gruvbox, One Dark
• 🎯 Pure SVG — no screenshots, no browser automation, no raster images
• ⚡ Fast — parallel API calls, <8 second cold start
• 🤖 GitHub Action ready — automatic daily updates with one YAML file
• 🔧 Highly customizable — custom themes via JSON, toggle any card on/off
• 🆓 Free & open source — MIT license, self-hostable, zero dependencies beyond Python
• 📦 Zero backend — CLI tool, no server required

🚀 Quick Start

Install

pip install leetcode-profile-generator

Generate

leetcode-profile --username YourUsername --theme github_dark --output ./assets

Embed in README

![LeetCode Stats](./assets/leetcode_stats.svg)
![Rating History](./assets/rating_history.svg)
![Heatmap](./assets/heatmap.svg)

📊 Cards

Stats Card (leetcode_stats.svg)

The primary profile overview — avatar, rating, rank, acceptance rate, and difficulty progress bars.

Rating History (rating_history.svg)

Smooth Bézier curve showing contest rating progression with peak and latest highlights.

Difficulty Distribution (difficulty.svg)

Horizontal bars showing easy/medium/hard solving progress with beats percentages.

Submission Heatmap (heatmap.svg)

GitHub-style contribution heatmap showing daily submission activity over the past year.

Contest History (contest_history.svg)

Table of recent 10 contests with ratings, ranks, and color-coded delta changes.

Badges (badges.svg)

Grid of earned LeetCode badges with upcoming badge progress.

Streak (streak.svg)

Current and longest streaks with monthly activity bar chart.

Dashboard (dashboard.svg)

All-in-one combined master card assembling Stats, Difficulty breakdown, Contest rating history, Activity streak, and 52-week Submission heatmap.

🎨 Themes

Custom Themes

Create a JSON file with your color palette:

{
  "name": "my_theme",
  "bg_color": "#1a1a2e",
  "title_color": "#e94560",
  "text_color": "#eaeaea",
  "easy_color": "#4ecca3",
  "medium_color": "#ffd369",
  "hard_color": "#e94560"
}

leetcode-profile --username YourUser --theme path/to/my_theme.json

See themes/custom_example.json for all available fields.

🤖 GitHub Action (Zero Setup Workflow)

Simply create .github/workflows/leetcode.yml in your profile repository:

name: LeetCode Stats

on:
  schedule:
    - cron: '0 0 * * *'  # Daily at midnight
  workflow_dispatch:

jobs:
  leetcode:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4

      - uses: gufran21/LeetCodeProfileGenerator@v1
        with:
          username: 'cpcs'  # 👈 Replace with your LeetCode username
          theme: 'github_dark'
          generate_dashboard: 'true'  # 👈 Enable cards you want generated
          generate_stats: 'true'
          generate_streak: 'true'

Embed in your GitHub Profile README.md:

![LeetCode Dashboard](./assets/dashboard.svg)
![LeetCode Stats](./assets/leetcode_stats.svg)
![Streak Card](./assets/streak.svg)

Action Inputs

💻 CLI

Usage: leetcode-profile [OPTIONS]

Options:
  -u, --username TEXT        LeetCode username (required)
  -t, --theme TEXT           Theme name or path to custom JSON
  -o, --output TEXT          Output directory
  --stats / --no-stats       Generate stats card
  --rating / --no-rating     Generate rating history
  --difficulty / --no-difficulty
  --heatmap / --no-heatmap
  --streak / --no-streak
  --contest-history / --no-contest-history
  --badges / --no-badges
  --dashboard / --no-dashboard
  --no-cache                 Skip filesystem cache
  --cache-ttl INTEGER        Cache TTL in seconds (default: 86400)
  --no-avatar                Skip avatar fetch
  -v, --verbose              Debug logging
  --list-themes              List available themes
  --version                  Show version
  --help                     Show help

Examples

# Generate all cards with Dracula theme
leetcode-profile -u <username> -t dracula -o ./assets

# Only stats and rating cards
leetcode-profile -u <username> --no-heatmap --no-streak --no-badges --no-contest-history

# Force fresh data (skip cache)
leetcode-profile -u <username> --no-cache

# List all available themes
leetcode-profile --list-themes

🏗️ Architecture

CLI / GitHub Action
      │
  GraphQL Client (httpx async)
      │
  ┌───┼───┐
  ▼   ▼   ▼
APIs (parallel fetch)
      │
  Data Models (dataclasses)
      │
  Data Service (orchestrator)
      │
  Card Generators (8 cards)
      │
  SVG Renderer + Theme Engine
      │
  Generated SVG Assets

🧪 Testing

pytest tests/ -v

The test suite includes:

• Model validation tests
• GraphQL client tests (mocked HTTP)
• Data service parsing tests
• Theme engine tests (all 9 themes)
• Card generator tests (XML validation, size limits)
• 8 cards × 9 themes = 72 parametrized card tests
• Streak calculator tests
• Cache tests (TTL, corruption recovery)
• CLI tests

📜 License

MIT — see LICENSE

🤝 Contributing

See CONTRIBUTING.md for development setup, how to add themes/cards, and PR guidelines.