# HabitFlow — AI-Powered Habit Tracker

## What is HabitFlow?
HabitFlow is a free, privacy-first mobile app for iOS and Android that helps people build and maintain daily habits using visual tracking, streak motivation, and an AI personal coach.

## Core Features
- **Habit tracking**: Create unlimited custom habits or pick from 6 preset templates (Exercise, Sleep, Reading, Meditation, Water, Journaling).
- **Streaks & contribution grids**: GitHub-style 90-day contribution grid and streak counters motivate consistency.
- **AI Coach**: Powered by Meta Llama 3.3 70B via OpenRouter. Gives personalized daily suggestions based on your habit patterns. Requires explicit user consent; no personal identity is shared.
- **Analytics**: Completion rates, longest streaks, 90-day history, all visualized.
- **Privacy-first**: All habit data is stored locally on the user's device. Nothing is sent to the cloud unless the user opts in to AI coaching.
- **17 languages**: English, French, German, Dutch, Italian, Spanish, Chinese (Simplified), Russian, Arabic, Portuguese, Swedish, Japanese, Swahili, Indonesian, Lingala, Thai, Vietnamese.
- **No ads, no tracking**: HabitFlow never shows ads and does not track users.
- **Dark mode**: Default dark interface with a blue (#3B82F6) primary accent.

## Pricing
- **Free tier**: 4-day full-featured trial, no credit card required.
- **Pro plan**: $6 USD per month. Includes unlimited habits, full analytics history, forever data retention, and priority AI coaching.
- Subscriptions are managed through Apple App Store or Google Play. Cancel anytime.

## How It Works (Step-by-Step)
1. Download HabitFlow free from the App Store or Google Play.
2. Sign up with just an email address — no password required. 4-day free trial starts immediately.
3. Add habits using templates or custom names and colors.
4. Check in daily with a single tap. Streaks and grids update automatically.
5. View analytics to track progress over 90 days.
6. Optionally enable the AI Coach for personalized habit improvement tips.

## Privacy & Compliance
- Habit data stored on-device (AsyncStorage).
- AI coaching requires explicit opt-in (Apple App Store policy 5.1.1(i) compliant).
- Account deletion available in Settings with double confirmation (Apple 5.1.1(v) compliant).
- Privacy Policy: https://www.habitflowmo.app/privacy
- Terms of Service: https://www.habitflowmo.app/terms

## Technical Stack
- Frontend: Expo (React Native) — iOS and Android
- Backend: Express.js with TypeScript
- AI: Meta Llama 3.3 70B via OpenRouter
- Payments: Stripe (primary), Paddle, PayPal, BTCPay (Bitcoin)
- Database: PostgreSQL (backend), AsyncStorage (on-device)

## Frequently Asked Questions
**Is HabitFlow free?**
Yes. HabitFlow offers a full 4-day free trial with no credit card required. After the trial, Pro is $6/month.

**How does the AI coach work?**
The AI Coach uses Meta Llama 3.3 70B to analyze your habit data and generate personalized suggestions. Your explicit consent is required before any data is sent. Your identity is never shared.

**Where is my data stored?**
All habit data is stored locally on your device. Nothing is uploaded to the cloud unless you opt in to AI coaching.

**Can I cancel my subscription?**
Yes. Cancel anytime through the App Store or Google Play subscription settings. No fees.

**How do I delete my account?**
Settings → Delete Account. Your account and all data are permanently deleted after double confirmation.

**What languages are supported?**
17 languages: English, French, German, Dutch, Italian, Spanish, Chinese (Simplified), Russian, Arabic, Portuguese, Swedish, Japanese, Swahili, Indonesian, Lingala, Thai, Vietnamese.

## Contact
- Support: support@habitflow.app
- Website: https://www.habitflowmo.app
- Privacy Policy: https://www.habitflowmo.app/privacy
- Terms of Service: https://www.habitflowmo.app/terms