Transform your life with science-backed habit tracking. Break free from unwanted habits with neuroscience insights, personalized rewards, and a supportive community.
- Real-time brain insights based on your current streak
- Scientific explanations of neuroplasticity and recovery
- Evidence-based milestone recommendations
- Recovery timeline with brain chemistry changes
- 12+ Pre-built Templates: Smoking, social media, alcohol, junk food, procrastination, and more
- Custom Habits: Create your own with personalized milestones
- UUID-based System: Robust habit identification and data integrity
- Daily Progress: Mark success or break days with visual feedback
- Custom Rewards: Define personal treats for each milestone
- Achievement Sharing: Beautiful shareable cards with neuroscience facts
- Progress Levels: Journey Beginner → Habit Master
- Confetti Celebrations: Dopamine-boosting visual rewards
- Comprehensive Calendar: Visual progress tracking with success/break patterns
- Success Rate Calculations: Detailed statistics and trends
- Streak Tracking: Current and longest streaks with milestone progress
- Multi-habit Overview: Track multiple habits simultaneously
- User Profiles: Custom names, avatars, and bios
- Promise System: Personal commitments shown during temptation moments
- Motivational Quotes: Daily inspiration and encouragement
- Progress Insights: Personalized feedback based on your journey
- Export/Import: Full data backup and restore functionality
- Local Storage: Privacy-first approach with client-side data
- Data Portability: JSON format for easy migration
- Backup System: Automatic backup creation during imports
- Responsive UI: Perfect on desktop, tablet, and mobile
- Dark/Light Themes: Comfortable viewing in any environment
- Accessibility: Screen reader friendly with proper ARIA labels
- GitHub-Style: Professional open-source project aesthetics
- Node.js 18+
- npm, yarn, or pnpm
- Clone the repository
git clone https://github.com/NextProduction/breakthrough.git
cd Breakthrough- Install dependencies
npm install
# or
yarn install
# or
pnpm install- Run the development server
npm run dev
# or
yarn dev
# or
pnpm dev- Open your browser Navigate to http://localhost:3012
- Create Your Profile: Set your name and choose an avatar
- Add Your First Habit: Choose from templates or create custom
- Set Milestones & Rewards: Define what you'll treat yourself to
- Write Your Promise: Personal commitment for motivation
- Start Tracking: Mark daily progress and celebrate wins!
- Morning: Check your dashboard and set daily intentions
- Throughout Day: Resist urges by remembering your promise
- Evening: Mark your progress (success or break day)
- Celebrate: Enjoy confetti and achievements when you succeed!
- Calendar View: See patterns and trends across time
- Achievement Sharing: Share milestones on social media
- Data Export: Backup your progress regularly
- Multiple Habits: Track several habits simultaneously
Breakthrough is built on cutting-edge neuroscience research:
- Days 1-3: Initial neurochemical adjustment begins
- Week 1: New neural pathways start forming
- Week 2: Prefrontal cortex strengthening accelerates
- Month 1: Significant improvements in decision-making and impulse control
- Month 3: Major white matter integrity improvements
- Month 6+: Dopamine receptor recovery and enhanced natural reward sensitivity
- Positive Reinforcement: Immediate visual rewards (confetti, achievements)
- Social Proof: Shareable achievements for community support
- Implementation Intentions: Promise system for pre-commitment
- Progress Tracking: Visual feedback loops for motivation maintenance
- Next.js 15: React framework with App Router
- TypeScript: Type-safe development
- Tailwind CSS: Utility-first styling
- shadcn/ui: Modern component library
- Lucide React: Beautiful icons
- Client-Side Storage: Privacy-first local data storage
- Progressive Web App: Installable on mobile devices
- Responsive Design: Works on all screen sizes
- Performance Optimized: Fast loading and smooth animations
- ESLint: Code linting and formatting
- Prettier: Code formatting
- TypeScript: Static type checking
- Tailwind CSS: Utility-first CSS framework
- 🚬 Smoking - Comprehensive quit-smoking program
- 🧠 Masturbation - Overcome compulsive behaviors
- 📱 Social Media - Reduce excessive usage
- 🍷 Alcohol - Quit or reduce consumption
- 🍟 Junk Food - Stop unhealthy eating patterns
- ⏰ Procrastination - Overcome task avoidance
- 🛒 Impulse Shopping - Control unnecessary purchases
- 📺 Binge Watching - Reduce excessive screen time
- ⚡ Energy Drinks - Stop stimulant dependency
- ☕ Caffeine - Reduce caffeine intake
- 🎮 Gaming - Control excessive gaming
- 💭 Negative Thinking - Replace negative patterns
- 🛡️ Custom - Create your own habit
- Pre-configured milestones based on research
- Suggested rewards for each milestone
- Habit-specific neuroscience insights
- Customizable goals and timelines
We welcome contributions from the community! Here's how you can help:
- 🐛 Bug Reports: Found an issue? Let us know!
- 💡 Feature Requests: Have an idea? We'd love to hear it!
- 🔧 Code Contributions: Submit pull requests
- 📚 Documentation: Help improve our docs
- 🧪 Testing: Help test new features
- 🌍 Translations: Help make Breakthrough global
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes and test thoroughly
- Commit with clear messages:
git commit -m 'Add amazing feature' - Push to your branch:
git push origin feature/amazing-feature - Open a Pull Request
- Use TypeScript for all new code
- Follow existing code patterns and conventions
- Add comments for complex logic
- Ensure responsive design for all UI changes
- Test on multiple devices and browsers
This project is licensed under the MIT License - see the LICENSE file for details.
- Neuroscience Research: Based on studies from leading addiction and neuroplasticity researchers
- Open Source Community: Built with amazing open-source tools and libraries
- User Feedback: Continuously improved based on user experiences and suggestions
- Mental Health Advocates: Inspired by those working to destigmatize addiction recovery
- 📖 Documentation: Check our comprehensive guides
- 💬 Discussions: Join community conversations
- 🐛 Issues: Report bugs or request features
- 📧 Email: Contact us directly for support
- ⭐ Star this repo if Breakthrough helps you!
- 🐦 Follow us for updates and tips
- 📢 Share your success stories with the community
- 🤝 Contribute to help others on their journey
Delivered by Next Production Dev
Mahdi Hazrati
© 2025 Breakthrough. Licensed under MIT. Built with ❤️ for the community.