Crowd Pilot AI 🏟️

The Holographic Stadium Matrix & Smart Event Companion

A lightweight, purely vanilla HTML/CSS/JavaScript web application designed to act as a personalized, state-of-the-art AI dashboard for attendees at large-scale sporting venues. Built as a high-performance "Command Center" interface.

🎯 The Problem

Navigating massive sporting venues is notoriously frustrating. Attendees struggle with bottlenecked entry gates, unpredictable restroom/food lines, and post-game traffic surges. Simple static maps don't adapt to the real-time flow of human traffic, sudden weather changes, or accessibility constraints.

💡 The Solution

Crowd Pilot AI serves as your proactive, context-aware stadium concierge. By reading real-time saturation matrices alongside your specific user constraints (Seat uplinks, weather, ADA needs), the application dynamically calculates optimal entry paths, suggests intelligent break times to avoid rushes, and predicts the fastest exit strategies.

---

✨ Core Features

• Live Holographic Radar Array: A dynamic SVG-powered stadium map that visually tracks your paths, illuminating optimal active routes and pulsing entry nodes based on traffic density.
• Onboard Smart Local AI: A completely custom, zero-dependency Natural Language Processing (NLP) chat engine. Ask about food, routing, or traffic via text or Voice, and the AI will analyze the live matrix to give you instantaneous, context-correct advice without needing external API keys.
• Weather Override Protocols: Raining? The AI actively re-evaluates the matrix, instantly penalizing outdoor entries (like the West Gate) and routing you exclusively through covered pathways.
• ADA Accessibility Mode: Seamlessly filters routing graphs to prioritize ramps and elevators, physically locking out stair-heavy entrances.
• Predictive Event Sequencing: The matrix constantly reads the game phase (Pre-Game, Halftime, Q3). It knows halftime triggers massive restroom/merch queues, and will intelligently advise you to hold off until the 3rd Quarter.
• Transit & Rideshare Analytics: Forewarns you about external post-game congestion loops and dynamic uber/rideshare surge pricing (>2.0x).

---

🛠️ Architecture

This application is engineered strictly on a Vanilla Frontend Stack (< 1MB) for lightning-fast UI performance:

• index.html: The structural backbone deploying a heavily optimized CSS Grid "Command Center" responsive layout.
• style.css: Powers the premium aesthetic—dark-glassmorphism, CSS sub-grid meshes, cyber-typography, and hardware-accelerated 3D tilt effects.
• app.js: The central monolithic controller. Houses the AI parsing engine, Firebase WebSocket listeners, DOM manipulation tree, and the temporal Event Simulator clock.

(Note: There are no build steps, no React/Vue bloat, and zero compilation dependencies.)

---

🚀 How to Run

Because the architecture abandons heavy module bundling, getting the app running is instantaneous.

1. Clone or Download this repository.
2. Launch the App: You can launch the dashboard by simply double-clicking index.html to open it in your browser (file:///).
3. Using the Voice AI: Important! Modern browsers proactively block microphone execution on file:/// protocols for security reasons. If you want to use the Voice Chat feature, you must serve the application on a local server context:
   • VS Code: Right-click index.html and use the Live Server extension.
   • NodeJS: Open a terminal and run npx serve. (Then open the provided http://localhost:XXXX link in your browser!)

---

🔌 External Connectivity

• Firebase Realtime Database: The dashboard features a persistent Data Source override toggle. Switch it to "Firebase Live" to kill the localized JavaScript matrix simulator and listen securely for active cloud WebSocket pushes, reflecting truly live turnstile hardware metrics!