MedAssist - AI Coding Instructions

Architecture Overview

MedAssist is a medication tracking and planning app with a monorepo structure:

Backend: Fastify 5 + TypeScript + SQLite (Drizzle ORM) at backend/
Frontend: React 18 + Vite + TypeScript at frontend/
Database: SQLite with migrations in backend/src/db/migrations/
Deployment: Docker Compose with separate dev containers

Data Flow

Frontend (React) → /api/* proxy → Backend (Fastify) → SQLite
                   ↓ (Vite rewrites /api to /)

The Vite proxy at frontend/vite.config.ts rewrites /api/* to / - so frontend calls /api/medications but backend route is just /medications.

Development Commands

# Start dev environment (preferred)
docker compose up

# Or run services separately:
cd backend && npm run dev      # tsx watch on port 3000
cd frontend && npm run dev     # Vite on port 5173

# Database migrations
cd backend && npm run migrate

Key Patterns

Backend Routes (`backend/src/routes/`)

Routes register directly on app without /api prefix
Use Fastify's type-safe body/params: app.put<{ Body: MyType }>()
Settings: notification config → JSON file (data/notification-settings.json), SMTP → .env

Frontend (`frontend/src/App.tsx`)

Single-file React app with all components and state
Uses React Router for navigation (/dashboard, /medications, /planner, /settings)
API calls use /api/ prefix (proxied by Vite)
Medication scheduling logic with "slices" (usage patterns)

Database Schema (`backend/src/db/schema.ts`)

medications: tracks count, strips, pack inventory, usage schedules as JSON
users, refreshTokens: JWT auth with rotating refresh tokens
settings: legacy table (SMTP now from .env, notifications from JSON file)

Settings Architecture

SMTP config:     .env file (read-only in UI, loaded via env_file in docker-compose)
Notifications:   data/notification-settings.json (editable via UI)

Conventions

TypeScript: Strict mode, ESM modules ("type": "module")
Styling: CSS custom properties in frontend/src/styles.css, dark/light theme via data-theme
API responses: Return objects directly, Fastify serializes to JSON
Environment: Copy .env.example → .env, secrets must be 10+ chars

File Locations

Purpose	Location
Backend entry	`backend/src/index.ts`
Database schema	`backend/src/db/schema.ts`
Migrations	`backend/src/db/migrations/*.sql`
Frontend app	`frontend/src/App.tsx`
Styles	`frontend/src/styles.css`
Docker dev setup	`docker-compose.yml`
Env template	`.env.example`

2.7 KiB Raw Blame History