SummitQuest Maharashtra

Adventure tourism booking marketplace for Maharashtra — customers discover and book adventures, operators manage listings, admins moderate the platform.

Stack

Layer	Tech
Frontend	Next.js 14, TypeScript, Tailwind, shadcn/ui
Backend	FastAPI, SQLAlchemy, Alembic
Database	PostgreSQL 16 (via Supabase)
Cache	Redis 7
Payments	Stripe
Images	Cloudinary
Email	Resend / SMTP
Auth	Supabase Auth (OAuth + Email)

Project structure

├── frontend/          # Next.js web app (port 3000)
├── backend/           # FastAPI API (port 8000)
├── docker-compose.yml # Postgres + Redis + API
└── SummitQuest_Master_Brief.md # Master planning document

Quick start

1. Start database services

docker compose up postgres redis -d

2. Backend

cd backend
python -m venv .venv
.venv\Scripts\activate        # Windows
pip install -r requirements.txt
copy .env.example .env
alembic upgrade head
uvicorn app.main:app --reload --port 8000

API docs: http://localhost:8000/docs

3. Frontend

cd frontend
copy .env.local.example .env.local
npm install
npm run dev

App: http://localhost:3000

Environment variables

See backend/.env.example and frontend/.env.local.example.

Current build status

• Monorepo scaffold
• Backend auth (register/login) with Supabase
• Database migrations & schema setup
• Frontend landing shell + route structure
• Dynamic beautiful UI design integration
• Adventures, search, booking flow
• Operator & Admin dashboards
• Stripe Payments integration
• Cloudinary image uploads
• Email notifications (Booking & Approval)
• Security hardening (Rate limiting, auth guards)
• Tech debt cleanup

Documentation

Planning docs are consolidated in the repo root (SummitQuest_Master_Brief.md). Additional specs will be added as they are provided.