HabitFlow is a daily habit tracker and task manager that helps you build better habits and get things done, one day at a time. It runs entirely in your browser as a Progressive Web App (PWA), with all data stored locally on your device — nothing is sent to any server.

HabitFlow combines habit tracking with a full-featured task manager, analytics dashboard, achievement system, and daily planning ritual — all in a single, fast, offline-capable app.

You can install HabitFlow to your home screen on any device for a native app experience. On iOS, use Safari's "Add to Home Screen" option. On Android, tap the install prompt or use Chrome's menu.

When you open HabitFlow, you'll see your Today dashboard. Here's what each element does:

• Header — Shows the current date and a time progress widget. Tap the time widget to cycle through day, week, month, and year progress views.
• Stats Bar — Four cards showing Total Habits, Done Today, Best Streak, and Completion Rate at a glance.
• Progress Ring — A visual ring showing your daily completion percentage, along with a motivational message and an optional daily quote.
• Rate Your Day — A 1–10 wellness slider to track how your day is going. This data feeds into your analytics charts and helps Focus Mode recommend tasks that match your current energy level.
• Today's Habits — Your habit checklist for the day, automatically sorted with incomplete habits first and completed habits at the bottom.
• Weekly Review — Appears every Sunday with a summary of your past week's performance, including completion rate, best habit, habits needing attention, and average wellness score.
• Quick Stats Widget — A compact bar showing how many habits are left today, how many are done, and your current best streak.
• Vacation Banner — When Vacation Mode is active, a banner appears at the top letting you know habits are paused and giving you a button to end vacation.

Tap the + button in the bottom-right corner (or press N on desktop) to create a new habit. You can configure:

• Name & Description — What the habit is and optional details (e.g., "Morning Meditation" / "10 minutes of mindfulness").
• Habit Type — Choose from three types:
  • ✅ Simple Check — Tap to mark as done. Best for yes/no habits like "Exercise" or "Journal."
  • 🔢 Counter — Track quantities with a target (e.g., "8 cups of water"). Choose between a bubble display (tap individual bubbles) or +/- button display.
  • ⏱️ Timer — Track duration with a built-in start/pause/reset timer (e.g., "10 min meditation"). Auto-completes when the goal duration is reached.
• Icon & Color — Pick from 24 emoji icons and 8 colors to personalize each habit card.
• Category — Health, Mindfulness, Productivity, Learning, Social, Creativity, Finance, Self-Care, or Other.
• Frequency — Every Day, Weekdays, Weekends, 3x/Week, X Per Week (choose any number of days per week), or Custom (select specific days).
• Reminder Time — Optional time-based push notification reminder (requires notifications to be enabled in Settings).

Completing Habits:

• Simple Check — Tap the habit card or swipe right to complete. Tap again to undo.
• Counter — Tap individual bubbles or use +/- buttons to increment toward your target. Auto-completes when the target is reached.
• Timer — Tap Start to begin timing, Pause to stop, Reset to clear. Auto-completes when the goal duration is reached.
• Long Press (Counter & Timer) — Press and hold on a counter or timer habit card for ~0.6 seconds to instantly quick-complete it to 100%.
• Swipe Right — On mobile, swipe a simple-check habit card to the right to quickly complete it.

Other Actions:

• Edit — Tap the ✏️ button on any habit card to modify its settings.
• Delete — Tap the 🗑️ button to delete a habit. An undo toast appears for 5 seconds to restore it.
• Add Notes — Tap "📝 Add note" on any habit to journal about how it went. Notes appear on the habit card and are saved per day.

HabitFlow includes a full-featured task manager with smart features designed to help you stay productive without feeling overwhelmed.

Quick Add (Natural Language Parsing):

Type naturally in the input bar and HabitFlow automatically parses due dates, priorities, and sections:

• "Buy groceries tomorrow !high" → High priority, due tomorrow
• "Call dentist friday" → Due next Friday, added to Upcoming
• "Read book #someday" → Added to Someday section
• "Finish report today !high" → High priority, due today
• "Team meeting next week" → Due in 7 days

