HabitFlow

Build better habits with streaks, stats, and motivation 🔥

Features

• Habit tracking — Create habits with custom icons, colors, and frequencies
• Streak system — Automatic streak calculation with best streak tracking
• Heatmap calendar — GitHub-style 30-day completion heatmap
• Weekly progress charts — Bar charts showing weekly completion trends
• Dashboard — Today's habits, stats overview, and recent activity
• One-click toggle — Mark habits complete with a single click
• SQLite storage — Lightweight, file-based database
• Docker-ready — Full containerized deployment

Quick Start

Development

npm install
npm run dev          # Frontend on :5177
npm run dev:server   # API server on :3004

Docker

docker-compose up

• Web UI: http://localhost:5177
• API: http://localhost:3004

Tech Stack

• Frontend: React 18, Vite, TailwindCSS, Recharts, Lucide, date-fns
• Backend: Express, TypeScript, better-sqlite3
• Testing: Vitest
• Deployment: Docker, Nginx

License

MIT