FlagVisitors

About

# FlagVisitors - Website Analytics & Country Detection

**Instantly see website traffic and visitor location with a simple flag icon in your toolbar.**

## What FlagVisitors Does

FlagVisitors transforms your browsing experience by showing you key website information at a glance. See the country flag of your current location and estimated daily website traffic right in your Chrome toolbar.

## Key Features

**🚩 Dynamic Country Flags**
- Displays your country flag directly in the toolbar icon
- Automatically detects your location via IP geolocation
- Clean, transparent flag icons that blend with Chrome's design

**📊 Website Traffic Insights**
- Colored badges indicate website size (N=New, S=Small, M=Medium, L=Large, XL=Extra Large)
- Realistic traffic estimates for any website you visit
- Professional t-shirt sizing system for instant recognition

**💡 Smart Tooltips**
- Hover to see detailed information
- Shows country, website category, and daily visitor estimates
- Clean, multi-line display without clutter

**🎯 Non-Intrusive Design**
- No floating widgets or page overlays
- Works entirely from your Chrome toolbar
- Respects your browsing experience

## How It Works

1. **Install FlagVisitors** - No setup required
2. **Browse any website** - Flag and traffic info appear automatically
3. **Hover for details** - See country and visitor statistics
4. **Click for more** - Access detailed analytics (coming soon)

## Traffic Categories

- **N (New)**: Under 200 daily visitors - Orange badge
- **S (Small)**: 200-500 daily visitors - Dark orange badge
- **M (Medium)**: 5K-25K daily visitors - Green badge
- **L (Large)**: 100K-500K daily visitors - Forest green badge
- **XL (Extra Large)**: 10M+ daily visitors - Dark green badge

## Privacy & Performance

- Lightweight and fast - no impact on browsing speed
- Uses public geolocation APIs for country detection
- Traffic estimates based on domain analysis and ranking data
- Your browsing history stays private - only current page analysis

## Perfect For

- **Web developers** wanting to understand website scale
- **Digital marketers** researching competitor traffic
- **Students and researchers** studying web analytics
- **Curious users** who want to know more about websites they visit

## Coming Soon (v2.0)

- Detailed analytics dashboard
- Historical traffic data
- Export capabilities
- Custom settings panel
- Premium features for power users

## 📥 Installation

### From Chrome Web Store (Recommended)
*Coming Soon - Chrome Web Store link*

### Manual Installation
1. Download the extension files
2. Open Chrome → Extensions → Developer Mode
3. Click "Load unpacked" → Select the `extension` folder
4. Icon appears in your toolbar

## 🎮 How to Use

1. **Browse any website** - Extension automatically detects location
2. **See the flag** - Country flag appears in your toolbar
3. **Click for details** - Get traffic stats, age, and analytics
4. **Explore insights** - Discover website patterns and geography

## Privacy & Performance

- Lightweight and fast - no impact on browsing speed
- Uses public geolocation APIs for country detection
- Traffic estimates based on domain analysis and ranking data
- Your browsing history stays private - only current page analysis

## Coming Soon (v2.0)

- Detailed analytics dashboard
- Historical traffic data
- Export capabilities
- Custom settings panel
- Premium features for power users

## ❓ FAQ

**Q: Does this slow down my browsing?**
A: No - it's designed for minimal impact with smart caching.

**Q: What data do you collect?**
A: Only anonymous domain visits (optional). No personal info ever.

**Q: Does it work offline?**
A: Yes - cached data works without internet connection.

**Q: Which websites work?**
A: All websites - though some may show "Unknown" for new/private domains.

## 🐛 Issues & Support
- **Questions**: Check FAQ above or open an issue

## 📊 Technical Details

- **Chrome Manifest**: V3 (latest standard)
- **Permissions**: Active Tab, Storage, Host APIs
- **Performance**: Sub-100ms popup loading
- **Caching**: 30-day intelligent storage
- **APIs**: DNS-over-HTTPS, Tranco rankings, WHOIS

## 🔄 Version History

**v1.0.1** (Current)
- Initial release
- Country detection with flags
- Traffic estimates and rankings
- Website age detection
- Professional popup interface

---

**Start exploring the web with FlagVisitors today - see the world wide web through a geographic lens!**

*FlagVisitors respects your privacy and works entirely within Chrome's security guidelines.*