TimeWell is a comprehensive Flutter application designed to help users manage their time effectively, build healthy habits, track challenges, and stay organized with timers and a calendar.
- Visualize habit completion trends using beautiful charts.
- Powered by
syncfusion_flutter_charts. - Get daily motivational quotes to keep you going.
- Start structured challenges with daily projects.
- Create custom challenges by specifying a duration.
- Organize each day's projects with titles, descriptions, external links, and goals.
- Mark tasks as complete and monitor overall challenge progress.
- Data is stored persistently using
shared_preferences.
- Countdown timers with custom titles, notes, target dates, and repeat options.
- Built with
TimerNotifierandTimerModel.
- View upcoming challenges, events, and timers visually using a calendar (via
CalendarScreen).
- Customize preferences, including light/dark theme toggle.
| Technology | Use Case |
|---|---|
| Flutter | UI development |
| Riverpod | State management |
| shared_preferences | Local data persistence |
| url_launcher | Opening project external links |
| uuid | Generating unique IDs |
| intl | Date/time formatting |
| syncfusion_flutter_charts | Charting and visual analytics |
- Flutter SDK 3.x or higher
- Dart SDK (included with Flutter)
- Android Studio or Visual Studio Code
Clone the repository:
git clone https://github.com/Aman-byte1/time_well.git
cd time_wellInstall dependencies:
flutter pub getRun the app:
flutter runBuild the release APK:
flutter build apk --release --no-tree-shake-iconsUse the bottom navigation bar to access:
- Challenges
- Timeline (Timers)
- Calendar
- Settings
- Tap ➕ to create a challenge.
- Enter title, duration (in days), and start date.
- Tap on any day to add daily projects.
- Provide project title, description, goals, and external links.
- Mark completed tasks and track progress.
- Access from home or statistics tab.
- View pie or line charts of habit tracking.
- See your streaks and completions visually.
- View and manage countdowns under Timeline.
- Add new timers with custom name, notes, deadlines, and repetition.
- Customize the theme.
- Future: add notifications and reminder preferences.
Contributions are what make the open-source community amazing!
- Fork the repo
- Create your Feature Branch:
git checkout -b feature/AmazingFeature - Commit your changes:
git commit -m 'Add some AmazingFeature' - Push to the branch:
git push origin feature/AmazingFeature - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Amanuel Gizachew GitHub Project Repo: https://github.com/AmanuelGizachew/time_well
TimeWell helps you own your time and build your future — one challenge, habit, and minute at a time.
Let me know if you want help generating screenshots, badges, or auto-deployment instructions for GitHub Pages or Play Store later!