🚨 A smart medicine tracking app that is free, open source, offline and private by default with coming soon, optional Caregiver Cloud Platform for analytics, multi-device sync and family sharing. Dosezy transforms medication management into a simple, stress-free experience. Built with accessibility at its core, the app features clear, large text and intuitive navigation: perfect for elderly users and anyone managing multiple prescriptions.

🛍️ Download Now

💊 Patient App (Free, Open-source, Offline & Private by Default)

Coming Soon On

🩺 Caregiver Cloud Platform (Optional, Self-Hostable, Coming Soon)

• coming soon

✨ Features

💊 Patient App (Free, Open-source, Offline & Private by Default)

Once you input the basics: name, dosage, timings, and frequency, the app intelligently handles your medication schedule.

• 📅 Medication Adherence – Automated reminders ensure timely medication consumption.
• 🌐 12 Global Languages – Full native localization in English, Chinese (中文), Spanish (Español), Hindi (हिन्दी), Portuguese (Português), Arabic (العربية), French (Français), German (Deutsch), Japanese (日本語), Russian (Русский), Italian (Italiano), and Bengali (বাংলা).
• 🌍 International Emergency Services – Interactive country/region emergency dialer supporting India, USA/Canada, UK, EU, China, Japan, Russia, Brazil, Bangladesh, and Australia with automatic country detection based on language.
• ⏰ Configurable Late & Missed Thresholds – Custom Consider Late After (1-3h) and Consider Missed After (3-9h) settings with orange high-visibility late status badges (Xh Xm ago) and "Mark Late" actions.
• 🕒 12-First Grid Time Picker – Easy 12-hour (12 first layout) and 24-hour interactive grid time selector with quick minute chips.
• ♿ Accessibility-First Design – Large text, high-contrast colors, and simple controls for elderly users.
• 🔔 Reliable Notification System – Persistent alerts with precise battery & sound indicators and snooze/taken/late action triggers.
• 🎨 Adaptive System Dark/Light Theme – Complete theme support respecting the Android system default settings with zero white flash transitions.
• 📅 Custom Calendar Scheduling – Full interactive support for daily, weekly (specific days of the week), and monthly (specific days of the month) frequencies.
• 👤 Multi-Profile Management – Create, edit, and switch between family member profiles.
• 📄 Data Security & Export – Local Room database storage with PDF report and JSON data export capabilities.
• 👨‍👩‍👧 Caregiver Support – Logs and adherence history help caregivers track missed and late doses.

🩺 Caregiver Cloud Platform (Optional, Self-Hostable, Coming Soon)

• coming soon

---

⚙️ Platforms

Patient App

Platform	Min Version	Supported?
Android	v7.0 or later	✅
iOS	Coming Soon	⏳

🛠️ Tech Stack

Patient App (Android)

• Language: Kotlin
• UI Framework: Jetpack Compose
• Build System: Gradle (Kotlin DSL)
• Storage & Data: Room Database, DataStore, SharedPreferences, File-based storage

Caregiver Cloud Platform (Self-Hostable, Coming Soon)

• coming soon

🚀 Getting Started (Working on Source Code)

Patient App (Android)

1. Fork the repo.
2. Download & Install Android Studio
3. Enable Git Version Control & Clone the Repo
4. Navigate to /patient/android
5. Wait for gradle to initialize
6. Enjoy.

🏛️ Core Philosophy & Product Architecture

Dosezy is architected as an open-source, local-first monorepo with an optional connected cloud layer:

"Dosezy Cloud enhances Dosezy, never holds Dosezy hostage."

                         ┌─────────────────────────────────────────────────────────────┐
                         │                       DOSEZY MONOREPO                       │
                         └──────────────────────────────┬──────────────────────────────┘
                                                        │
           ┌─────────────────────────────┬──────────────┴──────────────┬─────────────────────────────┐
           │                             │                             │                             │
┌──────────┴──────────┐       ┌──────────┴──────────┐       ┌──────────┴──────────┐       ┌──────────┴──────────┐
│   PATIENT CLIENTS   │       │   OPENAPI SCHEMAS   │       │   CAREGIVER & WEB   │       │   SYNC SERVER & API │
│ (100% Local-First)  │       │  (Shared Contract)  │       │ (Connected Portal)  │       │ (Self-Hostable Core)│
├─────────────────────┤       ├─────────────────────┤       ├─────────────────────┤       ├─────────────────────┤
│ patient/android/    │       │ api/openapi.yaml    │       │ caregiver/          │       │ server/             │
│ patient/ios/        │       │ docs/               │       │ website/            │       │ • Incremental Sync  │
│ • Offline Room DB   │       │ • Domain Models     │       │ • Web Dashboard     │       │ • Multi-Device Sync │
│ • 12 Localizations  │       │ • DTO Definitions   │       │ • Adherence Monitor │       │ • PostgreSQL        │
│ • High-Contrast UI  │       │ • Sync Protocol     │       │ • Next.js Website   │       │ • Zero-Telemetry    │
└─────────────────────┘       └─────────────────────┘       └─────────────────────┘       └─────────────────────┘

