Common Development Tasks
This guide covers how to perform common development tasks across the FindU platform. Since we no longer have a centralized CLI, each task is performed directly in the relevant repository.Repository Management
Cloning Repositories
Keeping Repositories Updated
Environment Setup
Web App
iOS App
Matching Algorithm
Running Tests
Web App Tests
Matching Algorithm Tests
iOS App Tests
Database Operations
Using Supabase CLI
Generate TypeScript Types
Documentation
Preview Documentation Locally
Create New Documentation
Deployment
Web App Deployment
Matching Algorithm Deployment
iOS App Deployment
Data Scripts
Update School Data
Scrape School Images
Enhance School Data
Common Workflows
Starting Your Day
Before Creating a PR
Debugging Production Issues
Quick Reference
| Task | Command | Location |
|---|---|---|
| Start web app | npm run dev | web_app/ |
| Start matching API | python main.py | matching-algorithm/api_v2/ |
| Run web tests | npm run test | web_app/ |
| Run Python tests | pytest | matching-algorithm/ |
| Create migration | supabase migration new | Any directory |
| View docs | mintlify dev | docs/ |
| Update schools | npx ts-node index.ts | data_scraping/fetch-api/ |
Tips
- Always work with test data when developing against production
- Check logs frequently in Railway and Supabase dashboards
- Use feature branches and get PR reviews before merging
- Keep dependencies updated but test thoroughly
- Document your changes in code comments and PRs
For more detailed information about specific components, check their individual README files or the architecture overview.