BGG Price Checker

Find the best deal on board games instantly!

This extension lets you compare real-time prices from multiple retailers while you browse BoardGameGeek, helping you save money on your next board game purchase.

✨ Features

• 🎯 Automatic Detection - Instantly recognises when you're viewing a board game on BoardGameGeek
• 💰 Real-time Pricing - Shows current prices from multiple retailers
• 📦 Shipping Included - Displays total price including shipping costs
• ✅ Stock Status - Shows real-time availability
• 🌍 Smart Localisation - Auto-detects your region for appropriate currency and shipping destination
• ⚡ Performance Optimised - Caches results for 1 hour to reduce API calls
• 💱 Multi-Currency Support - USD, GBP, EUR, DKK, SEK

🚀 Installation

Chromium Browsers (Chrome, Edge, Brave, Opera, Vivaldi)

Install the extension directly from the Chrome Web Store. Works with all Chromium-based browsers.

Manual Installation (Developer Mode)

1. Clone this repository or download the source code
2. Open Chrome and navigate to chrome://extensions/
3. Enable "Developer mode" using the toggle in the top right
4. Click "Load unpacked"
5. Select the bgg-pricing-extension directory
6. The extension icon will appear in your toolbar

Firefox

Install the extension directly from Firefox Add-ons.

Manual Installation

1. Rename manifest-firefox.json to manifest.json
2. Open Firefox and navigate to about:debugging
3. Click "This Firefox"
4. Click "Load Temporary Add-on"
5. Select the manifest.json file from the extension directory

📖 Usage

1. Navigate to any BoardGameGeek game page (e.g., https://boardgamegeek.com/boardgame/13/catan)
2. Click the extension icon in your toolbar
3. View pricing information from various retailers
4. Click on any price to visit the retailer's page
5. Use the dropdown menus to change currency and shipping destination

👨‍💻 Development

To modify the extension:

1. Make your changes to the source files
2. Go to chrome://extensions/
3. Click the refresh icon on the extension card
4. Test your changes

Building for Distribution

The build process creates platform-specific packages:

make chrome   # Creates Chrome package in dist/
make firefox  # Creates Firefox package in dist/
make all      # Builds both Chrome and Firefox packages
make clean    # Removes dist directory
make help     # Shows all available commands

Build Output

• Chrome: dist/bgg-price-checker-chrome-v{version}.zip
• Firefox: dist/bgg-price-checker-firefox-v{version}.zip

The Firefox build automatically uses manifest-firefox.json and renames it to manifest.json inside the package.

Browser API Compatibility

The extension uses a unified API approach to support both Chrome and Firefox:

const api = typeof browser !== "undefined" ? browser : chrome;

This ensures all storage, tabs, and runtime APIs work correctly across browsers.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

⚖️ Disclaimer

This extension is an independent project and is not affiliated with, endorsed by, or connected to BoardGameGeek (BGG). All trademarks and service marks belong to their respective owners.