Local Development Setup

Prerequisites

• Python 3.14+
• Node.js 20+ (22 recommended)
• PostgreSQL 15+
• Git

Installation

# Clone the repo
git clone <repo-url>
cd medical

# Install all dependencies (backend venv + frontend npm)
make install

Configure Environment

# Backend
cp backend/.env.example backend/.env
# Edit backend/.env — set SECRET_KEY at minimum

# Frontend
cp frontend/.env.example frontend/.env
# Default VITE_API_URL=http://localhost:8000 is fine for local dev

Database Setup

make db-create     # Creates 'medtracker' PostgreSQL database
make db-migrate    # Runs Alembic migrations
make seed          # Creates admin user (admin/admin) + seeds reference data

Start Development

make dev           # Starts both backend (port 8000) and frontend (port 5173)

Open http://localhost:5173 and login with admin / admin.

Docker Setup

Prerequisites

• Docker Desktop