An accessible, open-source medication management ecosystem designed for patients and caregivers. Dosezy pairs a 100% offline-first, private mobile client with an optional self-hostable Caregiver Cloud for family sync, clinical adherence analytics, and remote care. Built with accessibility at its core: high-contrast visuals, tremor-friendly touch targets, and reliable alarms for elderly users and families managing complex prescriptions.
π‘ Note: Some stores (such as F-Droid, etc.) may take a few days (usually 2-5 days) to review and publish new releases. For immediate access to the latest updates, download directly from GitHub Releases. Also, if you sideload apps from GitHub, APKMirror etc., check out ObtainX. It handles all the updates automatically so you don't have to keep checking the sites manually: https://bikram-agarwal.github.io/obtainx/
- coming soon
Dosezy transforms daily medication management into a stress-free experience. Input your medicines, dosages, and schedules, and Dosezy handles the restβwith large, high-contrast visuals, reliable alarms, and total privacy.
- π Critical Full-Screen Alarms β High-visibility alarm screen rings reliably even when your phone is in deep sleep or silent mode. Intercept with physical volume keys to instantly silence audio, or snooze safely with a back gesture.
- π΅ Custom Sounds & Dynamic Snooze β Choose from gentle built-in alert tones or your own device ringtones with in-app audio previews, dedicated alarm volume controls, and customizable snooze intervals (5, 10, 15, 20, or 30 minutes).
- π¦ Pill Inventory & Low-Stock Warnings β Real-time stock tracking with automatic deduction on intake. Configurable low-stock alerts notify you well before running out of essential medications.
- π Dosezy Pharmacy Refill Order β Instantly compile formatted prescription refill orders for 15, 30, 60, or 90 days from active inventory or low-stock filters with multi-profile consolidation and smart bottle supply calculations for eye drops. Preview your order with live WhatsApp markdown formatting, then tap to Share via Chat or copy to clipboard.
- π Manually Record Dose Time β Easily record the actual time you took medications when logging doses later to maintain accurate adherence histories.
- π Crossing Time Zones (Doses Shift With You) β Traveling across time zones? Dosezy automatically keeps your reminders anchored to your local daily routine without time distortion.
- π§ Customizable Bottom Navigation β Toggle to hide the central '+' button for a clean, symmetrical 4-tab layout, placing an "Add Medicine" button directly below active medications on the Medicines screen.
- β©οΈ Configurable Dose Undo & Protection β Made a mistake? Revert accidental dose taps from the reminder bar or dose card, backed by a safety confirmation dialog so your tablet stock and adherence records are never reset by accident.
- βοΈ Per-Dose Notes & Symptom Logging β Keep track of meals and how you feel. Attach notes, meal context ("With food"), or side effects when logging a dose with quick-tap suggestions, and view or edit notes anytime from your dose cards or calendar.
- βΈοΈ Clinical Dose Skipping β Safely pause doses with required clinical explanations (Doctor advised pause, Adverse reaction, Fasting, Illness, Ran out of medicine) without penalizing your adherence streak.
- π 12-First Grid Time Picker β Visual, tremor-friendly grid time selector that places 12 at the top for natural morning/night scheduling, avoiding frustrating circular clock dials.
- π Interactive Schedule Calendar β Day, week, and month calendar views with color-coded compliance dots (taken, late, missed, skipped) and full TalkBack screen reader accessibility for visually impaired users.
- π Adherence Analytics & Compliance Scores β Multi-ring progress tracking across Today, 7 Days, 30 Days, 90 Days, and All-Time, plus individual medication compliance rates to keep you and your doctor informed.
- π Real-Time Medicine Search β Rapidly find and filter prescriptions in large medicine rosters by name or instruction with instant empty-state guidance.
- π Discontinued Medications Archive β Neatly archives stopped medications into an expandable accordion at the bottom of the Medicines screen, preserving all past adherence history while keeping active prescriptions clutter-free.
- π₯ Multi-Family Profiles β Manage medications for parents, children, or partners on one device with separate medicines, schedules, stock counts, personal emergency contacts, and 5-second deletion countdown safeguards.
- π Doctor PDF Reports & Data Exports β Generate clean, print-ready adherence summary reports for medical appointments, or export JSON backups and CSV spreadsheets anytime.
- π Full Encrypted ZIP Backups & Selective Restore β Export complete encrypted archives. Restore individual profiles with intelligent conflict resolution (Merge Data, Overwrite, or Create New Profile).
- π¨ Emergency Services & Personal Contacts β 1-tap dialing for national emergency numbers across 10 regions (auto-detected via SIM/locale), plus dedicated personal doctor and family emergency contacts per profile.
- π¨ Accessibility & Visual Customization β Large touch targets, presbyopia-safe 7.8:1 high-contrast typography, 8 customizable pill shapes, 10 palette colors, and adaptive System Dark/Light themes.
- π 12 Native Languages β Fully translated across all screens, notifications, alarms, and settings in English, Spanish, Hindi, Chinese, Portuguese, Arabic, French, German, Japanese, Russian, Italian, and Bengali.
- π‘οΈ Notification Reliability Shield β Built-in diagnostic assistant that checks exact alarm permissions and battery optimization, providing 1-tap device setup guides (Samsung, Xiaomi, OnePlus, etc.) so alarms never fail.
- π 100% Private & Offline β No account creation, no sign-ups, and no internet permissions. All health data is encrypted and stays strictly on your phone.
- coming soon
| Module | Platform | Status | Min / Target | Tech Stack |
|---|---|---|---|---|
| π± Patient App | Android | Released (v2.5.7) | Android 7.0+ (API 24+) | Kotlin, Jetpack Compose, Room |
| π Patient App | iOS | Planned | iOS 16+ | Swift, SwiftUI, SwiftData |
| βοΈ Server Node | Server / API | In Development | Docker / Self-Host | Node.js, Fastify, TypeScript, SQLite/Postgres |
| π©Ί Caregiver Portal | Web | In Development | Modern Browsers | Astro, TypeScript, Tailwind |
- Language: Kotlin
- UI Framework: Jetpack Compose
- Build System: Gradle (Kotlin DSL)
- Storage & Data: Room Database, DataStore, SharedPreferences, File-based storage
- coming soon
- Fork the repo.
- Download & Install Android Studio
- Enable Git Version Control & Clone the Repo
- Navigate to
/patient/android - Wait for gradle to initialize
- Enjoy.
Dosezy is architected as an open-source, local-first monorepo with an optional connected cloud layer:
"Dosezy Cloud enhances Dosezy, never holds Dosezy hostage."
flowchart TB
subgraph Clients["π± Patient Client Applications (100% Local-First & Offline)"]
direction LR
AndroidApp["Android App<br>(patient/android)"]
iOSApp["iOS App<br>(patient/ios)"]
end
subgraph ServerCloud["βοΈ Cloud & Sync Platform (Optional & Self-Hostable)"]
direction LR
SyncServer["Self-Hostable Sync Server<br>(server/)"]
ContractNote["π Shared OpenAPI 3.0 Contract (api/openapi.yaml)<br><i>Defines REST APIs, data schemas, and sync protocols.</i>"]
end
subgraph s1["π Website"]
MarketingWeb["Web Portal, Guides & Manuals<br>(website/)"]
end
subgraph s2["β€οΈ Caregiver Client Applications"]
CaregiverWeb["Caregiver Web Dashboard<br>(caregiver/)"]
end
iOSApp <== "Optional Encrypted Sync" ==> ContractNote
AndroidApp <== "Optional Encrypted Sync" ==> ContractNote
SyncServer <--> CaregiverWeb
ContractNote -- "Validates REST & Sync API" --> SyncServer
ContractNote@{ shape: hex}
style ContractNote stroke-width:2px,stroke-dasharray: 2
- 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.
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/ # Astro marketing and documentation web app (Astro, TypeScript & Tailwind CSS)
βββ CONTRIBUTING.md # Contribution guidelines and coding standards
βββ LICENSE # Open-source MIT License
βββ README.md # Master project documentation
| Phase / Version | Milestone | Focus Areas | Key Deliverables | Status |
|---|---|---|---|---|
| v1.0 β v2.5 | Local-First Android Client & Schema Parity | Core Adherence & Ecosystem Parity | Jetpack Compose UI, 12 native localizations, Room offline database v15, time zone travel, manual dose recording, per-dose symptom notes, dose undo confirmation, pharmacy refill orders with smart bottle supplies, full-screen alarms, emergency dialer, shared OpenAPI 3.0 contract. | π’ Released (v2.5.7) |
| v3.0 β v3.9 | Self-Hostable Backend & Caregiver Platform | Incremental Sync & Web Portal | Open-source server (server/), PostgreSQL DB, conflict-free sync engine, offline mutation queues, optional cloud connection, dedicated Caregiver web portal (caregiver/ at app.dosezy.com), remote adherence monitoring, patient-controlled granular sharing permissions. |
β³ Planned |
| v4.0 | Native iOS Patient Client | Multi-Platform Expansion | Native Swift & SwiftUI app (patient/ios/), SwiftData/CoreData local database, Apple UserNotifications, zero-account local operation. |
β³ Planned |
Home Screen
|
Schedule Screen
|
Medicines Screen
|
Add New Medicine Screen
|
Menu List Screen
|
Notification Status Dialog
|
Profile Actions Dialog
|
Data Export Feature
|
Preferences Setting
|
Dosezy is 100% free, open-source, and private with zero ads or telemetry. If Dosezy helps you or your family stay healthy, consider supporting ongoing development:
- GitHub Sponsors: Sponsor @saad2134
- Buy Me a Coffee: buymeacoffee.com/saad2134
- In-app crypto wallet options (BTC, ETH, SOL, LTC, ZEC) are also available under Menu > About Dosezy.
This project is licensed under the MIT License - see the LICENSE file for details.
- β Commercial use
- β Modification
- β Distribution
- β Private use
- β Liability
- β Warranty
Developed and published by Saad (@saad2134).
β Star this repo if you found it helpful! Thanks for reading.
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 astro
For full release notes, version history, and detailed changes, please see the Documentation Changelogs or GitHub Releases.








