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
# 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/ folder for detailed documentation:
- Development Notes - Setup and troubleshooting
- Modular Structure - Architecture overview
- Migration History - TypeScript & shadcn/ui migration
- Dev Container Setup - Linux/WSL2 docker configuration
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Third-party components and libraries used in this project are listed in THIRD_PARTY_LICENSES.md.