Skip to content

pastor0711/adhd-habit-gamifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎯 Goal Streak Tracker

A beautiful, ADHD-friendly web application to track your goals and build lasting habits. Monitor how long you've been working on each goal with automatic day, hour, minute, and second tracking, plus motivational features to keep you going!

Created by @pastor0711

πŸš€ Live Demo

Try the app live at: https://pastor0711.github.io/adhd-habit-gamifier/

ADHD-Friendly Features

🎯 Granular Achievement System

  • Micro-achievements: Get rewarded every 5, 15, 30 minutes in your first hour!
  • Hourly milestones: Progress tracked at 1hr, 3hr, 6hr, 12hr on day one
  • 25+ unique badges: From 🌱 "Just Started" to πŸ’― "100 Days" and beyond
  • Day-specific badges: Special achievements for days 1, 2, 3, 7, 14, 21, 30, 60, 100, 365
  • Animated badges: Pulsing effects that catch your eye

🎨 Personalization & Organization

  • 6 color themes: Purple, Blue, Green, Orange, Red, and Teal for each goal
  • Color-coded cards: Each goal has its own visual identity
  • Sort options: View by Newest, Oldest, Longest Streak, or Shortest Streak
  • Overall statistics: See total goals, active goals, total days, and longest streak

πŸ”Š Multi-Sensory Feedback

  • Sound effects: Cheerful tones when you add goals or hit milestones (toggle on/off)
  • Visual celebrations: Animated emojis pop up for milestone achievements
  • Progress bars: Animated shimmer effects show your journey
  • Motivational messages: Rotating encouraging quotes for every goal

πŸ“ Tracking & Accountability

  • Notes feature: Journal your thoughts, feelings, or progress for each goal
  • Pause/Resume: Life happens! Pause goals without losing your progress
  • Best streak tracking: Your personal record is always visible
  • Real-time updates: Numbers update every second so you see constant progress

πŸ’« Visual Clarity

  • Big, bold numbers: 2.5rem gradient text that's impossible to miss
  • Hover effects: Every element responds to interaction
  • Clear hierarchy: Important info stands out
  • Progress visualization: See exactly how close you are to the next milestone
  • Reduced motion support: Respects accessibility preferences

All Features at a Glance

  • ✨ Unlimited Goals: Track as many goals as you want
  • 🎨 Color Themes: Choose from 6 beautiful color gradients for new goals, and customize colors for existing goals
  • ⏱️ Automatic Tracking: Days, hours, minutes, and seconds update in real-time
  • ⏸️ Pause/Resume: Pause goals temporarily without losing progress
  • πŸ“ Notes System: Add personal notes and reflections to each goal
  • πŸ† Best Streak: Track your personal best for each goal
  • πŸ”„ Smart Reset: Resets save your best streak automatically
  • πŸ—‘οΈ Delete Goals: Remove goals you no longer need
  • πŸ“Š Overall Stats: Dashboard showing total goals, active goals, and more
  • πŸ”€ Sort Options: Organize by newest, oldest, longest, or shortest streak
  • πŸ”Š Sound Effects: Optional audio feedback (can be toggled off)
  • πŸŽ‰ Milestone Rewards: Celebrations and sounds at key achievements
  • πŸ’¬ Personalized Messages: Unique motivational messages for each milestone
  • πŸ’Ύ Auto-Save: Everything is saved automatically using localStorage
  • πŸ“± Fully Responsive: Optimized for desktop, tablet, and mobile
  • πŸŒ™ Dark Mode: Comfortable dark theme with softer colors and saved preference
  • β™Ώ Accessible: Reduced motion support and clear visual hierarchy

How to Use

Getting Started

  1. Open the App: Simply open index.html in any modern web browser
  2. Pick a Color: Select a color theme from the color picker
  3. Add a Goal: Type your goal name and click "Add Goal" or press Enter
  4. Watch It Track: The timer starts immediately and updates every second

Managing Your Goals

  • Change Colors: Click 🎨 Color to customize each goal's color theme
  • Pause/Resume: Click ⏸️ Pause to temporarily stop tracking (perfect for breaks!)
  • Add Notes: Click πŸ“ Notes to journal about your progress or feelings
  • Reset: Click πŸ”„ Reset to start over (your best streak is saved!)
  • Delete: Click πŸ—‘οΈ Delete to remove a goal

