Skip to content

AdShield is an efficient chrome extension to blocks intrusive ads and popups for a cleaner, faster, and distraction free browsing and downloading experience (especially for anime nerds like me 😝)

Notifications You must be signed in to change notification settings

Segundavid-Dev/AdShield

Repository files navigation

AdShield

Lightweight ad blocker that blocks intrusive ads, popups and malicious redirects for a smoother browsing experience

Transform your web browsing into a clean, safe, and distraction free experience

Latest Updates:

  • Ad Detection:
  • Malicious Redirect Protection:
  • Lightweight Performance:

Why Did I Build This ?

Web browsing(Downloading animes) has become increasingly frustrating with intrusive ads, popups, and redirect attacks that compromise both user experience and security. After experiencing countless interruptions while browsing and seeing how existing solutions were either too heavy or missed critical threats, I decided to build a lightweight yet powerful solution.

AdShield was born from the need for a browser extension that i can build myself from scratch to:

  • Blocks ads without slowing down your browser
  • Protects against malicious redirects and pop-ups
  • Maintains legitimate website functionality
  • Provides users with control and transparency

The goal was simple: create a safe browsing environment while learning and leveraging the browser APIs and build a real life extension scenerio.

Built With

  • WXT Framework - Modern web extension framework
  • React - User interface components
  • TypeScript - Type safe development
  • Tailwind CSS - Styling framework
  • Lucide React - Icon library

User Experience

  • Lightweight Design: Fast loading with minimal resource usage
  • Real time Statistics: See how many ads and trackers you've blocked
  • One click Toggle: Easily enable/disable protection
  • Clean Interface: Simple, intuitive user interface

Screens

  • Inactive blocker Inactive

  • Activate blocker Active

What Gets Blocked

  • Display Ads
  • Popup Ads:
  • Redirect Attacks
  • Tracking Scripts
  • Malicious Iframes

Development

Want to contribute or run Ad-Shield locally?

# Clone the repository
git clone https://github.com/Segundavid-Dev/AdShield

# Navigate to project directory
cd AdShield

# Install dependencies
pnpm install

# Start development server
pnpm run dev

Project Structure

.
β”œβ”€β”€ README.md
β”œβ”€β”€ active-page.PNG
β”œβ”€β”€ assets
β”œβ”€β”€ components
β”œβ”€β”€ components.json
β”œβ”€β”€ context
β”‚Β Β  β”œβ”€β”€ SwitchContext.tsx
β”‚Β Β  └── SwitchProvider.tsx
β”œβ”€β”€ core-components.md
β”œβ”€β”€ entrypoints
β”‚Β Β  β”œβ”€β”€ background.ts
β”‚Β Β  β”œβ”€β”€ content.ts
β”‚Β Β  └── popup
β”œβ”€β”€ hooks
β”‚Β Β  └── useSwitch.ts
β”œβ”€β”€ inactive-page.PNG
β”œβ”€β”€ lib
β”‚Β Β  └── utils.ts
β”œβ”€β”€ node_modules
β”œβ”€β”€ package.json
β”œβ”€β”€ pnpm-lock.yaml
β”œβ”€β”€ public
β”‚Β Β  β”œβ”€β”€ icon
β”‚Β Β  └── wxt.svg
β”œβ”€β”€ tsconfig.json
β”œβ”€β”€ types.ts
└── wxt.config.ts

Contributing

Contributions are welcome! Here's how you can help:

  1. Report Issues: Found a bug or have a feature request? Open an issue
  2. Submit PRs: Fork the repo, create a branch, and submit a pull request
  3. Test & Feedback: Try the extension and share your experience

Thanks for reading! :)

About

AdShield is an efficient chrome extension to blocks intrusive ads and popups for a cleaner, faster, and distraction free browsing and downloading experience (especially for anime nerds like me 😝)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published