Prerequisites
Before getting started, ensure you have the following installed:- Node.js (>=18)
- npm or yarn
- Git
Installation
Clone the repository and install dependencies:Use
--legacy-peer-deps flag to resolve any peer dependency conflicts in
the monorepoRunning Applications
You have two main options for running the applications during development:Option 1: Using Turbo (Recommended)
Turbo provides orchestrated development across the entire monorepo. Run all applications:Option 2: Running Apps Separately
If you prefer to run applications individually or encounter issues with Turbo:Clinical Dashboard
http://localhost:5173
Alternative start command:
Mobile Application
Application URLs
When running successfully, applications will be available at:- Clinical Dashboard:
http://localhost:5173 - Mobile App (Web):
http://localhost:8081(via Expo) - Documentation:
http://localhost:3000(when running documentation app)
Troubleshooting
Common Issues
Peer dependency conflicts:Environment Variables
Make sure you have the required environment variables set up:- Create
.envfiles in each app directory as needed - Check with your team for the required environment variables
Development Tools
Recommended VS Code extensions:- TypeScript and JavaScript Language Features
- Expo Tools
- Prettier - Code formatter
- ESLint
Next Steps
Once your development environment is running:- Clinical Dashboard: Visit the Clinical User Guides to understand the application flow
- Mobile App: Check the Mobile Architecture documentation
- Backend: Review the Edge Functions Architecture for API development
Clinical User Guides
Learn how to use the clinical dashboard
Technical Architecture
Understand the system architecture
Mobile Development
Mobile app development guide
Database Schema
Backend database structure