📌 Version: 1.0.0
📅 Last Updated: 2, 2025
👤 Author: Ahmed Hamdy
🔗 Repository: GitHub Link
Break Reminder App is a robust Flutter application designed to help users maintain productivity by reminding them to take regular breaks. Users can configure their preferred break duration, frequency, and notification type. With a modern, advanced UI and customizable options, the app provides live countdown timers for break sessions, displays random wellbeing tips, and supports push notifications to alert users when it’s time to take a break.
✅ Custom Break Schedules
✅ Live Countdown Timer for Breaks
✅ Push Notifications for Reminders
✅ Random Wellbeing Tips & Animations
✅ Advanced Customizable UI with Themes
✔ Customizable Break Length and Frequency: Users can set their own break durations and intervals.
✔ Preloaded Schedules: Choose from readymade schedules (like Pomodoro) or create a custom schedule.
✔ Real-Time Timer: The countdown screen updates in real‑time, showing days, hours, minutes, and seconds until the break ends.
✔ Scheduled Reminders: Receive notifications to start and end your break sessions.
✔ Random Tips: Each break session displays a random wellbeing tip (e.g., stretch, hydrate, relax your eyes).
✔ Animated Visuals: Enjoy simple animations (via Lottie) to enhance your break experience.
✔ Custom Themes: Switch between light and dark modes, with a modern and responsive UI.
| Technology | Purpose |
|---|---|
| Flutter | Cross‑platform mobile development |
| Dart | Primary programming language |
| BloC Pattern | State management and modular architecture |
| flutter_local_notifications | Scheduling and managing push notifications |
| Provider | Dependency injection and data sharing |
| Lottie | Displaying engaging animations |
| sqflite | Local persistence (if needed) |
- ✅ Flutter SDK (Latest stable version)
- ✅ Dart SDK (Bundled with Flutter)
- ✅ Android Studio / VS Code (With Flutter extensions)
1️⃣ Clone the Repository
git clone https://github.com/yourusername/break_reminder_app.git
cd break_reminder_app
2️⃣ Install Dependencies
flutter pub get
3️⃣ Run the App For mobile devices:
flutter run
For desktop (Windows, Linux, macOS):
flutter run -d windows # or -d linux, -d macos as applicable
📌 Future Improvements ✅ Integration with calendar events ✅ Cloud synchronization for break schedules ✅ Advanced customization (e.g., custom notification sounds, additional themes) ✅ Support for multiple languages (localization) ✅ Interactive wellbeing exercises
🏆 Contributors 👤 Your Name GitHub: FlutterSmith
📝 License This project is licensed under the MIT License. See the LICENSE file for details.