Supported keywords: today, tomorrow, monday–sunday, next week, !high, !medium, !low, #someday, #upcoming

Task Features:

• Priority Levels — 🔴 High (+3 XP), 🟡 Medium (+2 XP), ⚪ Low (+1 XP). Priority affects sort order, visual styling, and XP earned.
• Smart Sections — Organize tasks into 📌 Today, 📅 Upcoming, and 💭 Someday. Overdue tasks automatically move from Upcoming to Today. Tasks with today's due date also auto-move to Today.
• Subtasks — Break big tasks into smaller steps with a visual progress bar. Each completed subtask earns +0.5 XP. When all subtasks are done, the parent task auto-completes.
• Recurring Tasks — Set tasks to repeat daily, weekly, bi-weekly, or monthly. When you complete a recurring task, a new instance is automatically created with the next due date.
• Habit-Linked Tasks — Connect a task to one of your habits (e.g., "Buy running shoes" linked to your Exercise habit). Linked tasks show a 🔗 badge.
• Energy Levels — Each task has an energy level (High/Medium/Low) that can be set manually or auto-assigned based on priority. Focus Mode uses this to recommend tasks matching your current wellness rating.
• Notes — Add detailed notes, links, or context to any task. Notes appear below the task name on the card.
• Categories — Categorize tasks (Health, Productivity, Learning, Social, Creativity, Finance, Self-Care, Other) for analytics breakdowns.
• Drag & Drop — On desktop, drag task cards to reorder them within a section or move them between sections.
• Daily Limit Indicator — A gentle nudge appears when you have more than 5 tasks for today, encouraging you to stay focused.

Task Karma (XP System):

Earn XP for completing tasks and level up from Beginner all the way to Eternal (20 levels total):

• 🔴 High priority task = +3 XP
• 🟡 Medium priority task = +2 XP
• ⚪ Low priority task = +1 XP
• Each subtask completed = +0.5 XP

Your current level, XP progress bar, and title are displayed at the top of the Tasks tab.

Focus Mode:

Tap 🎯 Focus Mode to enter a distraction-free view that shows one task at a time. Tasks are sorted by energy match (based on your wellness rating) and priority. Tap the large ✓ button to complete, or "Skip" to move to the next task. If a task has subtasks, you can check them off individually within Focus Mode — the task auto-completes when all subtasks are done.

Swipe Gestures (Mobile):

• Swipe right on a task → Complete it
• Swipe left on a task → Reschedule it (moves between Today/Upcoming)

Task Streak:

Clear all your Today tasks to build a daily task streak. The streak counter appears next to the Focus Mode button. Clearing all tasks triggers confetti and a celebration sound!

Filter Tabs:

Use the filter bar to quickly view: All active tasks, Today only, Upcoming only, Someday only, or Done (completed tasks).

The Analytics tab provides deep insights into both your habit and task performance. Use the time filter at the top to view data for 7 days, 30 days, 90 days, or year-to-date.

Habit Analytics:

• Top Stats — Completion rate, active days, and habits per day, each with a comparison to the previous period (e.g., "↑ 5% vs prev 30d").
• Monthly Habit Grid — A Trax-style grid showing every habit's completion status for each day of the month. Each cell shows ✓ for completed, empty for missed, and blank for future/unscheduled days. Navigate between months with arrow buttons. Includes a weekly grouping with analysis columns showing total completions and a visual bar per habit.
• Daily Performance Chart — A smooth line chart showing your daily completion rate percentage over the selected time period.
• Mental Wellness Chart — A line chart tracking your daily wellness ratings (1–10) over time. Below the chart, clickable day cells let you rate or edit wellness for any past day.
• Habit Ranking — All habits ranked by completion rate with visual progress bars. Gold, silver, and bronze badges for the top 3. Color-coded: green (≥70%), yellow (≥40%), red (<40%).
• Weekly Breakdown — Week-by-week completion rates displayed as vertical bar blocks with percentages.
• Low Momentum — Habits that have been missed 2+ times in the last 5 days, sorted by most missed. Shows "🎉 All habits on track!" when everything is going well.
• Mental Wellness Average — Your average wellness score for the period with a mini trend chart.
• Streaks — Current overall streak (consecutive days with 100% completion) and personal best streak.