• Local-First by Default: All fundamental features—scheduling, persistent notifications, history tracking, data exports, and emergency services—operate completely offline without requiring an account or network connectivity.
• Server-Agnostic Sync: The app supports both the official hosted service (cloud.dosezy.app) and Self-Hostable community servers (server/).
• Contract-Driven Development: Client apps (patient/android, patient/ios, caregiver/) conform to a shared OpenAPI specification (api/openapi.yaml), ensuring consistent data models and seamless interoperability.

📁 Monorepo Architecture

dosezy/
├── .github/                  # CI/CD workflows, build pipelines, and repository automation
├── api/                      # OpenAPI 3.0 contract (openapi.yaml) defining shared client/server schemas
├── caregiver/                # Caregiver companion application & web dashboard (app.dosezy.com)
├── docs/                     # Architecture Decision Records (ADRs), domain specifications, and guides
│   ├── architecture/         # Data layer, sync protocols, and encryption designs
│   ├── privacy/              # Data safety declarations and health privacy compliance
│   └── product/              # Product specs, wireframes, and accessibility requirements
├── patient/                  # Patient application modules
│   ├── android/              # Native Android patient app (Jetpack Compose & Kotlin)
│   │   ├── app/              # Source code, UI components, Room DB, and background services
│   │   ├── assets/           # App branding artwork and density icons
│   │   ├── fastlane/         # F-Droid & store metadata and localized changelogs
│   │   ├── gradle/           # Build wrappers and version catalogs
│   │   └── ui/               # Interactive prototyping templates and wireframes
│   └── ios/                  # (Roadmap) Native iOS patient app (SwiftUI & Swift)
├── resources/                # Offline user documentation, FAQs, and support manuals
│   ├── FAQs.md
│   └── UserManual.md
├── scripts/                  # Code generation, release packaging, and translation sync automation
├── server/                   # Open-source self-hostable sync server (PostgreSQL + REST API)
├── website/                  # Next.js marketing and landing page web app (React 19 & Tailwind CSS v4)
├── CONTRIBUTING.md           # Contribution guidelines and coding standards
├── LICENSE                   # Open-source MIT License
└── README.md                 # Master project documentation

🗺️ Product Roadmap

Phase / Version	Milestone	Focus Areas	Key Deliverables	Status
v1.0 – v2.1	Local-First Android Client	Core Medication Adherence	Jetpack Compose UI, 12 native localizations, Room offline database, customizable late/missed thresholds, full-screen alarms, emergency dialer, zero account barrier.	🟢 Released
v2.5	Domain & API Contract	Schema & Boundary Decoupling	Canonical domain models (Medication, Schedule, DoseEvent), api/openapi.yaml OpenAPI 3.0 specification, multi-platform client generation.	🟡 In Design
v3.0	Self-Hostable Backend & Sync	Incremental Cloud Sync	Open-source server (server/), PostgreSQL DB, conflict-free sync engine, offline mutation queues, optional cloud connection.	⏳ Planned
v3.5	Native iOS Patient Client	Multi-Platform Expansion	Native Swift & SwiftUI app (patient/ios/), SwiftData/CoreData local database, Apple UserNotifications, zero-account local operation.	⏳ Planned
v4.0	Caregiver Cloud Platform	Connected Family Care	Dedicated Caregiver web portal (caregiver/ at app.dosezy.com), remote adherence monitoring, patient-controlled granular sharing permissions.	⏳ Planned

📱 Screenshots

Patient App

Home Screen	Schedule Screen	Medicines Screen
Add New Medicine Screen	Menu List Screen	Notification Status Dialog
Profile Actions Dialog	Data Export Feature	Preferences Setting

---

📊 Project Stats

🖼️ App Icon

🔰 Banner

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

• ✅ Commercial use
• ✅ Modification
• ✅ Distribution
• ✅ Private use
• ❌ Liability
• ❌ Warranty

---

👤 Publisher

Developed and published by Saad (@saad2134).

---

✍️ Endnote

⭐ Star this repo if you found it helpful! Thanks for reading.

---

🏷 Tags

android ios swiftui jetpack-compose kotlin open-source local-first offline-first medicine-reminder medicine-management medication-adherence caregiver elderly-care health-tech self-hosted dosezy nextjs