Ever found an event nearby that you wanted to attend, but had no one to go with? MeetMatch is a friend-matching and event discovery mobile app that connects users to nearby events based on their interests, location, and other preferences. It also matches users with others who share similar interests and are planning to attend the same events, making it easier to find people to go with.
MeetMatch was developed by a team of five for Project Launch, a premier semester-long development competition hosted by Knight Hacks at the University of Central Florida (UCF).
| Member | Role | GitHub |
|---|---|---|
| Onella Moitra | Team Lead & Lead Developer | @onella-moitra |
| Schneidine Dorelien | Backend/EventBrite API Integration | @schneidine |
| Gabriel Moody | Frontend/UI | @GoobyM |
| Cristoffer Bohorquez | Backend/Ticketmaster API Integration | @Cristofferb7 |
| Diego Rolon | Chat/ChatThread Functionality | @Ywrd10 |
- Django + Django REST (backend API)
- PostgreSQL + PostGIS (database)
- Expo / React Native (primary frontend)
- CRA React web app (legacy/secondary)
The backend can run either locally or in Docker. For Docker-specific setup, see DOCKER.md.
meetmatch_backend/- Django backend and APIfrontend/meetmatch_mobile/- primary Expo mobile app (iOS/Android/Web)frontend/meetmatch_frontend/- legacy CRA web frontendstart.sh- starts backend + Expo mobile together
Detailed docs:
- Python 3.13+
- Node.js + npm
- PostgreSQL with PostGIS extension
- macOS geospatial libs (if needed):
brew install postgis gdal geos
If you are using Docker instead of local services, install Docker Desktop and use the instructions in DOCKER.md.
Copy .env.example to .env at the repo root and fill in real values:
DEBUG=True
ENVIRONMENT=local
DATABASE_NAME=meetmatch
DATABASE_USER=postgres
DATABASE_PASSWORD=your_postgres_password
DATABASE_HOST=db
DATABASE_PORT=5432
DJANGO_SECRET_KEY=your_secret_key
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
ENVIRONMENT=local
EVENTBRITE_API_KEY=your_eventbrite_tokenThe backend reads DJANGO_SECRET_KEY, DATABASE_*, and EVENTBRITE_API_KEY from this file when running locally or in Docker.
If you want the backend and database in containers, build and run them from the repo root:
docker compose build
docker compose upTo recreate the backend after editing .env:
docker compose up -d --build --force-recreate backendpython3 -m venv .venv
source .venv/bin/activate
pip install -r meetmatch_backend/requirements.txtcd frontend/meetmatch_mobile
npm install
cd ../..From repo root:
./start.shThis starts:
- Backend on
http://0.0.0.0:8000 - Expo Metro on
http://localhost:8081
If you are using Docker for the backend, start it with docker compose up instead and keep the frontend separate unless you also containerize it.
Press Ctrl+C in that terminal to stop both.
POST /api/signup/POST /api/login/GET /api/interests/GET /api/users/<user_id>/interests/POST /api/users/<user_id>/interests/
POST /api/login/ accepts username or email in the username field.
Backend checks/migrations:
source .venv/bin/activate
cd meetmatch_backend
python manage.py check
python manage.py migrateMobile scripts:
cd frontend/meetmatch_mobile
npm start
npm run ios
npm run android
npm run webLegacy web frontend (optional):
cd frontend/meetmatch_frontend
npm start