https://github.com/fluttersmith/breakschedule
https://github.com/fluttersmith/breakschedule
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/fluttersmith/breakschedule
- Owner: FlutterSmith
- Created: 2025-02-03T19:51:20.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-02-03T20:40:55.000Z (3 months ago)
- Last Synced: 2025-02-03T21:29:20.143Z (3 months ago)
- Language: Dart
- Size: 95.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ⏳ Break Reminder App
📌 **Version:** 1.0.0
📅 **Last Updated:** 2, 2025
👤 **Author:** Ahmed Hamdy
🔗 **Repository:** [GitHub Link](https://github.com/FlutterSmith/BreakSchedule)
---
## 📖 Overview
**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**
---
## 🚀 Features
### 📅 Schedule Configuration
✔ **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.
### ⏰ Live Countdown Display
✔ **Real-Time Timer:** The countdown screen updates in real‑time, showing days, hours, minutes, and seconds until the break ends.
### 🔔 Push Notifications
✔ **Scheduled Reminders:** Receive notifications to start and end your break sessions.
### 🌟 Wellbeing Tips
✔ **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.
### 🎨 Advanced UI & Theming
✔ **Custom Themes:** Switch between light and dark modes, with a modern and responsive UI.
---
## 🛠️ Tech Stack
| 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) |
---
## 🚀 Installation
### 📌 Prerequisites
- ✅ **Flutter SDK** (Latest stable version)
- ✅ **Dart SDK** (Bundled with Flutter)
- ✅ **Android Studio / VS Code** (With Flutter extensions)
### 📦 Steps to Run
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.