Healthcare workflow platform with:
- Web app (React + Vite)
- API server (Express + Prisma)
- Shared types package
apps/web— Frontend (doctor / nurse / patient portals)apps/server— Backend API, Prisma schema, business logicpackages/shared-types— Shared TypeScript types across apps
- Node.js 20+
- pnpm 10+
- Python 3.10+ (only needed for optional local speech-to-text fallback)
- Go to the workspace root:
- project root directory
- Install dependencies:
pnpm install
- Configure environment files:
- Copy
apps/server/.env.exampletoapps/server/.env - Copy
apps/web/.env.example(if needed) toapps/web/.env
- Copy
From project root:
- Start web + server together:
pnpm dev
- Start only server:
pnpm run dev:server
- Start only web:
pnpm run dev:web
Default URLs:
- Web:
http://localhost:5173 - API:
http://localhost:3001 - Swagger docs:
http://localhost:3001/docs
From apps/server:
- Generate Prisma client:
pnpm db:generate
- Apply schema (dev):
pnpm db:push
- Run migrations:
pnpm db:migrate
- Seed data:
pnpm db:seed
From project root:
- Build web app:
pnpm build
- The frontend proxies
/apicalls tohttp://localhost:3001. - If you see
/api/*errors from the web app, ensure the server is running. - Some AI features depend on optional external/local services (Gemini, Ollama, Pinecone), configured via
apps/server/.env.