https://github.com/pantane1/kataad
Kata Ad is a lightweight browser extension designed to enhance your browsing experience by blocking intrusive ads across websites. Developed with user experience in mind, it ensures faster page loads and a cleaner interface while browsing.
https://github.com/pantane1/kataad
adblocker chrome-extension powerful
Last synced: 6 months ago
JSON representation
Kata Ad is a lightweight browser extension designed to enhance your browsing experience by blocking intrusive ads across websites. Developed with user experience in mind, it ensures faster page loads and a cleaner interface while browsing.
- Host: GitHub
- URL: https://github.com/pantane1/kataad
- Owner: Pantane1
- Created: 2025-12-15T09:14:57.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-16T11:15:52.000Z (7 months ago)
- Last Synced: 2026-01-13T19:42:45.442Z (6 months ago)
- Topics: adblocker, chrome-extension, powerful
- Language: TypeScript
- Homepage: https://kataad.netlify.app/
- Size: 688 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# KataAd – Lightweight Ad Blocker Extension
**KataAd** is a fast, privacy‑first ad blocker built as a Chrome (Manifest V3) extension. It blocks intrusive ads, trackers, and pop‑ups using Chrome’s native `declarativeNetRequest` engine for maximum performance and minimum resource usage.
**Tagline:** Block noise. Keep control.
---
## ✨ Key Features
* 🚫 Blocks common ads (Google Ads, Facebook Ads, DoubleClick, Taboola, Outbrain)
* 🕵️ Blocks trackers, pixels, and tracking scripts
* 🧠 Uses Chrome’s native MV3 `declarativeNetRequest` (no background interception)
* ⚡ Lightweight and fast (no remote filter lists)
* 🌙 Clean dark‑mode popup UI
* 🔁 Enable / Disable blocking with one click
* 📌 Persistent state using Chrome storage
* 📬 Built‑in **Get in Touch** page for developer contact
---
## 🧩 Extension Structure
```
kataad/
├── manifest.json
├── rules.json
├── background.js
├── popup.html
├── popup.js
├── contact.html
├── contact.js
├── icons/
│ ├── icon16.png
│ ├── icon48.png
│ ├── icon128.png
│ └── contact.png
```
---
## 🖥 Popup Interface
The popup provides a simple control panel:
* Extension name and status
* Toggle button to enable or disable ad blocking
* Footer navigation with **Get in Touch** button
Clicking **Get in Touch** opens an internal extension page with developer contact details.
---
## 📬 Get in Touch Page
The contact page is an internal, review‑safe extension page designed for transparency and support.
**Includes:**
* Developer name
* Email contact
* GitHub profile
* WhatsApp link
No tracking, no forms, no analytics.
---
## 🔒 Privacy & Security
KataAd is built with privacy as a first‑class principle:
* ❌ No user tracking
* ❌ No analytics
* ❌ No remote code execution
* ❌ No external filter subscriptions
* ✅ All logic runs locally in the browser
---
## 🛠 Installation (Developer Mode)
1. Clone or download this repository
2. Open Chrome and navigate to:
```
chrome://extensions
```
3. Enable **Developer mode** (top‑right)
4. Click **Load unpacked**
5. Select the `kataad/` folder
6. KataAd will appear in your extensions list
---
## 🧪 Testing
To verify ad blocking:
* Visit a site known for ads
* Open DevTools → Network tab
* Observe blocked requests
* Toggle KataAd off and reload to compare
---
## 📦 Packaging for Chrome Web Store
1. Ensure all icons are present (16, 48, 128)
2. Validate `manifest.json` for MV3 compliance
3. Zip the contents of the `kataad/` folder
4. Upload via Chrome Web Store Developer Dashboard
---
## 🧭 Roadmap
Planned and optional upgrades:
* Per‑site allowlist
* Report broken site workflow
* Expanded ruleset (EasyList‑style)
* Firefox version (Manifest v2 compatible)
* Usage statistics (local‑only)
---
## 👤 Author
**Pantane**
[](mailto:pantane254@gmail.com)
[](https://wa.me/254740312402)
---
## 📄 License
MIT License. Free to use, modify, and distribute.
---
Built with focus, simplicity, and control.
**_All Hail to Pantane_**