HabitFlow (working title)

A social habit tracker that combines private habit streaks with optional friend-group challenges and lightweight daily todos.

Why I’m building this

I like habit trackers, but I stick with them longer when I can keep my habits private and still get motivation from friends. HabitFlow is my attempt to combine both without clutter.

Core features (MVP)

• Private habits
  • Create habits with schedules (daily / custom days)
  • Check in for today
  • Streak tracking (timezone-aware)
• Daily todos
  • Quick list of tasks for today
  • Mark complete / delete
• Accounts
  • Register / login / logout
  • Each user sees only their data

Social features (V1)

• Friend groups
  • Create/join a group
  • Group habit challenges
  • Simple leaderboard (streak or consistency)
• Activity feed
  • “Priya checked in on Run” (only inside a group)

Real-time features (V2)

• Live group updates (check-ins, milestones)
• Celebrations / notifications

Tech stack (planned)

• Frontend: React + Vite + React Router
• Backend: Node.js + Express
• Database: MongoDB (Atlas)
• Auth: Sessions or JWT (tbd)
• Real-time: WebSocket (or Socket.IO)

Project status

• Planning
• MVP build (habits + todos + auth)
• V1 (groups + activity feed)
• V2 (real-time)

Local development (future)

Instructions will go here once the app is scaffolded.