GameDay is a Progressive Web App (PWA) designed to enhance your college football game day experience. Find your friends, locate your car, discover tailgates, and never miss a moment of the action!
Never lose your car in a sea of 50,000 vehicles again. Drop a pin when you park, add notes and photos, and navigate back with one tap.
Create groups with your tailgate crew and share real-time locations. See everyone on a map and navigate to any friend instantly.
Browse public tailgates, RSVP to events, or host your own. Connect with fellow fans and make new friends.
Navigate the stadium area with ease. Find restrooms, food vendors, first aid stations, and more.
Powered by ChatGPT, get instant answers about tailgating tips, parking strategies, what to bring, and more.
Quick access SOS button, check-ins with your group, and ride request features to keep everyone safe.
PWA architecture with IndexedDB caching means the app works even with poor stadium cell service.
- Node.js 18+
- npm or yarn
# Clone the repository
git clone https://github.com/yourusername/gameday.git
cd gameday
# Install dependencies
npm install
# Create environment file
cp .env.example .envCreate a .env file in the root directory:
# Google Maps API Key (required for maps)
# Get yours at: https://console.cloud.google.com/google/maps-apis
VITE_GOOGLE_MAPS_API_KEY=your_google_maps_api_key
# OpenAI API Key (required for AI assistant)
# Get yours at: https://platform.openai.com/api-keys
VITE_OPENAI_API_KEY=your_openai_api_key# Start development server
npm run devThe app will be available at http://localhost:5173
# Create production build
npm run build
# Preview production build
npm run previewGameDay is a Progressive Web App that can be installed on your device:
- Open the app in Safari
- Tap the Share button
- Select "Add to Home Screen"
- Open the app in Chrome
- Tap the menu (⋮)
- Select "Add to Home Screen" or "Install App"
- Look for the install icon in the address bar
- Click "Install"
- Frontend: React 18, Vite
- Styling: Tailwind CSS, shadcn/ui
- Maps: Google Maps API (@react-google-maps/api)
- AI: OpenAI GPT-4o-mini
- Sports Data: ESPN Public API (live scores, rankings, news)
- State Management: TanStack Query (React Query)
- Storage: Local Storage + IndexedDB (fully offline capable)
- PWA: Vite PWA Plugin, Workbox
gameday/
├── public/
│ ├── icons/ # PWA icons
│ └── manifest.json # PWA manifest
├── src/
│ ├── api/ # API clients
│ ├── components/
│ │ ├── ai/ # AI assistant
│ │ ├── auth/ # Authentication
│ │ ├── common/ # Shared components
│ │ ├── map/ # Map components
│ │ ├── onboarding/ # Onboarding flow
│ │ └── ui/ # UI components (shadcn)
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # Utilities & services
│ ├── pages/ # Page components
│ └── utils/ # Helper functions
├── index.html
├── vite.config.js
└── tailwind.config.js
- Location sharing is opt-in and can be disabled at any time
- Location is only shared with group members you choose
- Data is encrypted in transit
- See our Privacy Policy for more details
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Icons by Lucide
- UI components by shadcn/ui
- Maps by Google Maps Platform
Made with 🏈 for fans everywhere