💊 Pills Reminder

A modern medication reminder app built with Flutter, following Clean Architecture principles. It leverages GetX for scalable state management, Hive for lightning-fast local storage, and Flutter Local Notifications for precise scheduling.

---

🧠 Architecture

This project uses the Clean Architecture pattern to separate concerns and ensure scalability.

lib/
├── core/               # Common utilities and services
├── features/           # Feature-based modules
│   ├── data/           # Data sources, models, Repositories implementations, and Hive integration
│   ├── domain/         # Entities and abstract definitions
│   └── presentation/   # UI, GetX controllers, and bindings
├── main.dart           # App entry point

---

🚀 Features

• ⏰ Schedule custom medication reminders
• 📅 Supports one-time, daily, or weekly notifications
• 🎯 Notifications Persistence to never miss your pills
• 🧠 Clean architecture & GetX-based controllers
• ⚡ Blazing fast local storage with Hive
• 🔔 Precise local notifications using Flutter Local Notifications
• 🦾 Notification Actions to make life easier
• 📱 Full English and Arabic Translations
• 🌗 Dark & light theme support
• ✅ Offline-first experience

---

📱 Screenshots

Light Mode	Dark Mode

---

🛠️ Tech Stack

Tech	Role
Flutter	UI Framework
GetX	State Management + Dependency Injection
Hive	NoSQL Local Storage
Flutter Local Notifications	Scheduling & displaying reminders
Custom Widgets	Fully reusable UI components

---

📦 Packages Used

dependencies:
  get: ^4.7.2
  hive_ce_flutter: ^2.3.1
  path_provider: ^2.1.5
  flutter_local_notifications: ^19.4.0
  timezone: ^0.10.1
  flutter_timezone: ^4.1.1
  permission_handler: ^12.0.1

---

▶️ Getting Started

1. Clone the repo

   git clone https://github.com/MoazSalem/Flutter_Pills_Reminder.git
   cd pills_reminder

2. Install dependencies

   flutter pub get

3. Generate Hive Type Adapters (if needed)

   flutter packages pub run build_runner build --delete-conflicting-outputs

4. Run the app

   flutter run

---

🧠 Project Philosophy

• ✅ Clean: Every layer has its own responsibility
• ⚙️ Modular: Easy to extend and maintain
• ⚡ Performant: Lightweight and fast, even on low-end devices

---

📦 Releases

You can download the latest APK builds from the Releases section.

---

🤝 Contributing

Feel free to fork the project and open PRs! Whether it’s a bug fix, UI enhancement, or feature suggestion — contributions are welcome.

---

🧾 License

MIT License © 2025 Moaz Salem

---

⭐ Show Your Support

If you like this project:

• ⭐ Star the repo
• 🐛 Submit issues or features
• 📢 Share with others

Feel free to suggest or request features via issues!

---