ShareMoney

ShareMoney is an app to track balances for money used for shared purposes like Splitwise. It helps you split bills, track shared expenses, and manage balances between friends, roommates, or any group sharing costs.

Quick Start

1. Install dependencies:

   npm install

   This project uses npm workspaces, so a single npm install installs dependencies for all workspaces (root and mobile).

2. Set up environment variables:

   • Create .env in root (see TECH.md for details)
   • Create mobile/.env (see TECH.md for details)

3. Start local Supabase:

   supabase start

4. Run the app:

   # Terminal 1 - Supabase Edge Functions (local)
   npm run dev:server
   # Functions available at http://localhost:54321/functions/v1/
   
   # Terminal 2 - Mobile
   npm run dev:mobile

   Note: Make sure local Supabase is running (supabase start) before starting the Edge Functions server.

Test Database Seed

The supabase/seed.sql file automatically runs when you reset your database:

npx supabase db reset --local

This creates:

• 4 test users ([email protected], [email protected], [email protected], [email protected])
  • Password for all: testpassword123
• 2 test groups with members
• 5 transactions with expense splits
• 2 settlements between users

Note: You may see a 502 error at the end - this is harmless. The seed data is inserted successfully. The error is a timing issue with container health checks during restart.

The seed can be run repeatedly - it uses ON CONFLICT DO NOTHING to safely re-run without duplicates.

Documentation

• TECH.md - Complete technical documentation, setup, deployment, and troubleshooting
• mobile/EXPO_PUBLISH.md - Expo publishing and EAS build guide

Resources

• Supabase migrations: supabase/migrations/
• GitHub Actions: .github/workflows/