Technical Quick Start¶

This guide is for developers and advanced users who want to run the full MedTracker stack locally using Docker.

Prerequisites¶

Before you begin, make sure you have these tools installed: - Docker and Docker Compose - Task (the task runner for this project) - Portless (npm install -g portless, then run portless trust once) - Git

1. Clone the project¶

git clone https://github.com/damacus/med-tracker.git
cd med-tracker

2. Start development services¶

Run this command to start the database, web server, and worker:

task dev:portless

This starts the dev profile from compose.yaml and registers the stable local URL https://med-tracker.localhost.

3. Seed development data¶

To quickly populate the database with example users, people, and medicines:

task dev:seed

Local development only: fixture data includes sample accounts with known passwords. Do not expose a seeded development stack to a public or shared network, and remove or reset sample accounts before using any real records.

4. Open the app¶

The MedTracker UI is available at:

👉 https://med-tracker.localhost

Day-to-Day Development Commands¶

Command	Action
`task dev:logs`	View real-time application logs
`task dev:stop`	Stop all development containers
`task dev:ps`	List running containers
`task test`	Run the full test suite in Docker

Troubleshooting¶

Rebuild from scratch¶

If you encounter database issues or want to start fresh:

task dev:rebuild

Warning: This removes all data and recreates the database.

Database migrations¶

To apply new database changes without a full rebuild:

task dev:db-migrate