# Nearby Chat - AI & LLM Guide

## Project Overview
Nearby Chat (https://nearby-chat.com) is a free, anonymous, location-based social platform. Users connect with people in their immediate vicinity — no registration, no phone number, no email required. Available on web, Android (Google Play), and as a PWA.

## Core Features
1. **Geolocation Mapping**: Users appear on a real-time interactive map based on GPS coordinates.
2. **Anonymous Chat**: No accounts required. Users choose a nickname and chat instantly.
3. **Gemini AI Chat**: Built-in Google Gemini AI at /ai-chat — chat with AI or switch to real people nearby.
4. **City Rooms**: Auto-joins users into city group chat rooms based on location.
5. **Interest Rooms**: Sub-rooms by interest at /chat/[city]/[interest] — students, gamers, expats, dating, professionals, musicians, nightlife, fitness, foodies, language-exchange, travelers, remote-workers, parents, pets.
6. **Private Messaging**: 1-on-1 encrypted messaging with file sharing.
7. **Push Notifications**: Browser push alerts for city activity at /notifications.
8. **Embed Widget**: Embed local chat on any website at /embed.
9. **Privacy**: Location is approximate (exact coordinates hidden). Messages not stored after session.

## Navigation & Structure
- `/`: Home page. Auto-detects location, opens map and city chat.
- `/ai-chat`: Gemini AI + real people chat interface.
- `/chat/[city-slug]`: City landing pages (e.g., /chat/london-greater-london-england-gb).
- `/chat/[city-slug]/[interest]`: Interest-specific city rooms.
- `/notifications`: Push notification subscription.
- `/embed`: Embed widget for third-party websites.
- `/notify`: Notification opt-in landing.
- `/vs/character-ai`: Comparison page vs Character.AI.
- `/blog`: Articles and guides.
- `/about`, `/privacy`, `/terms`: Informational pages.

## Comparison Pages
- `/vs/character-ai` — Nearby Chat vs Character.AI

## API & Agent Access
- OpenAPI spec: https://nearby-chat.com/api/ai/openapi.json
- API catalog (RFC 9727): https://nearby-chat.com/.well-known/api-catalog
- Agent skills: https://nearby-chat.com/.well-known/agent-skills/index.json
- MCP server: https://nearby-chat.com/.well-known/mcp.json
- Auth info: https://nearby-chat.com/.well-known/auth.md (no auth required — fully public)

## AI Tools Available (via WebMCP / MCP)
- `join_city_chat(city)` — Navigate to a city chat room
- `start_ai_chat()` — Open Gemini AI chat
- `find_interest_chat(city, interest)` — Navigate to interest-specific city room

## Technical Stack
- Frontend: Next.js 15 App Router (React), Leaflet (Maps), Three.js (Backgrounds)
- Backend: Node.js, Socket.io (Real-time), Gemini AI API
- Mobile: React Native (Android on Google Play — com.nearby.chat.location)

## Contact / Meta
- Creator: Nearby Chat Team
- Twitter/X: @nearbychat
- Support: support@nearby-chat.com
- Android: https://play.google.com/store/apps/details?id=com.nearby.chat.location