Skip to content

flexhunt/habitquest

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

6 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ”ฅ HabitQuest โ€” Gamified Habit Tracker with Social Squads

HabitQuest is a gamified habit tracking app that turns your daily routines into epic quests. Level up, defeat bosses with your squad, earn achievements, and build unbreakable streaks โ€” all while staying productive.

Android PWA Next.js Supabase License


๐ŸŒŸ Unique Feature: Instagram Integration

Track habits directly from Instagram DMs!

  1. Get your unique sync code from the app
  2. Paste it in HabitQuest's Instagram DM (@tlwiin)
  3. Your account is now linked
  4. Reply with habit commands to mark them complete โ€” no need to open the app!

The only habit tracker that works inside Instagram.


โœจ Features

๐ŸŽฎ Gamification Engine

  • XP & Leveling System โ€” Earn experience points for every habit completed
  • Achievement Badges โ€” Unlock badges like "Streak Master", "Early Bird", "Night Owl"
  • Daily Streaks โ€” Maintain streaks with grace periods and streak protection shields
  • Progress Visualization โ€” Yearly heatmaps, weekly analytics, habit history charts

โš”๏ธ Squad Boss Battles

  • Create or Join Squads โ€” Team up with friends or strangers
  • Daily Boss Raids โ€” Deal damage to bosses by completing your habits
  • Leaderboards โ€” Compete for the top spot in your squad
  • Squad Chat โ€” Real-time messaging with your team
  • World Chat โ€” Global chat room for all HabitQuest users

๐Ÿ““ Journaling

  • Daily Journal Entries โ€” Reflect on your day with guided prompts
  • AI-Powered Prompts โ€” Smart prompts based on your mood and habits
  • Mood Tracking โ€” Track your emotional state over time
  • Markdown Support โ€” Format your journal entries beautifully

๐Ÿ“š Reading Tracker

  • EPUB Reader โ€” Read books directly in the app
  • Progress Tracking โ€” Track pages read and reading time
  • Reading Goals โ€” Set and achieve reading goals

๐Ÿง˜ Focus & Crisis Modes

  • Focus Mode โ€” Block distractions with a beautiful timer
  • Crisis Mode โ€” Special support mode for tough mental health days
  • Pomodoro Timer โ€” Built-in productivity timer

๐Ÿ”” Smart Notifications

  • Custom Reminders โ€” Set reminders for each habit
  • Push Notifications โ€” Native notifications on Android
  • Motivational Messages โ€” Get encouraged when you need it

๐ŸŽจ Premium UI/UX

  • Animated Emojis โ€” Bring your habits to life with custom animated emojis
  • Dark Mode โ€” Beautiful dark theme with glassmorphism effects
  • Responsive Design โ€” Works on mobile, tablet, and desktop
  • Offline Support โ€” Track habits even without internet

๐Ÿš€ Tech Stack

Layer Technology
Frontend Next.js 16, React 19, TypeScript
Styling Tailwind CSS 4, Framer Motion
Backend Supabase (PostgreSQL, Auth, Storage)
Mobile Capacitor (Android)
Animations Framer Motion, Canvas Confetti
Charts Recharts
UI Components Radix UI, shadcn/ui

๐Ÿ“ฑ Installation

Web App (PWA)

Visit myhabits.in and install as a Progressive Web App.

Android APK

Download the latest APK from GitHub Releases.


๐Ÿ› ๏ธ Development

# Start dev server
npm run dev

# Run linting
npm run lint

# Build for production
npm run build

๐Ÿ“Š Screenshots

Home Habits Stats
Home Habits Stats
Journal Social Squad
Journal Social Squad
Boss Battle Chat Achievements
Battle Chat Achievements
Settings
Settings

๐Ÿค Contributing

Contributions are welcome! Please read our Contributing Guide for details.


๐Ÿ“„ License

MIT License โ€” see LICENSE for details.


๐Ÿ”— Links


โ“ Frequently Asked Questions

What is HabitQuest?

HabitQuest is a free, open-source habit tracking app that uses gamification to help you build better habits. It combines habit tracking with RPG-style progression, social features, and journaling.

Is HabitQuest free?

Yes! HabitQuest is completely free and open-source. There are no hidden costs or premium features behind a paywall.

Does HabitQuest work offline?

Yes, HabitQuest caches your data locally and syncs when you're back online. You can track habits, view your streaks, and read journals offline.

Can I use HabitQuest with friends?

Absolutely! Create or join a squad to battle bosses together, chat in real-time, and climb the leaderboard as a team.

What platforms does HabitQuest support?

HabitQuest is available as a Progressive Web App (works on any browser) and as a native Android app. iOS support is planned.

How does the XP system work?

Every habit you complete earns you XP. The amount depends on the habit's difficulty, your current streak, and bonus multipliers. Level up to unlock new achievements!

Can I import my habits from other apps?

Currently, manual import is supported via settings. We're working on direct integrations with popular habit trackers.


๐Ÿท๏ธ Keywords

habit-tracker gamification productivity android-app pwa nextjs supabase react typescript open-source squad-battles journaling streak-tracking xp-system achievements focus-mode reading-tracker offline-first framer-motion tailwindcss


Built with โค๏ธ by the HabitQuest Team