Task Analytics:

• Overview Stats — Completed tasks, completion rate, average tasks per day, and XP earned in the period.
• Daily Bar Chart — A bar chart showing tasks completed per day for the last 14 days.
• Category Breakdown — Tasks completed by category with visual bars.
• Priority Breakdown — Tasks completed by priority level (High/Medium/Low) with color-coded cards.
• Best Day & Most Productive Day — Which specific date and which day of the week you complete the most tasks.
• Task Karma Summary — Your current level, title, and total XP.
• Task Streak — How many consecutive days you've cleared all Today tasks.
• Subtask Stats — Total subtasks completed and bonus XP earned from them.

The Calendar tab displays a GitHub-style heatmap showing your daily habit completion rates for the month.

• Days are color-coded from empty (no completions) through progressively brighter shades of green up to bright green (100% completion).
• Today's date is highlighted with a border.
• Navigate between months using the ◀ and ▶ arrow buttons.
• A legend at the bottom shows the color scale from "Less" to "More."
• Future dates appear empty (no color).

The heatmap gives you a quick visual overview of your consistency over time — aim to keep the calendar as green as possible!

HabitFlow has 70+ achievements across 8 categories, designed to celebrate your progress and keep you motivated. Tap "View Achievements" in the Analytics tab to see them all.

Newly unlocked achievements show a pulsing gold dot and a toast notification. Each achievement card shows the date it was unlocked.

🎨 Appearance:

• Theme — Choose Auto (follows your system preference), Dark, or Light mode. Auto mode automatically switches based on your device's appearance setting.
• Motivational Quotes — Toggle daily inspiration quotes on the home screen progress ring. A different quote appears each day, cycling through 12 curated quotes.
• Celebration Effects — Toggle confetti animation when you achieve 100% daily completion or clear all Today tasks.
• Sound Effects — Toggle audio feedback for completions (ascending chime), steps (quick ping), undo (descending tone), and all-done (four-note fanfare).
• Full Width Layout — Desktop only. Expands the app container to fill the entire screen width instead of the default 960px max-width.

🔔 Notifications:

• Push Notifications — Enable browser notifications for habit reminders. Each habit with a reminder time set will trigger a notification at that time if the habit isn't yet completed.
• Evening Reminder — Get nudged at a configurable time (default 8 PM) if you have incomplete habits. Shows how many are left and encourages you to finish strong.
• Task Due Reminders — Checks at 9 AM for tasks due today or overdue, and sends a notification with the count and priority breakdown.
• Streak-at-Risk Warnings — At 8 PM, alerts you if any habit with a 3+ day streak hasn't been completed yet. Shows the longest streak at risk.

☀️ Daily Planning Ritual:

• Enable/Disable — Toggle the guided morning planning flow on or off.
• Planning Time — Set when the planning prompt appears (default 8:00 AM). The prompt shows within a 2-hour window after the set time.
• The planning flow walks you through:
  1. A greeting with yesterday's stats overview
  2. Reviewing yesterday's incomplete tasks (keep, reschedule, or drop each one)
  3. Setting your energy level for the day (High/Medium/Low) — this also sets your wellness rating and affects Focus Mode recommendations
  4. A summary of your planned day with task and habit counts

❄️ Streak Protection:

• Streak Freezes — Earn 1 freeze for every 7 consecutive perfect days (100% completion). A freeze automatically protects your streak for 1 missed day. Your current freeze count is displayed in Settings.
• Vacation Mode — Activate to pause all habits without breaking any streaks. A banner appears on the home screen while active. Tap "End Vacation" when you're back. No habits are scheduled or tracked during vacation.

💾 Data Management:

• Export — Download all your habit data, completions, counter/timer progress, notes, wellness ratings, achievements, and settings as a JSON file. The filename includes today's date for easy versioning.
• Import — Restore from a previously exported JSON backup file. Replaces all current data (with confirmation prompt).
• Reset — Permanently delete all data including habits, completions, tasks, achievements, and settings. Requires double confirmation ("Are you sure?" → "Really sure?") to prevent accidental data loss.

