​

Local Development

​

Running Components

​

Web Dashboard

cd ~/findu/web_app
npm install
npm run dev

• URL: http://localhost:5173
• Hot Reload: Yes
• Environment: Uses .env.local settings

​

iOS App

cd ~/findu/ios_app
pod install
open ios_app.xcodeproj

• Simulator: iPhone 15 Pro recommended
• Device: Requires developer certificate
• Backend: Points to dev Supabase

​

ML Engine

cd ~/findu/matching-algorithm
source venv/bin/activate
python api_v2/main.py

• URL: http://localhost:8000
• API Docs: http://localhost:8000/docs
• Requirements: Python 3.9+

​

Supabase Local

cd ~/findu/supabase
supabase start

• Studio: http://localhost:54323
• API: http://localhost:54321
• Note: Usually use cloud dev instance instead

​

Common Development Tasks

​

Switching Environments

# Check current environment
./findu env status

# Switch to dev
./findu env switch dev

# Switch to prod (careful!)
./findu env switch prod

​

Running Tests

cd ~/findu/web_app
npm test               # Unit tests
npm run test:e2e      # E2E tests
npm run lint          # Linting
npm run typecheck     # TypeScript

​

Database Tasks

# Create a new migration
cd ~/findu/supabase
supabase migration new your_migration_name

# Apply migrations
supabase db push

# Reset database (dev only!)
supabase db reset

​

Debugging

​

Web Dashboard

1. Chrome DevTools: Best for React debugging
2. React DevTools: Install browser extension
3. Network Tab: Monitor Supabase calls

​

iOS App

1. Xcode Debugger: Breakpoints and variable inspection
2. Console Logs: View in Xcode console
3. Network Debugging: Use Proxyman or Charles

​

Database

1. Supabase Dashboard: SQL editor and logs
2. Table Editor: Visual data inspection
3. Logs Explorer: Real-time query logs

​

Tips & Tricks

​

Troubleshooting

​

Next Steps

• Review workflow guide for git practices
• Check architecture to understand component interactions
• Browse contributing guide for coding standards