🎉 PR Celebration (with Odoo Support)

A personal project by Akash Parmar

🚀 Overview

Tired of refreshing GitHub waiting for your PR to be merged?

This extension monitors your GitHub notifications and celebrates with you when your PR is merged! A fun dancing stick figure pops up to share your joy! 🕺

Originally built for Odoo developers, but works great for any GitHub workflow!

How it works:

📡 Monitors your GitHub notifications in the background
🔍 Detects when your PR is merged or approved
🎊 Shows a dancing stick figure to celebrate!
😢 Shows a sad stick figure if there's activity but no merge yet

No more manual checking - just code and let the celebration come to you!

✨ Features

Feature	Description
🎉 Dancing Celebration	Stick figure dances when your PR is merged
😢 Sad Animation	Shows empathy when PR has activity but isn't merged
🔔 Auto Polling	Checks GitHub notifications automatically
📊 Status Bar	Quick access from VS Code status bar
🟣 Odoo Support	Built-in support for Odoo's merge process (`r+`, `delegate+`)

📋 Setup

Step 1: Generate a GitHub Personal Access Token

Go to GitHub Token Settings
Click "Generate new token (classic)"
Name it (e.g., "PR Celebration Extension")
Select scope:
- ✅ notifications - only this is required!
Click "Generate token" and copy it

🔒 Privacy & Security:

We only need notifications permission - nothing else!

We do NOT store any data - your token stays in VS Code settings

We recommend NOT granting any extra permissions beyond notifications

Your token is used only to read GitHub notifications locally

Step 2: Add Token to VS Code

Option A: Settings UI (Recommended)

1. Press Ctrl+, (or Cmd+, on Mac)
2. Search: "PR Celebration"
3. Paste your token in "Github Token"

Option B: settings.json

{
  "prCelebration.githubToken": "ghp_your_token_here"
}

⚙️ Configuration

Setting	Description	Default
`prCelebration.githubToken`	Your GitHub Personal Access Token	required
`prCelebration.notificationCheckIntervalSeconds`	Polling interval (seconds)	`60`

🎮 Usage

Action	How
Auto Check	Extension polls automatically in background
Manual Check	Click the PR icon in status bar
Test Animation	Run "Test Celebration Animation" from Command Palette

🎊 Celebration Triggers

The extension celebrates when it detects:

Trigger	Description
PR Merged	When your PR is merged ✅
Odoo Approvals	Comments with `r+` or `delegate+` (Odoo workflow)

Works with any GitHub repository! Special support for Odoo's merge process.

👥 Who is this for?

✅ Odoo developers contributing to odoo/odoo, odoo/enterprise, or community repos ✅ Any developer working with GitHub PRs ✅ Open source contributors wanting a fun PR experience ✅ Anyone who wants to celebrate their merged PRs! 🎉

👤 Author

Akash Parmar - @akash1520

A personal/hobby project to make PR workflows more fun! 🎈

📄 License

Made with ❤️ for developers everywhere