Health Tracker App

A modern, modular health‑tracking application built with Python and Flet.
It’s designed to manage medications, reminders, schedules, appointments, and user health data.
The architecture follows a clean separation of concerns with repositories, validators, services, and a background scheduler.

⭐ Features

💊 Medication Management

Add, edit, and view medications
Dosage tracking
Notes and status indicators

⏰ Scheduling and Reminders

Daily and weekly schedules
Custom reminder offsets
Automated reminder event generation
Background scheduler thread
UI notifications via Flet’s SnackBars

📅 Appointments

Create and manage appointments
Notes, location, date, and time

📈 Intake Logs

Track when medication was taken
Validation to ensure data integrity

👤 User Profile

Basic user information
Editable profile screen

⚙️ Settings

Toggle notifications
App preferences

📸 Screenshots

Dashboard

Appointments

Add Appointment

Edit Appointment

Medications

Schedules

Settings

Dark Mode

User Profile

Analytics Dashboard

🧱 Architecture Overview

The project is structured into clear, maintainable layers.

🎨 UI Layer (Flet Views)

Screens for medications, appointments, schedules, dashboard, settings, and more

📦 TypedPage

A custom subclass of ft.Page that acts as a dependency container

🗄 Repositories

Handle all database interactions

🛡 Validators

Ensure data integrity before saving

🔧 Services

Business logic for schedules, reminders, notifications, and intake logs

🧮 ScheduleEngine

Expands schedules into actual datetime events

🕒 SchedulerService

Background thread that checks for due reminders every minute

📂 Project Structure

health_app/
│
├── data/
├── models/
├── screens/
├── services/
├── validators/
├── ui_types/
├── main.py
└── README.md

🚀 Installation

1. Clone the repository

git clone https://github.com/reory/Health-Tracker-App.git
python -m venv venv
# windows
venv\Scripts\activate
# mac/linux
source venv/bin/activate

Run the App

pip install -r requirements.txt
python main.py

🗺 Roadmap

Planned enhancements and future improvements:

[ ] Add medication refill reminders
[ ] Add data export/import (JSON or CSV)
[ ] Add Analytics Integration (In Development): Utilizing Matplotlib and Numpy for health trend visualization
[ ] Add charts for intake history
[ ] Add cloud sync or optional online backup
[ ] Add multi‑user profiles - Using FAKER.
[ ] Add theme customisation (colour palettes)
[ ] Add optional biometric lock (Windows Hello / Touch ID)

🧪 Test File

A stripped‑down test file (test.py) is included for isolating UI behaviour.

Run the the Test Suite

pytest

🤝 Contributions

Contributions are welcome as always.

👤 Author — Roy Peters

Enjoy architecting clean, maintainable Python applications with clarity and purpose for everyone. Click here for contact details 😁