ℹ️ About & Help:

• Share Progress — Generate a shareable image card of your habits, tasks, streak, or weekly stats. Choose from 4 card styles, then save as PNG, copy to clipboard, or share natively on mobile.
• Show Tutorial — Re-watch the interactive getting started guide with demo data exploration mode.
• Help & Suggestions — Opens a feedback form where you can submit feature suggestions, bug reports, or questions. Sends via your email app to the support team.

1. Start small — Begin with 2–3 habits and build up gradually. Research shows that starting with too many habits at once leads to burnout and abandonment.
2. Don't break the chain — Streaks are your most powerful motivator. The streak counter tracks consecutive days of completion. Even on tough days, try to maintain your streak — it compounds over time.
3. Use natural language for tasks — Type "Call dentist friday !high" and HabitFlow automatically sets the due date and priority. Supported keywords include: today, tomorrow, monday–sunday, next week, !high, !medium, !low, #someday, #upcoming.
4. Rate your wellness daily — The 1–10 slider on the home screen feeds into analytics charts and helps Focus Mode suggest energy-appropriate tasks. Low energy day? Focus Mode will prioritize easy tasks.
5. Use Focus Mode when overwhelmed — It shows one task at a time, prioritized by your energy level and task priority. Just tap ✓ to complete or "Skip" to move on. If a task has subtasks, you can check them off individually.
6. Add notes to habits — Tap "📝 Add note" on any habit to journal about how it went. Notes are saved per day and appear on the habit card and in the analytics grid.
7. Back up your data regularly — Export in Settings → Data Management. Since all data is stored locally in your browser, clearing browser data will erase everything. Regular backups protect against data loss.
8. Install as an app — HabitFlow is a Progressive Web App (PWA). On iOS, open in Safari and tap "Add to Home Screen." On Android, tap the install prompt or use Chrome's menu → "Install app." This gives you a native app experience with an icon on your home screen.
9. Keyboard shortcut — Press N on desktop to quickly open the new habit modal from any tab.
10. Swipe gestures — On mobile, swipe right on habits (checkbox type) and tasks to quickly complete them. Swipe left on tasks to reschedule them between Today and Upcoming.
11. Long press for quick-complete — For counter and timer habits, press and hold on the habit card for ~0.6 seconds to instantly complete it to 100%. A green glow animation indicates the long press is registering.
12. Use the "X Per Week" frequency — For habits you want to do a certain number of times per week but not on specific days. Set "At least X times per week" and complete them on any days you choose. The weekly progress counter shows on the habit card.
13. Link tasks to habits — When creating a task, link it to a related habit (e.g., "Buy running shoes" → Exercise habit). Linked tasks show a 🔗 badge and count toward the "Connected" achievement.
14. Use the time progress widget — Tap the time widget below the date in the header to cycle through day, week, month, and year progress views. It shows how much time is left in each period.
15. Check the Weekly Review — Every Sunday, a review card appears on the home screen summarizing your past week's performance, including your best habit, habits needing attention, and average wellness score.

• 100% Local Storage — All your data (habits, completions, tasks, notes, wellness ratings, achievements, and settings) is stored exclusively in your browser's localStorage. Nothing is ever sent to any server.
• No Account Required — HabitFlow works without any sign-up, login, or account creation. Just open the app and start tracking.
• Offline Capable — As a PWA with a service worker, HabitFlow works fully offline after the first load. All features function without an internet connection.
• No Tracking or Analytics — HabitFlow does not use any third-party analytics, tracking pixels, cookies, or telemetry. Your habit data is yours alone.
• Data Portability — Export your complete data as a JSON file at any time from Settings → Data Management → Export. You can import this file to restore your data on any device or browser.
• ⚠️ Browser Data Warning — Since data is stored in localStorage, clearing your browser data, cookies, or site data will permanently erase all HabitFlow data. Always keep a recent backup export.

Keyboard shortcuts are only active when no text input field is focused.