Here's a concise description for FindIT: FindIT is a modern event discovery and hosting platform for Uganda. Users can browse, search, and book local events, while organizers manage tickets, track attendance, and view analytics. Built with React + TypeScript, Supabase backend, and Mapbox integration for venue maps. Features real-time noti
# Find It β Ugandan Event Discovery Platform
A modern event discovery and hosting platform built for Uganda, allowing users to find, save, and attend local events while giving organizers powerful tools to host and manage them.
## Features
- π **Event Discovery** β Browse, search, and filter events by category, city, and date
- ποΈ **Ticket Checkout** β Built-in checkout flow with promo code support
- β **Reviews & Ratings** β Attendees can leave reviews; organizers get notified instantly
- π **Notifications** β Real-time organizer notifications for reviews and ticket sales
- πΊοΈ **Mapbox Integration** β Interactive venue maps on every event page
- π
**Calendar Export** β Add events to Google, Apple, or Outlook calendar
- π **Auth Roles** β Separate flows for Guests, Users, Hosts, and Admins
- π **Host Dashboard** β Full event management, analytics, and attendee tools
- π **Multi-language** β Language context built in
- π± **Responsive** β Mobile-first design
## Tech Stack
- **Frontend** β React + TypeScript + Vite
- **Styling** β Vanilla CSS with design tokens
- **Database** β Supabase (PostgreSQL + Auth + RLS)
- **Maps** β Mapbox GL JS (`react-map-gl`)
- **Icons** β Phosphor Icons
## Getting Started
### 1. Clone the repo
```bash
git clone
github.com
cd find-it
```
### 2. Install dependencies
```bash
npm install
```
### 3. Set up environment variables
```bash
cp .env.example .env
```
Fill in your Supabase and Mapbox credentials in `.env`.
### 4. Run the database migrations
Apply the SQL files in order using the Supabase SQL editor:
1. `supabase_schema.sql` β Core tables (profiles, events)
2. `supabase_saved_events.sql` β Saved events table
3. `supabase_reviews_notifications.sql` β Reviews & notifications tables
### 5. Start the dev server
```bash
npm run dev
```
Open
localhost in your browser.
## Project Structure
```
src/
βββ components/ # Reusable UI components
β βββ account/ # Host & User ac β¦