Skip to content

Repository files navigation

ShieldBlock Pro

🛡️ ShieldBlock Pro

Professional Manifest V3 Ad Blocker for Chromium Browsers

Fast • Lightweight • Privacy Focused • Open Source

Chrome Manifest JavaScript License Status

A modern privacy-first browser extension built with Manifest V3 that blocks advertisements, trackers, popup windows, cookie banners, and tracking URLs while providing a beautiful real-time statistics dashboard.


✨ Features

Feature Description
🚫 Network Ad Blocking Blocks advertising requests using Manifest V3 DeclarativeNetRequest
🎨 Cosmetic Filtering Hides banners, floating ads, cookie notices and sponsored content
🪟 Popup Blocker Prevents unwanted popup windows and redirects
🔗 URL Cleaner Removes tracking parameters like UTM, fbclid and more
📊 Live Statistics Real-time blocked request statistics
🔔 Badge Counter Live badge showing blocked requests
✅ Whitelist Permanent and temporary website exceptions
⚙️ Dashboard Beautiful analytics dashboard
🌙 Modern UI Glassmorphism-inspired dark interface
⚡ Lightweight Optimized for performance and low memory usage

📸 Screenshots


🛡️ Popup

ShieldBlock Pro Popup

Compact popup providing instant protection controls, live blocking statistics, recent activity, and quick access to the Dashboard and Settings.


📊 Statistics Dashboard

ShieldBlock Pro Dashboard

Interactive analytics dashboard with real-time request statistics, activity history, blocked domains, request type breakdown, and live monitoring.


🎨 Appearance Settings

Appearance Settings

Personalize ShieldBlock Pro with dark/light themes, multiple accent colors, and smooth UI animations.


🛡️ Filter Lists

Filter Lists

Enable or disable individual protection modules including Network Ad Blocking, Privacy Protection, Cosmetic Filtering, Popup Blocking, and URL Cleaning.


ℹ️ About

About ShieldBlock Pro

Displays extension version, active rules, total blocked requests, custom rule count, and project information.


⚡ Performance

ShieldBlock Pro is designed for speed and efficiency.

  • ✅ Manifest V3 architecture
  • ✅ Background Service Worker
  • ✅ Optimized rule engine
  • ✅ Lightweight memory usage
  • ✅ Fast startup
  • ✅ Modular architecture
  • ✅ Efficient storage management
  • ✅ Real-time statistics engine

🏗 Architecture

Browser
     │
     ▼
Manifest V3
     │
     ▼
Background Service Worker
     │
     ├── Rule Engine
     ├── Stats Engine
     ├── Badge Manager
     ├── Message Router
     ├── Whitelist Manager
     └── Storage
              │
      ┌───────┴────────┐
      ▼                ▼
 Popup UI        Dashboard UI
      │                │
      └────────┬───────┘
               ▼
        Chrome Storage API

📂 Project Structure

shieldblock-pro/
│
├── manifest.json
│
├── assets/
│   ├── logo.png
│   ├── icons/
│   └── screenshots/
│       ├── popup.png
│       ├── dashboard.png
│       ├── settings-appearance.png
│       ├── settings-filterlists.png
│       └── about.png
│
├── background/
│   ├── index.js
│   ├── RuleEngine.js
│   ├── StatsEngine.js
│   ├── BadgeManager.js
│   ├── MessageRouter.js
│   ├── WhitelistManager.js
│   └── ...
│
├── content/
│   ├── CosmeticEngine.js
│   ├── PopupBlocker.js
│   ├── AntiRedirect.js
│   ├── ResourceObserver.js
│   └── ...
│
├── popup/
├── dashboard/
├── options/
├── rules/
├── shared/
└── scripts/

🛠 Technology Stack

  • JavaScript (ES6)
  • Manifest V3
  • Chrome Extensions API
  • DeclarativeNetRequest API
  • Chrome Storage API
  • MutationObserver
  • CSS3
  • HTML5

🚀 Installation

Clone the repository

git clone https://github.com/Vikki-2006/ShieldBlock-Pro.git

Open Chrome

chrome://extensions

Enable

Developer Mode

Click

Load unpacked

Select the cloned project folder.

Done! 🎉


📋 Roadmap

  • EasyList integration
  • Custom filter subscriptions
  • Sync settings
  • Backup & Restore
  • Website-specific rules
  • Enhanced tracker protection
  • Performance optimizations
  • AI-assisted filter suggestions

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a new feature branch
git checkout -b feature/my-feature
  1. Commit your changes
git commit -m "Add awesome feature"
  1. Push to GitHub
git push origin feature/my-feature
  1. Open a Pull Request

📜 License

This project is licensed under the MIT License.

See the LICENSE file for more information.


If you found this project useful, consider giving it a ⭐ on GitHub!

About

A modern Chrome/Brave ad blocker extension built with Manifest V3.

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages