# MapMates

> New city? Drop a pin, find people nearby, and meet for coffee. MapMates helps newcomers, expats, digital nomads, remote workers, and locals connect in real life.

MapMates helps people find and connect with others nearby in real life. Users drop a pin on an interactive map, browse who's around, and send coffee chat requests to meet in person. No signup required, privacy first, free forever.

## Key Features

- Interactive world map with pins for people who want to meet nearby
- Coffee chat requests to meet people nearby
- Private and public community maps with custom branding
- Location-specific pages for 50+ cities (Bangkok, Bali, Lisbon, etc.)
- Category filtering: Entrepreneur, Freelancer, Remote Worker, Digital Nomad, Retiree, Student
- Privacy modes: exact location or country-only
- Admin dashboard for community leaders
- No signup required to browse or add a pin

## Pages

- [Home](https://mapmates.io): Landing page with features overview
- [Global Map](https://mapmates.io/map): Interactive map with all pins
- [Communities](https://mapmates.io/communities): Browse public community maps
- [Create Community](https://mapmates.io/create): Create a private or public community map
- [How It Works](https://mapmates.io/how-it-works): Step-by-step guide
- [About](https://mapmates.io/about): Mission and story
- [FAQ](https://mapmates.io/faq): Frequently asked questions
- [Privacy Policy](https://mapmates.io/privacy): Privacy policy
- [Terms of Service](https://mapmates.io/terms): Terms of service

## City Pages

- [Meet people in Bangkok](https://mapmates.io/meet-people-in/bangkok)
- [Meet people in Bali](https://mapmates.io/meet-people-in/bali)
- [Meet people in Lisbon](https://mapmates.io/meet-people-in/lisbon)
- [Meet people in Chiang Mai](https://mapmates.io/meet-people-in/chiang-mai)
- [Meet people in Mexico City](https://mapmates.io/meet-people-in/mexico-city)
- [Meet people in Barcelona](https://mapmates.io/meet-people-in/barcelona)
- [Meet people in Dubai](https://mapmates.io/meet-people-in/dubai)
- [Meet people in Berlin](https://mapmates.io/meet-people-in/berlin)
- [Meet people in Ho Chi Minh City](https://mapmates.io/meet-people-in/ho-chi-minh-city)
- [Meet people in Medellin](https://mapmates.io/meet-people-in/medellin)
- [Meet people in Cape Town](https://mapmates.io/meet-people-in/cape-town)
- [Meet people in Buenos Aires](https://mapmates.io/meet-people-in/buenos-aires)

## API

- GET /api/pins - List all pins on the global map
- POST /api/pins - Add a pin to the map
- GET /api/communities - List public communities
- POST /api/communities - Create a new community
- GET /api/communities/{slug} - Get community details
- GET /api/communities/{slug}/pins - Get pins in a community
- POST /api/coffee - Send a coffee chat request
- GET /api/health - Health check

## Tech Stack

- Next.js 14 (App Router)
- Supabase (PostgreSQL + Auth)
- Leaflet (interactive maps)
- Tailwind CSS
- Vercel (hosting)
- Upstash Redis (rate limiting)
- Resend (transactional email)

## Built By

[Digiwares](https://digiwares.io) - Building tools for real-life connection across cities.