🚀 Chrome Extension Boilerplate (Manifest V3 + Vite + React)

Build modern Chrome Extensions fast.

This boilerplate sets up everything you need — no configuration headaches, no outdated setups. Focus on building your extension, not wrestling with the environment.

✨ Features

• Manifest V3 Ready — Built on the latest Chrome extension architecture.
• Vite + React Integration — Lightning-fast development with Hot Module Replacement (HMR) for the popup.
• Core Components Included:
  • Background Service Worker (src/background/service-worker.js)
  • Content Script (src/content/content-script.js)
  • React Popup (src/popup/)
  • Options Page (src/options/) (easy to upgrade to React)
• Chrome APIs Examples — Clean examples of chrome.storage and message passing.
• Flexible Structure — Organized to scale from simple tools to complex projects.
• Production Optimized — Build scripts included (npm run build) for final deployment.

🔧 Quick Setup

1. Clone & Install

   npm install
   

2. Development Mode with HMR

   npm run dev
   

3. Load into Chrome
   • Go to chrome://extensions
   • Enable Developer Mode
   • Load Unpacked → Select the dist folder.

Start building. React changes reload instantly. Background and content scripts just need a quick extension reload.

📦 What's Inside?

• Pre-configured manifest.json
• React-based Popup with Vite HMR
• Background service worker template
• Content script injection setup
• Options page (HTML/JS by default)
• Debugging & deployment instructions
• Fully documented (help.html included)

🚀 Why Use This Boilerplate?

• Save hours setting up complex configs.
• Start with best practices already in place.
• Easily extend for Chrome, Edge, Brave, or any Chromium-based browser.

🧩 Tech Stack

• Chrome Extensions (Manifest V3)
• React
• Vite
• JavaScript (ES6+)

📜 License

MIT — You're free to use and modify it for your projects.

📥 Download it. Build faster. Ship extensions that work.