A travel expense tracking application built with React and FastAPI, featuring multi-currency support and automated debt settlement calculations.

• Multi-currency expense tracking with real-time exchange rates
• Fictional member management (add members before they join)
• Optimal debt settlement algorithms
• Mobile-first responsive design
• OAuth authentication (Google, GitHub) via Supabase

• Python 3.11+
• Node.js 18+
• Supabase account

1. Clone the repository
2. Configure Supabase project with OAuth providers
3. Set up environment variables
4. Run the applications

# Backend
cd backend
cp .env.example .env  # Set up your environment variables
./start.sh

# Frontend
cd frontend
cp .env.example .env.local  # Set up your environment variables
npm install
npm run dev

• FastAPI
• SQLModel
• PostgreSQL
• Supabase
• Alembic
• httpx
• pytest

• React 19
• TypeScript
• Vite
• Tailwind CSS
• React Router
• TanStack Query
• Supabase
• Zustand

• Backend - API endpoints, database schema, migrations
• Frontend - Component architecture, routing, state management
• Setup Guide - Detailed installation and configuration
• Deployment - Production deployment options

# Backend tests
cd backend && pytest

# Frontend tests (planned)
cd frontend && npm test

See DEPLOYMENT_GUIDE.md for production deployment guides.

MIT