{"id":26851714,"url":"https://github.com/Bgr8Dev/Bgr8","last_synced_at":"2025-12-30T20:03:58.975Z","repository":{"id":283702679,"uuid":"928917345","full_name":"Hum2a/B8","owner":"Hum2a","description":"B8 is a comprehensive web platform that integrates multiple business units including B8 League, B8 World, B8 Marketing, B8 Clothing, B8 Car Club, and more. Built with React, TypeScript, and Firebase, it offers a modern, responsive user experience with secure authentication, real-time data, and integrated payment processing.","archived":false,"fork":false,"pushed_at":"2025-03-21T16:34:42.000Z","size":1314,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-21T17:35:02.087Z","etag":null,"topics":["chartjs","css","firebase","firebase-analytics","firebase-auth","firestore-database","google-pay","paypal","react","react-globe","react-toastify","stripe","threejs","typescript","vite"],"latest_commit_sha":null,"homepage":"https://b8network.co.uk","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hum2a.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-07T13:28:12.000Z","updated_at":"2025-03-21T16:34:46.000Z","dependencies_parsed_at":"2025-03-21T17:47:56.130Z","dependency_job_id":null,"html_url":"https://github.com/Hum2a/B8","commit_stats":null,"previous_names":["hum2a/b8"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FB8","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FB8/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FB8/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hum2a%2FB8/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hum2a","download_url":"https://codeload.github.com/Hum2a/B8/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246390877,"owners_count":20769476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chartjs","css","firebase","firebase-analytics","firebase-auth","firestore-database","google-pay","paypal","react","react-globe","react-toastify","stripe","threejs","typescript","vite"],"created_at":"2025-03-30T22:33:16.549Z","updated_at":"2025-12-30T20:03:58.968Z","avatar_url":"https://github.com/Hum2a.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"src/assets/Bgr8_logo.png\" alt=\"BGr8 Logo\" width=\"300\" height=\"auto\"\u003e\n\n# 🌟 bgr8 Platform\n\n\u003e **Empowering individuals through community and mentorship**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n[![Version](https://img.shields.io/badge/version-0.2.0-brightgreen.svg?style=for-the-badge)](CHANGELOG.md)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-007ACC?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![React](https://img.shields.io/badge/React-18.2-61DAFB?style=for-the-badge\u0026logo=react\u0026logoColor=black)](https://reactjs.org/)\n[![Vite](https://img.shields.io/badge/Vite-6.1-646CFF?style=for-the-badge\u0026logo=vite\u0026logoColor=white)](https://vitejs.dev/)\n[![Firebase](https://img.shields.io/badge/Firebase-11.3-FF6B35?style=for-the-badge\u0026logo=firebase\u0026logoColor=white)](https://firebase.google.com)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge)](CONTRIBUTING.md)\n\n---\n\n**A focused mentoring and community platform, centered around the BGr8 initiative and powered by a unique MentorAlgorithm with advanced availability management and intelligent search capabilities.**\n\n[🚀 Quick Start](#-quick-start) • [🌟 Ambassador Program](#-ambassador-program) • [📖 Documentation](#-documentation) • [🤝 Contributing](#-contributing) • [📄 License](#-license)\n\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents\n\n\u003cdetails open\u003e\n\u003csummary\u003e\u003cstrong\u003e📖 Quick Navigation\u003c/strong\u003e\u003c/summary\u003e\n\n- [🎯 Overview](#-overview)\n- [✨ Features](#-features)\n- [🌟 Ambassador Program](#-ambassador-program)\n- [🛠️ Tech Stack](#️-tech-stack)\n- [📖 Documentation](#-documentation)\n- [⚡ Quick Start](#-quick-start)\n- [📋 Prerequisites](#-prerequisites)\n- [🚀 Installation](#-installation)\n- [🌐 Deployment](#-deployment)\n- [🔧 Environment Variables](#-environment-variables)\n- [📁 Project Structure](#-project-structure)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n- [🔒 Security](#-security)\n- [📞 Contact](#-contact)\n- [🙏 Acknowledgments](#-acknowledgments)\n\n\u003c/details\u003e\n\n---\n\n## 🎯 Overview\n\n\u003cdiv align=\"center\"\u003e\n\n| 🏢 **Platform Unit** | 📝 **Description** | 🚀 **Status** |\n|:--------------------:|:------------------:|:-------------:|\n| 🌟 **BGr8** | Community, events, and mentoring | ✅ **Live** |\n\n\u003c/div\u003e\n\n**bgr8 Platform** is dedicated to empowering individuals through the BGr8 community and a robust mentoring program. Our platform focuses exclusively on creating meaningful connections and fostering growth through:\n\n- 🤝 **Community Building** - Connect with like-minded individuals\n- 🎓 **Mentorship Programs** - Advanced algorithm-based matching with real-time availability\n- 🌟 **Ambassador Program** - Join our network of passionate advocates making a difference\n- 📈 **Personal Growth** - Structured learning and development\n- 🌍 **Diverse Network** - Inclusive and supportive environment\n- 🔍 **Smart Discovery** - Intelligent search and filtering system\n- 📅 **Flexible Scheduling** - Integrated availability management for mentors\n\n---\n\n## ✨ Features\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🌟 Click to explore our amazing features!\u003c/strong\u003e\u003c/summary\u003e\n\n### 🎯 Core Features\n\n| Feature | Description | Status |\n|---------|-------------|:------:|\n| 🌟 **BGr8 Community Hub** | Centralized community platform | ✅ Live |\n| 🤝 **Mentor Matching** | Advanced MentorAlgorithm system with real-time availability | ✅ Live |\n| 🌟 **Ambassador Program** | Join our network of passionate advocates | ✅ Live |\n| 📝 **Ambassador Applications** | Streamlined application process with admin management | ✅ Live |\n| 🔍 **Smart Search System** | Intelligent search with dropdown suggestions and filtering | ✅ Live |\n| 📅 **Cal.com Booking System** | Third-party calendar integration | ✅ Live |\n| 📅 **Availability Management** | Direct mentor availability creation and management | ✅ Live |\n| 🔒 **Secure Authentication** | Firebase-powered security | ✅ Live |\n| 📱 **Responsive Design** | Mobile-first approach | ✅ Live |\n| 📊 **Admin Dashboard** | User and data management panel | ✅ Live |\n\n### ⚡ Technical Features\n\n| Technology | Purpose | Status |\n|------------|---------|:------:|\n| 🔑 **Firebase Auth** | User authentication | ✅ Live |\n| 🔥 **Firestore DB** | Real-time database | ✅ Live |\n| 📅 **Cal.com Integration** | Advanced booking system | ✅ Live |\n| ⚡ **Real-time Updates** | Live data synchronization | ✅ Live |\n| 🧑‍💻 **React + TypeScript** | Modern frontend stack | ✅ Live |\n| 🎨 **CSS Variables** | Consistent design system | ✅ Live |\n\n### 🆕 Recent Enhancements\n\n| Feature | Description | Status |\n|---------|-------------|:------:|\n| 🔍 **Enhanced Search** | Dropdown suggestions, smart filtering, and improved UI | ✅ Live |\n| 📊 **Filter Tabs** | Relevant mentorship categories with count bubbles | ✅ Live |\n| 👤 **Profile Modals** | Clickable mentor cards with full profile display | ✅ Live |\n| 📅 **Availability Integration** | Real-time availability pulling from Cal.com and bookings | ✅ Live |\n| 🛠️ **Data Generation** | Comprehensive testing tools for profiles and availability | ✅ Live |\n| 🗑️ **Smart Cleanup** | Cascading deletes and bulk data management | ✅ Live |\n| 🎨 **Enhanced UI** | Improved styling and user experience | ✅ Live |\n| 🐛 **Advanced Feedback System** | Comprehensive testing feedback with file attachments | ✅ Live |\n| 🔐 **Role-Based Access Control** | Admin/Developer role management and permissions | ✅ Live |\n| 📎 **File Attachment System** | Firebase Storage integration for feedback tickets | ✅ Live |\n| 🖼️ **Image Overlay Viewer** | Full-screen image viewing with download capabilities | ✅ Live |\n| 📊 **Enhanced Analytics** | Detailed feedback analytics with CSV export | ✅ Live |\n\n### 🐛 Feedback \u0026 Testing System\n\n| Feature | Description | Status |\n|---------|-------------|:------:|\n| 🎫 **Ticket Management** | Create, edit, view, and delete feedback tickets | ✅ Live |\n| 📎 **File Attachments** | Upload images, videos, documents (max 10MB each) | ✅ Live |\n| 🏷️ **Smart Categorization** | Bug reports, feature requests, UI issues, performance | ✅ Live |\n| ⭐ **Priority System** | Low, Medium, High, Critical priority levels | ✅ Live |\n| 📊 **Status Tracking** | Draft, Open, In Progress, Resolved, Closed, Duplicate | ✅ Live |\n| 💬 **Comments System** | Internal and public comments with attachments | ✅ Live |\n| 👍 **Voting System** | Upvote/downvote tickets for prioritization | ✅ Live |\n| 🔍 **Advanced Search** | Search by title, description, tags, and metadata | ✅ Live |\n| 📈 **Analytics Dashboard** | Comprehensive feedback analytics with CSV export | ✅ Live |\n| 🖼️ **Image Viewer** | Full-screen image overlay with download functionality | ✅ Live |\n| 🎯 **Testing Fields** | Browser info, OS, device type, screen resolution | ✅ Live |\n| 🔄 **Auto-Detection** | Automatic screen resolution and browser detection | ✅ Live |\n\n### 🔐 Security Features\n\n| Feature | Description | Status |\n|---------|-------------|:------:|\n| 🛡️ **Input Validation** | Comprehensive data sanitization | ✅ Live |\n| 🔒 **Rate Limiting** | API and authentication rate limiting | ✅ Live |\n| 🚫 **XSS Protection** | Cross-site scripting prevention | ✅ Live |\n| 🛡️ **CSRF Protection** | Cross-site request forgery prevention | ✅ Live |\n| 🔐 **Password Security** | Strong password requirements (12+ chars) | ✅ Live |\n| 🗑️ **Cascading Deletes** | Maintains database integrity | ✅ Live |\n| 👥 **Role-Based Access** | Admin/Developer role management and permissions | ✅ Live |\n\n\u003c/details\u003e\n\n---\n\n## 🌟 Ambassador Program\n\n\u003cdiv align=\"center\"\u003e\n\n**Join our network of passionate advocates making a real difference in communities worldwide! 🌍**\n\n\u003c/div\u003e\n\n### 🤝 What is the BGr8 Ambassador Program?\n\nThe BGr8 Ambassador Program is our community-driven initiative that empowers passionate individuals to spread our mission of creating positive change through mentorship and community development.\n\n### ✨ Key Features\n\n| Feature | Description | Benefits |\n|---------|-------------|----------|\n| 🌟 **Community Advocacy** | Represent BGr8 in your local community | Build meaningful connections and make an impact |\n| 🤝 **Network Building** | Connect potential mentors and mentees | Expand your professional and personal network |\n| 📈 **Personal Growth** | Develop leadership and communication skills | Enhance your professional profile |\n| 🎯 **Event Organization** | Organize and participate in community events | Strengthen community bonds and visibility |\n| 💬 **Feedback \u0026 Insights** | Provide valuable feedback to improve our programs | Shape the future of mentorship |\n\n### 🚀 How to Become an Ambassador\n\n1. **📝 Apply Online**: Visit our [Ambassador Page](/ambassador) to submit your application\n2. **📋 Complete Application**: Fill out our comprehensive application form with:\n   - Personal information and experience\n   - Motivation and availability\n   - Social media presence (Instagram, LinkedIn, Twitter, Facebook, TikTok, YouTube)\n   - Location and community involvement\n3. **👥 Admin Review**: Our team reviews your application thoroughly\n4. **✅ Approval \u0026 Onboarding**: Get approved and receive your ambassador role\n5. **🌟 Start Making Impact**: Begin representing BGr8 in your community\n\n### 📊 Program Statistics\n\n- **500+ Active Ambassadors** across the globe\n- **50+ Countries** represented\n- **10,000+ Lives Impacted** through ambassador efforts\n- **Real-time Tracking** of ambassador activities and impact\n\n### 🎯 Ambassador Responsibilities\n\n- **Share BGr8's Mission**: Spread awareness about our platform and values\n- **Connect People**: Introduce potential mentors and mentees to our platform\n- **Organize Events**: Plan and participate in community events and activities\n- **Provide Feedback**: Share insights to help improve our programs\n- **Professional Representation**: Represent BGr8 professionally in your community\n\n### 💡 Benefits of Being an Ambassador\n\n- **🌟 Make an Impact**: Create meaningful change in your community\n- **🤝 Build Connections**: Connect with mentors, mentees, and fellow ambassadors\n- **📈 Personal Growth**: Develop leadership and communication skills\n- **🌍 Global Network**: Join a worldwide network of passionate advocates\n- **📚 Learning Opportunities**: Access to exclusive resources and training\n\n### 🔧 Admin Management\n\nOur comprehensive admin system allows administrators to:\n- **Review Applications**: Thoroughly evaluate ambassador applications\n- **Track Statistics**: Monitor active ambassadors vs. applications\n- **Manage Approvals**: Approve/reject applications with automatic role assignment\n- **Monitor Impact**: Track ambassador activities and community engagement\n\n*Learn more about admin management in our [Admin Portal Overview](docs/ADMIN_PORTAL_OVERVIEW.md)*\n\n---\n\n## 🛠️ Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n\n```mermaid\ngraph TD\n    A[🎨 Frontend] --\u003e B[⚛️ React + TypeScript]\n    A --\u003e C[⚡ Vite 6.1]\n    A --\u003e D[🎨 CSS Variables]\n    E[🔧 Backend Services] --\u003e F[🔥 Firebase 11.3]\n    F --\u003e G[🔐 Authentication]\n    F --\u003e H[🗄️ Firestore]\n    F --\u003e I[📦 Storage]\n    L[📅 Booking System] --\u003e M[🌐 Cal.com API]\n    L --\u003e N[📅 Availability Management]\n    L --\u003e O[📋 Event Types]\n    L --\u003e P[📊 Bookings Management]\n    R[🛠️ Admin Tools] --\u003e S[👥 Profile Generation]\n    R --\u003e T[📅 Availability Generation]\n    R --\u003e U[🗑️ Data Cleanup]\n    R --\u003e Z[🐛 Feedback System]\n    V[🛡️ Security] --\u003e W[🔒 Rate Limiting]\n    V --\u003e X[🛡️ Input Validation]\n    V --\u003e Y[🔐 Password Security]\n    V --\u003e AA[👥 Role-Based Access]\n    BB[📎 File Management] --\u003e CC[🖼️ Image Overlay]\n    BB --\u003e DD[📥 File Downloads]\n    BB --\u003e EE[📦 Firebase Storage]\n    \n    style A fill:#61DAFB\n    style E fill:#FFCA28\n    style F fill:#FF6B35\n    style L fill:#00E676\n    style R fill:#FF9800\n    style V fill:#E91E63\n    style BB fill:#9C27B0\n```\n\n**Our platform leverages cutting-edge technologies for optimal performance and user experience.**\n\n\u003c/div\u003e\n\n---\n\n## 📖 Documentation\n\n### 🏢 Admin Documentation\n- [🏢 **Admin Portal Overview**](docs/ADMIN_PORTAL_OVERVIEW.md) - Complete admin portal guide and features\n- [🐛 **Testing Feedback System**](docs/ADMIN_TESTING_FEEDBACK_GUIDE.md) - Detailed feedback management guide\n- [⚡ **Admin Quick Reference**](docs/ADMIN_QUICK_REFERENCE.md) - Quick reference for common admin tasks\n\n### 🛠️ Technical Documentation\n- [📋 Changelog](CHANGELOG.md) - Detailed version history and updates\n- [🤝 Contributing Guide](CONTRIBUTING.md) - How to contribute to the project\n- [🔒 Security Policy](SECURITY.md) - Security guidelines and reporting\n- [📄 License](LICENSE) - MIT License details\n\n### 📚 Additional Resources\n- [🏗️ Architecture Overview](docs/ARCHITECTURE.md) - System architecture and design decisions\n- [🔧 Development Setup](docs/DEVELOPMENT_SETUP.md) - Detailed development environment setup\n- [🚀 Deployment Guide](docs/DEPLOYMENT.md) - Production deployment instructions\n- [📊 API Documentation](docs/API.md) - API endpoints and usage\n\n---\n\n## ⚡ Quick Start\n\n\u003cdiv align=\"center\"\u003e\n\n**Get up and running in under 5 minutes! 🚀**\n\n\u003c/div\u003e\n\n### 1️⃣ Clone the repository\n\n```bash\ngit clone https://github.com/Hum2a/bgr8.git\ncd bgr8\n```\n\n### 2️⃣ Install dependencies\n\n```bash\nnpm install\n```\n\n### 3️⃣ Set up environment\n\nGet `.env` file from Hum2a (see Environment Variables section for details)\n\n### 4️⃣ (Optional) Start Firebase emulators for development\n\nFor local development with Firebase emulators, see detailed setup instructions in [firebase_emulator/README.md](firebase_emulator/README.md)\n\n### 5️⃣ Start development server\n\n```bash\nnpm run dev\n```\n\n---\n\n## 📋 Prerequisites\n\n\u003cdiv align=\"center\"\u003e\n\n**Before you begin, ensure you have the following installed:**\n\n\u003c/div\u003e\n\n| Requirement | Version | Download |\n|-------------|---------|----------|\n| 🟢 **Node.js** | `v16.x` or higher | [Download](https://nodejs.org/) |\n| 📦 **npm** | `v8.x` or higher | [Included with Node.js](https://nodejs.org/) |\n| 🔥 **Firebase Account** | Any | [Sign Up](https://firebase.google.com/) |\n\n---\n\n## 🚀 Installation\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📋 Detailed Installation Guide\u003c/strong\u003e\u003c/summary\u003e\n\n### Step 1: Repository Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/Hum2a/bgr8.git\n\n# Navigate to project directory\ncd bgr8\n```\n\n### Step 2: Dependencies Installation\n\n```bash\n# Install all dependencies\nnpm install\n```\n\n### Step 3: Environment Configuration\n\n\u003e **⚠️ Important:** You will need your own Firebase account.\n\u003e Get the correct `.env` file from Hum2a to place in the root directory.\n\n### Step 4: Launch Development Server\n\n```bash\n# Start the main application\nnpm run dev\n```\n\n**🎉 Congratulations! Your development environment is now ready.**\n\n\u003c/details\u003e\n\n---\n\n## 🌐 Deployment\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🚀 Deployment Instructions\u003c/strong\u003e\u003c/summary\u003e\n\n### Production Build\n\n```bash\n# Create optimized production build\nnpm run build\n\n# Preview production build locally\nnpm run preview\n```\n\n### Deployment Options\n\n| Platform | Instructions | Status |\n|----------|-------------|:------:|\n| 🚀 **Vercel** | Connect GitHub repo | ✅ Supported |\n| ☁️ **Netlify** | Drag \u0026 drop build folder | ✅ Supported |\n| 🔥 **Firebase Hosting** | `firebase deploy` | ✅ Supported |\n\n\u003c/details\u003e\n\n---\n\n## 🔧 Environment Variables\n\n\u003cdiv align=\"center\"\u003e\n\n**Required environment variables for full functionality**\n\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🔐 View all environment variables\u003c/strong\u003e\u003c/summary\u003e\n\n### Frontend Variables (`.env`)\n\n| Variable | Description | Required | Example |\n|----------|-------------|:--------:|---------|\n| `VITE_FIREBASE_API_KEY` | Firebase API Key | ✅ | `AIzaSyC...` |\n| `VITE_FIREBASE_AUTH_DOMAIN` | Firebase Auth Domain | ✅ | `project.firebaseapp.com` |\n| `VITE_FIREBASE_PROJECT_ID` | Firebase Project ID | ✅ | `your-project-id` |\n| `VITE_FIREBASE_STORAGE_BUCKET` | Firebase Storage Bucket | ✅ | `project.appspot.com` |\n| `VITE_FIREBASE_MESSAGING_SENDER_ID` | Firebase Messaging Sender ID | ✅ | `123456789` |\n| `VITE_FIREBASE_APP_ID` | Firebase App ID | ✅ | `1:123456789:web:abc123` |\n| `VITE_FIREBASE_MEASUREMENT_ID` | Firebase Measurement ID | ✅ | `G-XXXXXXXXXX` |\n| `VITE_USE_EMULATORS` | Enable Firebase emulators for development | ⚠️ | `true` or `false` |\n\n\u003c/details\u003e\n\n---\n\n## 🏷️ Release Tag Manager\n\n\u003cdiv align=\"center\"\u003e\n\n**`release.sh`** - A cross-platform bash script for managing semantic versioned release tags\n\n\u003c/div\u003e\n\n### Prerequisites\n\n- ✅ Git installed and configured\n- ✅ Remote repository set up (`origin`)\n- ✅ Bash shell (works on Linux/macOS/Git Bash for Windows)\n\n#### Windows PowerShell Alias Setup\n\n```powershell\nSet-Alias -Name bash -Value \"\u003cabsolute_path_to_git_installation\u003e\\bin\\bash.exe\"\n# Example: C:\\Program Files\\Git\\bin\\bash.exe\n```\n\n### Usage\n\n```bash\n# Linux/MacOS\n./release.sh [OPTIONS]\n\n# Windows\nbash release.sh [OPTIONS]\n```\n\n### Available Options\n\n| Flag | Description | Example |\n|------|-------------|---------|\n| `--major` | Increment major version | `v2.0.0` |\n| `--minor` | Increment minor version | `v1.1.0` |\n| `--patch` | Increment patch version | `v1.0.1` (default) |\n| `--name NAME` | Append custom name | `--name beta` → `v1.0.0-beta` |\n| `--set-tag TAG` | Set specific tag | `--set-tag v1.2.3` |\n| `--current` | Show current release tag | Displays current version |\n| `--force` | Force tag creation | Override existing tags |\n| `--help` | Show help message | Display usage information |\n\n### Behavior\n\n1. 🔄 **Always syncs** with remote tags first\n2. ✅ **Validates** tag format (vX.Y.Z or vX.Y.Z-NAME)\n3. 🚫 **Prevents** duplicate tags\n\n---\n\n## 📁 Project Structure\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📂 View complete project structure\u003c/strong\u003e\u003c/summary\u003e\n\n```\nbgr8/\n├── 📁 src/\n│   ├── 🧩 components/         # React components\n│   │   ├── 👨‍💼 admin/          # Admin-specific components\n│   │   │   ├── 📊 Analytics components (FeedbackAnalytics, BookingAnalytics)\n│   │   │   ├── 🎲 GenerateRandomProfile.tsx\n│   │   │   ├── 👥 MentorManagement.tsx\n│   │   │   ├── 📋 Bookings management (BookingsTable, BookingsGrouped)\n│   │   │   ├── 📅 SessionsManagement.tsx\n│   │   │   ├── 🔧 Admin utilities (AdminMentorModal, BookingDetailsModal)\n│   │   │   └── 🐛 Feedback system (RoleManagement, RoleManagementModal)\n│   │   ├── 🎬 animations/      # Animation components (LoadingSpinner)\n│   │   ├── 🎨 ui/              # UI components\n│   │   ├── 📝 feedback/        # Feedback components (StatsTiles)\n│   │   ├── 📅 sessions/        # Session-related components\n│   │   ├── 🧩 modals/          # Modal components\n│   │   │   ├── 🐛 Feedback modals (CreateTicketModal, ViewTicketModal, EditTicketModal)\n│   │   │   ├── 🖼️ ImageOverlay.tsx\n│   │   │   ├── 💬 CommentsSidebar.tsx\n│   │   │   └── 🗑️ DeleteTicketModal.tsx\n│   │   └── 🧠 widgets/         # Widget components\n│   │       └── 🎓 MentorAlgorithm/  # Mentor matching logic\n│   │           ├── 📅 availability/  # Availability management\n│   │           ├── 📅 booking/       # Booking system\n│   │           ├── 🔗 CalCom/        # Cal.com integration\n│   │           └── 🧮 algorithm/     # Matching algorithm (matchUsers.ts)\n│   ├── 📄 pages/              # Page components\n│   │   ├── 👨‍💼 adminPages/      # Admin pages (AdminPortal, AdminEnquiries, AdminSettings)\n│   │   ├── 🔐 authPages/       # Authentication pages (SignIn, Register, ForgotPassword)\n│   │   ├── 💼 businessPages/   # Business pages (BGr8)\n│   │   ├── 🎓 mentorPages/     # Mentor-related pages\n│   │   └── 🛠️ utilPages/        # Utility pages (Profile, Settings, Feedback)\n│   ├── 🎨 styles/             # CSS stylesheets\n│   │   ├── 👨‍💼 adminStyles/    # Admin-specific styles\n│   │   ├── 💼 businessStyles/  # Business-specific styles\n│   │   ├── 🧩 components/      # Component-specific styles\n│   │   └── 💳 payment/         # Payment-related styles (Success, Cancel)\n│   ├── 🪝 hooks/              # Custom React hooks (useAuth, useIsMobile)\n│   ├── 🔄 contexts/           # React context providers (AuthContext)\n│   ├── 🛠️ utils/              # Utility functions\n│   │   ├── 🔐 security.ts      # Security utilities\n│   │   ├── 🛡️ securityMonitor.ts # Security monitoring\n│   │   ├── 👤 userProfile.ts   # User profile utilities\n│   │   ├── 🎨 iconMapping.tsx  # Icon mapping utilities\n│   │   ├── 📱 screenResolution.ts # Screen resolution detection\n│   │   ├── 📥 fileDownload.ts  # File download utilities\n│   │   └── 🔄 updatePermissions.ts # Permission management\n│   ├── 📝 types/              # TypeScript type definitions\n│   │   ├── 👤 user.ts          # User profile types\n│   │   ├── 📅 sessions.ts      # Session types\n│   │   ├── 📋 bookings.ts      # Booking types\n│   │   ├── 🏢 b8fc.ts          # Business types\n│   │   ├── 👨‍💼 admin.ts         # Admin types\n│   │   ├── 🐛 feedback.ts      # Feedback system types\n│   │   └── 🔐 verification.ts  # Verification types\n│   ├── 🔥 firebase/           # Firebase configuration\n│   │   ├── 🔧 firebase.tsx     # Main Firebase config\n│   │   └── 🛠️ emulatorUtils.ts # Emulator utilities\n│   ├── 🛡️ middleware/         # Security middleware\n│   ├── 🧭 navigation/         # Navigation logic (navigation.tsx)\n│   ├── 📊 constants/          # Application constants\n│   │   ├── 🎓 skillsByCategory.ts\n│   │   ├── 🏛️ ukEducationLevels.ts\n│   │   ├── 🏢 industries.ts\n│   │   ├── 🎨 hobbiesByCategory.ts\n│   │   ├── 🏛️ religionOptions.ts\n│   │   ├── 🌍 ethnicityOptions.ts\n│   │   └── 🗺️ ukCounties.ts\n│   ├── 📊 data/              # Sample data and autofill\n│   │   └── 🎲 autofillData.ts # Test data for development\n│   ├── 🔧 config/             # Configuration files (security.ts)\n│   ├── 🎨 assets/             # Static assets (images, etc.)\n│   └── 🔧 services/           # Service layer\n│       ├── 📅 sessionsService.ts\n│       ├── 🐛 feedbackService.ts\n│       ├── 👨‍💻 developerFeedbackService.ts\n│       ├── 👥 mentorFeedbackService.ts\n│       ├── 🔐 verificationService.ts\n│       └── 📊 pagePermissionsService.ts\n├── 🌐 public/                 # Public static assets\n├── 🔥 firebase_emulator/      # Firebase emulator configuration\n│   ├── 📄 README.md           # Emulator setup instructions\n│   ├── 📜 download_cloud_data.sh # Data export script\n│   ├── ⚙️ firebase.json       # Firebase configuration\n│   ├── 🔧 .firebaserc        # Firebase project configuration\n│   ├── 🛡️ firestore.rules    # Firestore security rules\n│   ├── 📁 storage.rules      # Storage security rules\n│   └── 📊 data/              # Exported data storage\n├── 📄 docs/                  # Documentation files\n├── 🔒 .env                   # Environment variables\n├── 📦 package.json           # Dependencies and scripts\n├── ⚙️ vite.config.ts         # Vite configuration\n├── 📝 tsconfig.json          # TypeScript configuration\n├── 🎨 eslint.config.js       # ESLint configuration\n├── 🏷️ release.sh             # Release tag manager script\n└── 📄 README.md              # This file\n```\n\n\u003c/details\u003e\n\n---\n\n## 🤝 Contributing\n\n\u003cdiv align=\"center\"\u003e\n\n**We welcome contributions from the community! 🌟**\n\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e📋 Contributing Guidelines\u003c/strong\u003e\u003c/summary\u003e\n\n### How to Contribute\n\n1. 🍴 **Fork** the repository\n2. 🌿 **Create** a feature branch (`git checkout -b feature/amazing-feature`)\n3. 💾 **Commit** your changes (`git commit -m 'Add amazing feature'`)\n4. 📤 **Push** to the branch (`git push origin feature/amazing-feature`)\n5. 🔄 **Open** a Pull Request\n\n### Development Guidelines\n\n- ✅ Follow TypeScript best practices\n- 🎨 Maintain consistent code style using CSS variables\n- 📝 Write meaningful commit messages\n- 📚 Update documentation as needed\n- 🔍 Ensure proper contrast for UI elements\n- 📱 Test responsive design across devices\n\n### Code of Conduct\n\nWe are committed to providing a welcoming and inspiring community for all. Please read our [Code of Conduct](CODE_OF_CONDUCT.md) for details.\n\n\u003c/details\u003e\n\n---\n\n## 📄 License\n\n\u003cdiv align=\"center\"\u003e\n\n**This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n\n\u003c/div\u003e\n\n---\n\n## 🔒 Security\n\n\u003cdiv align=\"center\"\u003e\n\n**Security is our top priority**\n\n\u003c/div\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🛡️ Security Information\u003c/strong\u003e\u003c/summary\u003e\n\n### Reporting Security Issues\n\nIf you discover a security vulnerability, please:\n\n1. 🔒 **Do NOT** create a public GitHub issue\n2. 📧 **Email** us directly at [security@bgr8.com](mailto:security@bgr8.com)\n3. ⏰ **Wait** for our response (we aim to respond within 24 hours)\n\n### Security Features\n\n- 🔐 **Firebase Authentication** - Secure user management\n- 🛡️ **Input Validation** - Comprehensive data sanitization\n- 🔒 **HTTPS Only** - Encrypted data transmission\n- 🚫 **XSS Protection** - Cross-site scripting prevention\n- 🛡️ **CSRF Protection** - Cross-site request forgery prevention\n- 🗑️ **Cascading Deletes** - Maintains database integrity\n- 🔒 **Rate Limiting** - API and authentication rate limiting\n- 🔐 **Password Security** - Strong password requirements (12+ characters)\n- 🛡️ **Security Headers** - Comprehensive security headers\n- 🔒 **Session Management** - Secure session handling\n\n### Security Tools\n\n- 🛡️ **ESLint Security** - Security-focused linting\n- 🔍 **Snyk** - Vulnerability scanning\n- 📊 **Security Monitoring** - Real-time security monitoring\n- 🔐 **Middleware Security** - Request validation and sanitization\n\n\u003c/details\u003e\n\n---\n\n## 📞 Contact\n\n\u003cdiv align=\"center\"\u003e\n\n**Get in touch with our team**\n\n\u003c/div\u003e\n\n| Contact Method | Details |\n|----------------|---------|\n| 👨‍💻 **Developer** | Humza (Hum2a) |\n| 🐛 **Issues** | [GitHub Issues](https://github.com/Hum2a/bgr8/issues) |\n| 📧 **Email** | [Contact Us](mailto:contact@bgr8.com) |\n\n---\n\n## 🙏 Acknowledgments\n\n\u003cdiv align=\"center\"\u003e\n\n**Special thanks to all contributors and the amazing BGr8 community! 🌟**\n\n\u003c/div\u003e\n\n### Contributors\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n\u003ca href=\"https://github.com/Hum2a\"\u003e\n\u003cimg src=\"https://avatars.githubusercontent.com/Hum2a\" width=\"100px;\" alt=\"Hum2a\"/\u003e\n\u003cbr /\u003e\n\u003csub\u003e\u003cb\u003eHum2a\u003c/b\u003e\u003c/sub\u003e\n\u003c/a\u003e\n\u003cbr /\u003e\n\u003csub\u003eHumza Butt\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\u003ca href=\"https://github.com/YakMan101\"\u003e\n\u003cimg src=\"https://avatars.githubusercontent.com/YakMan101\" width=\"100px;\" alt=\"YakMan101\"/\u003e\n\u003c/a\u003e\n\u003cbr /\u003e\n\u003csub\u003e\u003cb\u003eYakMan101\u003c/b\u003e\u003c/sub\u003e\n\u003cbr /\u003e\n\u003csub\u003eShayak Hussain\u003c/sub\u003e\n\u003c/td\u003e\n\u003ctd align=\"center\"\u003e\n\u003ca href=\"https://github.com/aoladuti1\"\u003e\n\u003cimg src=\"https://avatars.githubusercontent.com/aoladuti1\" width=\"100px;\" alt=\"aoladuti1\"/\u003e\n\u003cbr /\u003e\n\u003csub\u003e\u003cb\u003eaoladuti1\u003c/b\u003e\u003c/sub\u003e\n\u003c/a\u003e\n\u003cbr /\u003e\n\u003csub\u003eAntonio Oladuti\u003c/sub\u003e\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### Technologies \u0026 Libraries\n\n- ⚛️ **React 18.2** - UI framework\n- 🔥 **Firebase 11.3** - Backend services\n- 📅 **Cal.com** - Calendar \u0026 booking system\n- ⚡ **Vite 6.1** - Build tool\n- 🎨 **CSS3** - Styling with CSS variables\n- 🔍 **Search Algorithms** - Intelligent filtering and discovery\n- 📊 **Data Management** - Comprehensive testing and cleanup tools\n- 🛡️ **Security Tools** - ESLint security, Snyk, custom security middleware\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by the BGr8 Team**\n\n[⬆️ Back to top](#-bgr8-platform)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBgr8Dev%2FBgr8","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBgr8Dev%2FBgr8","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBgr8Dev%2FBgr8/lists"}