HazeBot Admin Panel 📱

Modern cross-platform admin interface for HazeBot built with Flutter

Feature-rich admin panel with hybrid navigation combining user features for community members and powerful management tools for administrators. Built with Flutter for Web, Android, and Desktop.

✨ Key Features

• 🎨 Material Design 3 - Android 16 Monet dynamic colors with system theme
• 🔐 JWT Authentication - Secure token-based auth with automatic refresh
• 🎮 User Features - HazeHub, Gaming Hub, Rocket League, Meme Generator
• ⚙️ Admin Tools - Configuration, live monitoring, cog manager, log viewer
• 📱 Cross-Platform - Web (primary), Android, Linux Desktop
• 🚀 Responsive - Mobile, tablet, and desktop optimized

📥 Quick Download

Android APK: Download Latest Release

💡 Pro Tip: Use Obtainium for automatic updates!

📱 Installation Guide | 🔧 Setup Checklist

---

🚀 Quick Start

Prerequisites

• Flutter SDK 3.0+ - Install
• HazeBot Bot + API Server - Running and accessible
  • 📖 HazeBot Setup Guide - Complete bot installation instructions

Setup

git clone https://github.com/inventory69/HazeBot-Admin.git
cd HazeBot-Admin
flutter pub get

# Configure
cp .env.example .env
# Edit .env with your API URL

# Run
flutter run -d chrome    # Web
flutter run -d android   # Android
flutter run -d linux     # Linux

Configuration

Edit .env:

API_BASE_URL=https://your-api-url.com/api
IMAGE_PROXY_URL=https://your-api-url.com/api/proxy/image
GITHUB_REPO_URL=https://github.com/inventory69/HazeBot-Admin

API URL Examples:

• Local Web: http://localhost:5070/api
• Android Emulator: http://10.0.2.2:5070/api
• Android Device: http://YOUR_LOCAL_IP:5070/api
• Production: https://your-domain.com/api

📖 Detailed Setup Guide

---

📦 Features

🎮 User Features (All Users)

• HazeHub - Community feed with memes & rank-ups
• Gaming Hub - See who's online, send game requests
• Rocket League - Manage accounts, stats, post to Discord
• Meme Generator - Create memes with 100+ templates
• Profile - Avatar, role, RL rank, activity stats

⚙️ Admin Features (Admin Only)

• Configuration - Bot settings (channels, roles, memes, RL)
• Cog Manager - Load/unload/reload bot cogs
• Tickets - Real-time chat with WebSocket, claim/assign/close actions
• Monitoring - Active user sessions with analytics
• Logs - Bot logs with filtering

🎨 UI/UX

• Hybrid navigation (bottom tabs + admin rail)
• Android 16 Monet dynamic theming
• Dark/Light mode with system sync
• Hero animations & smooth transitions
• Pull-to-refresh on all lists
• Real-time WebSocket updates for tickets
• Smart push notification suppression
• Message caching for instant loading

📋 Complete Features List - Full feature documentation with details

---

🏗️ Architecture

Navigation

• Bottom TabBar (Users) - HazeHub, Gaming Hub, RL, Memes
• Navigation Rail (Admins) - Config, Cogs, Tickets, Logs
• Admin Toggle - Show/hide admin features
• Profile Menu - Bottom sheet with settings

Material Design 3

• Surface Hierarchy - Proper color depth (low/high/highest)
• Elevation 0 - Flat design per Android 16
• Dynamic Colors - Monet system theme integration

State Management

• Local State - StatefulWidget for screens
• Provider - Theme and authentication
• mounted checks - Before setState() in async
• WebSocket Service - Real-time ticket updates
• Message Cache - Persistent message storage

🏗️ Detailed Architecture

---

🔨 Building

Web

flutter build web --release --pwa-strategy=none

Android

flutter build apk --split-per-abi --release

Linux

flutter build linux --release

📖 Complete Build Guide

---

📚 Documentation

📖 Documentation Index - Complete documentation overview

Quick Links:

• 📱 APK Download - Android installation
• 🔧 Setup Checklist - Quick setup verification
• 🔨 Building - Build for all platforms
• 🧪 Development - Dev workflows & patterns
• 🔥 Firebase Setup - Push notifications
• 🚀 GitHub Actions - CI/CD pipeline
• 📋 Features - Complete feature list
• 📝 Changelog - Version history

Related:

• 🤖 HazeBot Backend - Bot & API server
• 📖 HazeBot Docs - Backend documentation
• 🔌 HazeBot API - REST API reference

---

🧪 Development

Hot Reload

• r - Hot reload (preserves state)
• R - Hot restart (resets state)
• q - Quit

Code Quality

flutter analyze       # Check code
dart format .         # Format code
flutter test          # Run tests

📖 Development Guide

---

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Quick Steps:

1. Fork repository
2. Create branch (git checkout -b feature/name)
3. Follow code style (dart format .)
4. Test on multiple platforms
5. Submit Pull Request

Guidelines:

• ✅ Material Design 3 surface hierarchy
• ✅ Check mounted before setState()
• ✅ Try-catch on all API calls
• ✅ Support mobile/tablet/desktop

---

📄 License

MIT License - see LICENSE. Free to use and modify!

---

🙏 Acknowledgments

Built with 💖 for The Chillventory community

• Powered by Flutter
• Material Design 3 guidelines
• Special thanks to contributors

Questions? Open an issue on GitHub!

Made with 💖 for The Chillventory 📱✨