{"id":25501826,"url":"https://github.com/fluttersmith/breakschedule","last_synced_at":"2025-11-12T09:30:17.505Z","repository":{"id":275654379,"uuid":"926751649","full_name":"FlutterSmith/BreakSchedule","owner":"FlutterSmith","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-03T20:40:55.000Z","size":98,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-03T21:29:20.143Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FlutterSmith.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-03T19:51:20.000Z","updated_at":"2025-02-03T20:40:58.000Z","dependencies_parsed_at":"2025-02-03T21:40:59.908Z","dependency_job_id":null,"html_url":"https://github.com/FlutterSmith/BreakSchedule","commit_stats":null,"previous_names":["fluttersmith/breakschedule"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlutterSmith%2FBreakSchedule","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlutterSmith%2FBreakSchedule/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlutterSmith%2FBreakSchedule/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlutterSmith%2FBreakSchedule/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlutterSmith","download_url":"https://codeload.github.com/FlutterSmith/BreakSchedule/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239599019,"owners_count":19665911,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-19T04:58:57.164Z","updated_at":"2025-11-12T09:30:17.470Z","avatar_url":"https://github.com/FlutterSmith.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⏳ Break Reminder App\n\n📌 **Version:** 1.0.0  \n📅 **Last Updated:** 2, 2025  \n👤 **Author:** Ahmed Hamdy\n🔗 **Repository:** [GitHub Link](https://github.com/FlutterSmith/BreakSchedule)\n\n---\n\n## 📖 Overview\n\n**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.\n\n✅ **Custom Break Schedules**  \n✅ **Live Countdown Timer for Breaks**  \n✅ **Push Notifications for Reminders**  \n✅ **Random Wellbeing Tips \u0026 Animations**  \n✅ **Advanced Customizable UI with Themes**\n\n![Break Reminder App Demo](https://media.giphy.com/media/your-demo-url-here/giphy.gif)\n\n---\n\n## 🚀 Features\n\n### 📅 Schedule Configuration\n✔ **Customizable Break Length and Frequency:** Users can set their own break durations and intervals.  \n✔ **Preloaded Schedules:** Choose from readymade schedules (like Pomodoro) or create a custom schedule.\n\n### ⏰ Live Countdown Display\n✔ **Real-Time Timer:** The countdown screen updates in real‑time, showing days, hours, minutes, and seconds until the break ends.\n\n### 🔔 Push Notifications\n✔ **Scheduled Reminders:** Receive notifications to start and end your break sessions.\n\n### 🌟 Wellbeing Tips\n✔ **Random Tips:** Each break session displays a random wellbeing tip (e.g., stretch, hydrate, relax your eyes).  \n✔ **Animated Visuals:** Enjoy simple animations (via Lottie) to enhance your break experience.\n\n### 🎨 Advanced UI \u0026 Theming\n✔ **Custom Themes:** Switch between light and dark modes, with a modern and responsive UI.\n\n---\n\n## 🛠️ Tech Stack\n\n| Technology                         | Purpose                                               |\n|------------------------------------|-------------------------------------------------------|\n| **Flutter**                        | Cross‑platform mobile development                     |\n| **Dart**                           | Primary programming language                          |\n| **BloC Pattern**                   | State management and modular architecture             |\n| **flutter_local_notifications**    | Scheduling and managing push notifications            |\n| **Provider**                       | Dependency injection and data sharing                 |\n| **Lottie**                         | Displaying engaging animations                        |\n| **sqflite**                        | Local persistence (if needed)                         |\n\n---\n\n## 🚀 Installation\n\n### 📌 Prerequisites\n- ✅ **Flutter SDK** (Latest stable version)  \n- ✅ **Dart SDK** (Bundled with Flutter)  \n- ✅ **Android Studio / VS Code** (With Flutter extensions)\n\n### 📦 Steps to Run\n\n1️⃣ **Clone the Repository**  \n```\ngit clone https://github.com/yourusername/break_reminder_app.git\ncd break_reminder_app\n```\n2️⃣ Install Dependencies\n```\nflutter pub get\n```\n3️⃣ Run the App\nFor mobile devices:\n```\nflutter run\n```\nFor desktop (Windows, Linux, macOS):\n```\nflutter run -d windows   # or -d linux, -d macos as applicable\n\n```\n\n📌 Future Improvements\n✅ Integration with calendar events\n✅ Cloud synchronization for break schedules\n✅ Advanced customization (e.g., custom notification sounds, additional themes)\n✅ Support for multiple languages (localization)\n✅ Interactive wellbeing exercises\n\n🏆 Contributors\n👤 Your Name\nGitHub: FlutterSmith\n\n\n📝 License\nThis project is licensed under the MIT License. See the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffluttersmith%2Fbreakschedule","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffluttersmith%2Fbreakschedule","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffluttersmith%2Fbreakschedule/lists"}