Looped - Habit Tracker

Build consistency, not just motivation. Looped is an offline-first Flutter habit tracker that helps you plan routines, stay accountable with alarms, and understand your progress through rich analytics.

Why Looped

Most habit apps stop at checklists. Looped adds accountability and resilience:

• Smart scheduling for daily, weekly, and custom routines
• Deadline alarms that ring until you stop them
• Streak freeze system to recover from occasional misses
• Visual analytics to highlight consistency trends
• Clean, modern UI with light, dark, and system themes
• Fully local data storage for speed and privacy

Core Features

• Habit creation with name, description, category, frequency, reminders, and deadlines
• Category filtering for Health, Growth, Mindset, Work, and more
• Reorder habits with drag-and-drop
• Swipe-to-delete with quick feedback
• Daily progress metrics on the home screen
• Analytics dashboards including:
  • Weekly bar charts
  • Category donut chart
  • Heatmap calendar
  • Streak leaderboard
  • Best-day insights
• Onboarding flow for first-time users
• JSON data export and full reset from settings
• Alarm reliability helpers:
  • Exact alarm permission checks
  • Battery optimization exemption flow
  • App settings deep link

Tech Stack

• Flutter
• Dart
• Riverpod
• Hive
• SharedPreferences
• Flutter Local Notifications
• Android Alarm Manager Plus
• FL Chart

Project Structure

• lib/main.dart app bootstrap, initialization, routing
• lib/core services, constants, themes, alarm prompt logic
• lib/features/habits habit domain, providers, screens, widgets
• lib/features/analytics analytics providers and visual components
• lib/features/onboarding first-run onboarding flow
• lib/features/settings preferences, data tools, permission actions

Getting Started

1) Prerequisites

• Flutter SDK installed
• Android Studio or VS Code with Flutter extension
• Android emulator or physical device

2) Install dependencies

Run:

flutter pub get

3) Generate model adapters (if needed)

Run:

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

4) Launch the app

Run:

flutter run

Android Notes

For deadline alarms to work reliably, allow:

• Exact alarms permission
• Ignore battery optimizations

You can enable both from the in-app Settings screen.

Data and Privacy

• Data is stored locally on device using Hive
• No remote sync is required for core functionality
• Export tool available in Settings for backup

Roadmap Ideas

• Cloud sync and account support
• Habit templates
• Smarter nudges and adaptive reminders
• Monthly challenge mode
• Advanced streak insights

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

• Bug report: use the issue template in GitHub Issues
• Feature request: use the issue template in GitHub Issues
• Security issue: follow SECURITY.md and do not post secrets publicly

License

This project is licensed under the MIT License. See LICENSE.

Community

• Contribution guide: CONTRIBUTING.md
• Code of conduct: CODE_OF_CONDUCT.md
• Security policy: SECURITY.md
• Support: SUPPORT.md