Deployed Live: https://eventbuddy.munymunyhom.tech/dashboard
A React-based frontend application for intelligent crowd simulation and event planning. This application allows event organizers to upload event data and venue layouts to receive smart crowd flow predictions and actionable recommendations.
- Event Creation: Create new events with capacity, date, venue details
- File Upload: Upload ticketing data (CSV) and venue layouts (images/JSON)
- Real-time Simulation: Monitor simulation processing with live status updates
- Interactive Dashboard: View crowd density charts and scenario analysis
- AI Recommendations: Receive prioritized suggestions for crowd management
- Event History: Track and manage past event simulations
- Responsive Design: Modern, mobile-friendly interface built with Tailwind CSS
- React 18 with TypeScript
- Vite for build tooling
- React Router for navigation
- Zustand for state management
- Axios for API communication
- Recharts for data visualization
- Lucide React for icons
- Tailwind CSS for styling
src/
├── api/
│ └── apiClient.ts # Central Axios instance for API calls
├── assets/
│ ├── logo.svg
│ └── venue-layout-placeholder.png
├── components/
│ ├── common/ # Reusable UI components
│ │ ├── Button.tsx
│ │ ├── Input.tsx
│ │ ├── Card.tsx
│ │ └── Spinner.tsx
│ ├── dashboard/ # Dashboard-specific components
│ │ ├── SimulationChart.tsx # Crowd density over time (Recharts)
│ │ ├── VenueMap.tsx # Venue layout visualization
│ │ ├── RecommendationCard.tsx # Actionable suggestions
│ │ └── ScenarioTabs.tsx # Entry, exit, congestion views
│ └── layout/
│ ├── Navbar.tsx
│ └── Sidebar.tsx
├── hooks/
│ └── useSimulation.ts # Custom hook for simulation data
├── pages/
│ ├── Dashboard.tsx # Main simulation results page
│ ├── NewEvent.tsx # Event creation form
│ └── History.tsx # Past events and simulations
├── store/
│ └── eventStore.ts # Global state management (Zustand)
├── App.tsx # Main app component with routing
└── main.tsx # Entry point
- Node.js 18+ and npm
- Backend API server running (default: http://localhost:8000/api)
-
Clone and install dependencies:
cd event-ai-frontend npm install -
Set up environment variables:
# Create .env file (optional) echo "VITE_API_BASE_URL=http://localhost:8000/api" > .env
-
Start development server:
npm run dev
-
Build for production:
npm run build
-
Create Event (
/new-event):- Fill out event details (name, capacity, date, venue)
- Upload ticketing CSV and optional venue layout
- Submit to start simulation
-
Monitor Progress (
/dashboard):- View real-time simulation status
- See processing indicator while AI analyzes data
-
View Results (
/dashboard):- Interactive crowd density charts over time
- Venue layout visualization
- Prioritized recommendations for crowd management
- Scenario analysis (entry, exit, congestion)
-
Manage History (
/history):- Browse past events and simulations
- Search and filter events
- View summary statistics
Following React best practices from the project guidelines:
- Functional Components: All components use modern React hooks
- TypeScript: Full type safety throughout the application
- Custom Hooks: Reusable logic extracted (e.g.,
useSimulation) - State Management: Zustand for global state, local state for component-specific data
- Error Handling: Comprehensive error boundaries and user feedback
- Accessibility: Semantic HTML, ARIA attributes, keyboard navigation
- Performance: Memoization, lazy loading, and optimized re-renders
The app expects a backend API with these endpoints:
POST /events- Create new event simulationGET /events/:id/simulation- Get simulation resultsGET /events/:id/status- Check simulation statusGET /events- Get event historyGET /events/:id- Get specific event
VITE_API_BASE_URL: Backend API base URL (default: https://eventbuddy-api.munymunyhom.tech/api/v1)
npm run dev- Start development servernpm run build- Build for productionnpm run preview- Preview production buildnpm run lint- Run ESLint
- ESLint configuration for React/TypeScript
- Tailwind CSS for consistent styling
- Prettier for code formatting (if configured)
-
Build the application:
npm run build
-
Deploy the
distfolder to your hosting platform (Vercel, Netlify, etc.) -
Configure environment variables for production API endpoints
This project is part of the Event Buddy platform for intelligent event planning and crowd simulation.
A modern event-ops dashboard for venues and organizers — real-time crowd forecasts, zone layouts, and operational tools.