Smart data bundle manager for Ghana
# π‘οΈ BundleGuard
### Smart Data Bundle Manager for Ghana π¬π
> Built because data is expensive in Ghana. BundleGuard helps you track, control and save your mobile data bundle directly from Chrome.
## β¨ Features
- π **Bundle Tracking** β Real-time monitoring of your data consumption
- π° **Cost Estimation** β See how much each site costs in Ghana Cedis
- π **Smart Alerts** β Get notified at 50%, 80%, and 100% thresholds
- π **Telco Shortcuts** β Quick access to MTN, AirtelTigo, and Telecel USSD codes
- β‘ **Resource Blocking** β Block images, videos, and scripts to save data
- π **Usage Insights** β Daily, weekly, and monthly analytics dashboard
- π― **Budget Planning** β Set daily and monthly data budgets
- π **Site Management** β View and control data usage per website
- π‘ **Smart Tips** β Personalized recommendations to save data
- π **Auto Reset** β Daily and monthly usage counters reset automatically
## π± Supported Telcos
| Telco | Balance Check | Buy Data | Support |
|-------|---------------|----------|---------|
| MTN | *138# | mtn.com.gh | 100 |
| AirtelTigo | *134# | airtel.com.gh | 121 |
| Telecel | *100# | telecelghana.com | 100 |
## π₯οΈ Screenshots
### Dashboard
### Saver
### Rules
### Insights
> Screenshots taken on Chrome 120+ with BundleGuard v1.0.0
## π Installation
### From Chrome Web Store
Coming soon β submission in progress
### Manual Installation (Developer Mode)
1. Clone: `git clone
github.com`
2. `cd bundle-guard`
3. `npm install`
4. `npm run build`
5. Open chrome://extensions
6. Enable Developer Mode
7. Click Load unpacked and select the dist/ folder
## π οΈ Tech Stack
| Technology | Purpose |
|------------|---------|
| Chrome MV3 | Extension platform |
| React 18 | Popup UI |
| Tailwind CSS | Styling |
| Vite | Build tool |
| chrome.declarativeNetRequest | Resource blocking |
| chrome.storage.local | Data persistence |
## π Project Structure
```
bundle-guard/
βββ manifest.json # Extens β¦