Organizing Your View

  • Sort Goals: Use the dropdown to sort by newest, oldest, longest, or shortest streak
  • Dark Mode: Click πŸŒ™ to toggle dark mode (preference is saved!)
  • Toggle Sound: Click πŸ”Š to turn sound effects on or off
  • View Stats: See your overall progress at the top of the page

Milestones & Achievements

  • First Hour: Get badges every 5, 15, 30 minutes, then 1, 3, 6, 12 hours
  • First Day: Hourly achievements up to 24 hours
  • Long Term: Special badges at 1, 2, 3, 7, 14, 21, 30, 60, 100 days, and beyond!

Technical Details

  • Pure JavaScript: No frameworks or dependencies required
  • Local Storage: All data is stored in your browser's localStorage
  • Real-time Updates: Timers update every second automatically
  • Cross-browser Compatible: Works in all modern browsers

File Structure

β”œβ”€β”€ index.html      # Main HTML structure
β”œβ”€β”€ styles.css      # All styling and animations
β”œβ”€β”€ script.js       # Application logic and functionality
└── README.md       # This file

Badge Progression System

Your goals earn increasingly impressive badges as you progress:

First Hour (Minute-based):

  • 🌱 Just Started! (0-5 min) - "Every journey begins with a single step! 🌟"
  • 🌿 5+ Minutes! - "Great momentum! Keep that energy flowing! πŸ’«"
  • πŸ€ 15+ Minutes! - "You're building something amazing! 🌈"
  • 🌳 30+ Minutes! - "Half an hour of dedication! You're unstoppable! ⚑"
  • πŸ’ͺ 1+ Hour! - "An hour of focus! Your determination shines! ✨"
  • πŸ’« 3+ Hours! - "Three hours of commitment! You're a force! πŸš€"
  • ⭐ 6+ Hours! - "Six hours of dedication! You're incredible! 🌟"
  • ✨ 12+ Hours! - "Half a day of consistency! You're amazing! 🎯"

Day 1-7:

  • 🎯 1 Day! - "Your first full day! A beautiful beginning! πŸŒ…"
  • πŸš€ 2 Days! - "Two days strong! Your momentum is building! πŸ’ͺ"
  • ⚑ 3 Days! - "Three days of dedication! You're on fire! πŸ”₯"
  • πŸ’Ž 4-6 Days! - "Day X and still going! You're a diamond! πŸ’Ž"
  • 🌟 1 Week! - "One full week! You're building real habits! 🌟"

Week 2-4:

  • πŸ’Ž 8-13 Days! - "Day X and still going! You're a diamond! πŸ’Ž"
  • ⚑ 2 Weeks! - "Two weeks of consistency! You're electric! ⚑"
  • πŸ’Ž 15-20 Days! - "Day X and still going! You're a diamond! πŸ’Ž"
  • πŸŽ† 3 Weeks! - "Three weeks! You're a celebration of consistency! πŸŽ†"
  • πŸ‘‘ 1 Month! - "One month of dedication! You're royalty! πŸ‘‘"

Beyond:

  • πŸ₯ˆ 2 Months! - "Two months of excellence! Silver medal worthy! πŸ₯ˆ"
  • πŸ’― 100 Days! - "100 DAYS! You're absolutely legendary! πŸ’―"
  • πŸ‘‘ 200+ Days LEGEND! - "Day X - you're a living legend! πŸ‘‘"
  • 🌟 365+ Days CHAMPION! - "Day X - you're an eternal champion! 🌟"

Screenshots

Light Mode

Light Mode Screenshot

Dark Mode

Dark Mode Screenshot

Mobile View

Mobile View Screenshot

Examples of Goals to Track

  • πŸ’ͺ Daily Exercise Streak
  • πŸ“š Reading Every Day
  • 🚭 Smoke-Free Days
  • πŸ’§ Staying Hydrated
  • 🧘 Daily Meditation
  • πŸ’» Learning to Code
  • 🎨 Creative Projects
  • 🌱 Plant Care
  • πŸƒ Running Routine
  • πŸ“ Journaling
  • 🎯 Any Personal Goal!

Browser Support

  • Chrome/Edge (latest)
  • Firefox (latest)
  • Safari (latest)
  • Opera (latest)

Enjoy tracking your goals! πŸš€

About

ADHD-friendly gamified habit tracker with real-time streaks, milestones, and motivational features.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors