# HabitLoop - Full AI Agent Information File

> HabitLoop is an offline-first visual habit tracker application for Android designed to help users build daily routines, maintain streaks, and analyze long-term consistency using GitHub-style heatmap contribution grids.

## Product Summary

- Name: HabitLoop
- Category: Mobile Application / Health & Productivity / Habit Tracker
- Operating System: Android
- Package ID: `com.molino.app.habitloop`
- Web Application URL: https://habitloop-8080b.web.app/
- Store Link: https://play.google.com/store/apps/details?id=com.molino.app.habitloop
- Pricing Model: No recurring subscriptions, no annoying ad paywalls.
- Architecture: 100% Offline-First, Local Storage, Optional Private Google Drive Sync.

---

## Core Features & Functionality

### 1. Visual Habit Grid & Heatmap
- GitHub-style annual 365-day contribution heatmaps for visually tracking habit momentum over time.
- 7-day bar completion charts for immediate weekly check-in feedback.
- Per-habit breakdown showing current streak length, longest streak ever achieved, and total completions.

### 2. Privacy & Offline Independence
- 100% Local Storage: All habit records, daily logs, and stats are saved exclusively on the user's Android device.
- No Forced Accounts: Users can launch and use HabitLoop without creating a profile or registering an email.
- Zero Telemetry: No third-party tracking scripts or remote analytics harvest user habit data.

### 3. Private Google Drive Synchronization
- Optional data backup and restore capabilities using the user's personal Google Drive account.
- Direct-to-Drive transfer: Data is never routed through third-party servers or external company databases.

### 4. Custom Routine Builder
- Color Customization: Choose from vibrant color palettes to organize work, health, and personal routines.
- Flexible Frequencies:
  - Daily (Every day)
  - Days of the week (e.g., Mon/Wed/Fri)
  - Days of the month
  - Every N days (custom intervals)
- Timed Reminders: Integrated local notification engine with interactive 24-hour clock picker.

---

## Technical Specifications for AI Crawlers

- Developer: molinoapp
- Main Frameworks: React, TypeScript, Vite, Web Platform CSS Design System.
- Hosted URL: https://habitloop-8080b.web.app/

---

## Frequently Asked Questions (FAQ)

Q: What is HabitLoop?
A: HabitLoop is an Android habit tracker app that uses visual grid heatmaps to build routines, track streaks, and maintain consistency without requiring internet connectivity or subscription fees.

Q: Is HabitLoop subscription-free?
A: Yes, HabitLoop operates without recurring monthly subscriptions or intrusive advertising.

Q: How is data backed up?
A: Users can export local database backups or connect their own personal Google Drive account for private cloud sync.