Add Home

Home.md

@@ -0,0 +1,96 @@
+# 🛡️ AdGuard Control Hub Wiki
+
+Welcome to the comprehensive documentation for **AdGuard Control Hub** - the ultimate Home Assistant integration for AdGuard Home!
+
+## 🚀 Quick Start
+
+New to AdGuard Control Hub? Start here:
+
+1. **[Installation Guide](Installation)** - Get up and running in minutes
+2. **[Configuration](Configuration)** - Set up your AdGuard Home connection
+3. **[Dashboard Setup](Dashboard-Examples)** - Create beautiful control panels
+4. **[Automation Examples](Automation-Examples)** - Automate your network management
+
+## 📖 Documentation Sections
+
+### 🔧 **Setup & Configuration**
+- **[Installation Guide](Installation)** - HACS and manual installation methods
+- **[Configuration](Configuration)** - Connection settings and advanced options
+- **[Troubleshooting](Troubleshooting)** - Common issues and solutions
+
+### 🎛️ **Usage & Examples**
+- **[Dashboard Examples](Dashboard-Examples)** - Lovelace cards and controls
+- **[Automation Examples](Automation-Examples)** - Real-world automation scenarios
+- **[Service Reference](Service-Reference)** - Complete service documentation
+
+### 🛠️ **Advanced Topics**
+- **[API Reference](API-Reference)** - Technical API documentation
+- **[Development Guide](Development)** - Contributing and development setup
+- **[Contributing](Contributing)** - How to contribute to the project
+
+## ✨ What Makes AdGuard Control Hub Special?
+
+### 🎯 **Complete Network Control**
+Unlike basic integrations, AdGuard Control Hub gives you granular control over every aspect of your network filtering:
+
+- **Individual Device Management** - Every AdGuard client becomes a controllable Home Assistant entity
+- **Service-Level Blocking** - Block specific services (YouTube, Netflix, Gaming) per device
+- **Automated Parenting** - Time-based restrictions that adjust automatically
+- **Emergency Access** - One-click temporary unblock for urgent situations
+
+### 🏠 **Home Assistant Integration**
+Seamlessly integrates with your smart home:
+
+- **Rich Entity Support** - Switches, sensors, binary sensors for comprehensive monitoring
+- **Dashboard Ready** - Beautiful, customizable Lovelace cards
+- **Automation Paradise** - Perfect for presence detection, scheduling, and family management
+
+### 🛡️ **Security & Privacy**
+Self-hosted solution with enterprise-grade features:
+
+- **Complete Privacy** - Host on your own Gitea server
+- **CI/CD Pipeline** - Automated testing and security scanning
+- **Professional Quality** - Code quality tools and comprehensive testing
+
+## 🎬 **Real-World Use Cases**
+
+### 👨‍👩‍👧‍👦 **Family Management**
+- **Bedtime Routines** - Automatically block entertainment apps at bedtime
+- **Homework Time** - Restrict social media during study hours
+- **Weekend Rules** - Different internet policies for weekends vs school nights
+
+### 💼 **Work Productivity**
+- **Focus Mode** - Block distracting websites during work hours
+- **Meeting Mode** - Ensure stable connection by blocking bandwidth-heavy services
+- **Break Time** - Temporary access to social media during lunch breaks
+
+### 🏠 **Smart Home Automation**
+- **Presence-Based Rules** - Different restrictions when family is away
+- **Guest Network Control** - Automatic policies for visitor devices
+- **Device-Specific Rules** - Different policies for different types of devices
+
+## 📊 **Features Overview**
+
+| Feature | Description |
+|---------|-------------|
+| **Auto-Discovery** | Automatically finds and creates entities for all AdGuard clients |
+| **Service Blocking** | Block specific services (YouTube, Netflix, Gaming) per client |
+| **Time Scheduling** | Different rules for different times of day/week |
+| **Emergency Override** | Temporary unblock for urgent internet access |
+| **Bulk Operations** | Update multiple devices simultaneously |
+| **Real-time Stats** | Monitor DNS queries and blocking effectiveness |
+| **Dashboard Integration** | Beautiful Lovelace cards for easy control |
+
+## 🤝 **Getting Help**
+
+- **[Troubleshooting Guide](Troubleshooting)** - Solutions to common problems
+- **[GitHub Issues](https://your-gitea-domain.com/your-username/adguard-control-hub/issues)** - Report bugs or request features
+- **[Discussions](https://your-gitea-domain.com/your-username/adguard-control-hub/discussions)** - Community support and ideas
+
+## 📝 **Latest Updates**
+
+Check the **[Changelog](Changelog)** for the latest features and improvements.
+
+---
+
+**Ready to transform your network management? Let's get started with the [Installation Guide](Installation)!** 🚀