# Medication Plan Assistant

A pharmacokinetic simulation tool for Lisdexamfetamine (LDX) and d-Amphetamine medication planning with real-time visualization and dose adjustment suggestions.

## 🚀 Quick Start

```sh
# Install dependencies
npm install

# Run the development server
npm start

# Build for production
npm run build
```

The app will be available at `http://localhost:3000` (or `http://0.0.0.0:3000` in dev containers).

## 🛠️ Tech Stack

- **React 19.1** with TypeScript
- **shadcn/ui** component library (Radix UI primitives)
- **Tailwind CSS** for styling
- **Recharts** for concentration-time charts
- **Vite** as build tool

## 📋 Features

- Interactive dose schedule planning with 5 daily time slots
- Real-time pharmacokinetic simulation
- Deviation tracking from planned doses
- Automatic correction suggestions
- Dual chart view (LDX, d-Amphetamine, or both)
- Advanced PK parameter configuration
- Multi-language support (English/German)
- Local storage persistence

## 📚 Documentation

See the [docs/](./docs) folder for detailed documentation:
- [Development Notes](./docs/README.dev-notes.md) - Setup and troubleshooting
- [Modular Structure](./docs/2025-10-18_MODULAR_STRUCTURE.md) - Architecture overview
- [Migration History](./docs/MIGRATION_HISTORY.md) - TypeScript & shadcn/ui migration
- [Dev Container Setup](./docs/README.devcontainer.md) - Linux/WSL2 docker configuration

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.

Third-party components and libraries used in this project are listed in [THIRD_PARTY_LICENSES.md](./THIRD_PARTY_LICENSES.md).