Your intelligent productivity partner with AI-powered assistance, health monitoring, and gamification.

HealthyFlow AI is a comprehensive personal assistant application that helps you stay organized, healthy, and productive. With voice-enabled AI interactions, real-time health tracking, weather intelligence, and an engaging gamification system, HealthyFlow AI keeps you motivated and on track.

For security and IP protection, the full production code is currently hosted privately. This repository demonstrates the project structure and documentation.

• Smart Notes - Voice-enabled note-taking with AI assistance
• Intelligent Reminders - Priority-based task management with smart scheduling
• Habit Tracking - Build streaks and maintain consistency
• Goal Management - Track progress and achieve your objectives
• Weather Intelligence - 5-day forecast with outdoor activity recommendations

• Voice Input/Output - Speak to your assistant naturally
• ElevenLabs Voice - High-quality voice responses
• Context-Aware - Personalized suggestions based on your activity
• Morning Briefings - Daily productivity insights with weather context
• Smart Rescheduling - Weather-aware activity planning
• Bilingual Support - English and Indonesian

• PPG Heart Rate Monitoring - Track heart rate using your camera
• Blood Oxygen (SpO2) - Monitor oxygen saturation levels
• Stress Detection - Real-time stress level analysis
• Health Analytics - Beautiful charts and trend visualization

• XP & Leveling - Earn experience points for every action
• 15+ Badges - Unlock achievements across 5 tiers (Bronze to Diamond)
• Streak Tracking - Build daily streaks and maintain consistency
• Lifetime Stats - Track total tasks, habits, goals, and notes
• Visual Progress - Beautiful progress bars and achievement displays

• Install to Home Screen - Native app-like experience
• Offline Support - Works without internet connection
• Auto-Updates - Notifications when new versions available
• Service Worker - Smart caching for optimal performance
• Custom Offline Page - Beautiful fallback when offline

• 7-Day Activity Trends - Visualize your productivity over time
• Priority Distribution - See how your tasks are prioritized
• Habit Performance - Track streaks and completion rates
• Goal Progress - Monitor your journey to achievement
• Completion Stats - Daily habit and reminder tracking

• Local Storage - All data stays on your device
• No Cloud Sync - Complete data ownership
• Backup/Restore - Export and import your data anytime
• GDPR Compliant - Privacy-focused design

• Next.js 15.3.8 - React framework with App Router
• TypeScript - Type-safe development
• Tailwind CSS - Utility-first styling
• Shadcn/UI - Beautiful, accessible components
• Recharts - Data visualization library
• Framer Motion - Smooth animations

• ElevenLabs API - High-quality voice synthesis
• OpenWeatherMap API - Weather data and forecasts
• Web Speech API - Browser-native voice recognition
• Photoplethysmography (PPG) - Camera-based health monitoring

• Service Worker - Offline support and caching
• Web App Manifest - Installable PWA configuration
• Workbox - Advanced caching strategies
• IndexedDB - Client-side database for offline data

• Node.js 18+ installed
• npm, yarn, pnpm, or bun package manager

1. Clone the repository

git clone <your-repo-url>
cd healthyflow-ai

2. Install dependencies

npm install
# or
yarn install
# or
pnpm install

3. Run the development server

npm run dev
# or
yarn dev
# or
pnpm dev

4. Open your browser Navigate to http://localhost:3000

npm run build
npm start

• / - Beautiful landing page showcasing all features
• /dashboard - Main application dashboard with all tools

1. 📝 Notes - Voice-enabled note-taking
2. ⏰ Reminders - Task management with priorities
3. ✅ Habits - Habit tracking with streaks
4. 🎯 Goals - Goal management and progress tracking
5. 💪 Health - PPG monitoring (Heart Rate, SpO2, Stress)
6. 🌤️ Weather - Current weather and 5-day forecast
7. 🤖 AI Assistant - Voice-enabled AI interactions
8. 🏆 Achievements - Gamification dashboard with XP and badges
9. 📊 Analytics - Productivity charts and insights
10. ℹ️ About - App information and version
11. ⚙️ Settings - Preferences, backup/restore, and configuration

• +5 XP - Create a note
• +10 XP - Create a reminder
• +20 XP - Complete a reminder
• +15 XP - Create a habit
• +25 XP - Complete a habit
• +10 XP - Update goal progress
• +100 XP - Complete a goal!

• Bronze - Beginner achievements (e.g., First Note, First Task)
• Silver - Intermediate milestones (e.g., 10 tasks, 5-day streak)
• Gold - Advanced achievements (e.g., 50 tasks, 30-day streak)
• Platinum - Expert level (e.g., 100 tasks, Level 25)
• Diamond - Master achievements (e.g., 500 tasks, Level 50)

• Task Master, Reminder Pro, Habit Builder
• Streak Legend, Goal Crusher, Knowledge Keeper
• Productivity Beast, Health Enthusiast, Consistency King
• Week Warrior, Monthly Champion, Legendary Status
• And more!

• Current Weather - Real-time weather for saved locations
• 5-Day Forecast - Daily weather predictions
• Smart Recommendations - Weather-aware activity suggestions
• Outdoor Activity Detection - Alerts for bad weather during outdoor plans
• Weather Icons - Beautiful visual weather representations

• Provider: OpenWeatherMap
• Units: Metric (Celsius, meters/sec)
• Update Frequency: Real-time
• Data Points: Temperature, humidity, wind, precipitation, visibility

• Web Speech API - Browser-native speech recognition
• Continuous Listening - Hold to speak functionality
• Bilingual - English and Indonesian support
• Command Parsing - Natural language understanding

• ElevenLabs TTS - High-quality voice synthesis
• Natural Responses - Context-aware AI replies
• Multilingual - Supports multiple languages
• Streaming Audio - Low-latency playback

• LocalStorage - Persistent browser storage
• Privacy-First - No cloud, no tracking
• Instant Access - No network latency

• Export Data - Download complete backup as JSON
• Import Data - Restore from backup file
• Data Validation - Safe import with error handling
• Clear All - Reset app with confirmation

• Total tasks completed
• Total habits logged
• Total goals achieved
• Total notes created
• Current and longest streaks
• Days active
• XP earned
• Level reached

• 7-day activity line chart
• Priority distribution pie chart
• Habit streak progress bars
• Goal completion bars
• Completion rate statistics

• Dark Mode - Eye-friendly dark theme (default)
• Light Mode - Clean light theme
• System - Follow OS preference
• Smooth Transitions - Animated theme switching

• Primary - Purple gradients (#9333ea to #3b82f6)
• Accent - Blue and pink highlights
• Glassmorphism - Frosted glass effects
• Gradients - Dynamic, modern aesthetics

• Font - Geist Sans & Geist Mono
• Responsive - Mobile-first design
• Accessible - WCAG 2.1 AA compliant

• Local-Only Storage - Data never leaves your device
• No Analytics - No tracking or telemetry
• No Cookies - Session-based state management
• Open Source - Transparent codebase

• Export Anytime - Download your data
• Delete Anytime - Clear all data instantly
• No Account Required - Use without registration
• GDPR Compliant - Privacy by design

1. Visit the app in your browser
2. Click the install icon in the address bar
3. Click "Install" in the popup
4. App icon appears on desktop

1. Open in Safari
2. Tap the Share button
3. Scroll down and tap "Add to Home Screen"
4. Tap "Add"

1. Open in Chrome
2. Tap the three-dot menu
3. Tap "Install app" or "Add to Home Screen"
4. Tap "Install"

Contributions are welcome! Please feel free to submit a Pull Request.

1. Follow TypeScript strict mode
2. Use ESLint and Prettier
3. Write meaningful commit messages
4. Test on mobile and desktop
5. Ensure accessibility standards

For detailed contribution guidelines, see CONTRIBUTING.md

This project is open source and available under the MIT License.

• Next.js Team - Amazing React framework
• Vercel - Deployment platform
• OpenWeatherMap - Weather data API
• ElevenLabs - Voice synthesis API
• Shadcn - Beautiful UI components
• Tailwind CSS - Utility-first CSS framework

For questions, issues, or feature requests:

• 🐙 GitHub Repository: https://github.com/mrbrightsides/healthyflow
• ✉️ Email Support: support@elpeef.com
• 💬 Telegram: @khudriakhmad
• 🎮 Discord: @khudri_61362
• 📚 Documentation: Check ARCHITECTURE.md, SETUP.md, and THIRD_PARTY_APIs.md

• Push notifications for reminders
• Calendar integration (Google Calendar, Apple Calendar)
• Social sharing of achievements
• Team collaboration features
• Advanced voice commands
• Custom badge creation
• Export to PDF
• Multi-language expansion
• Smart scheduling AI
• Integration with fitness trackers

Built with ❤️ using Next.js, TypeScript, and modern web technologies.

HealthyFlow AI - Your intelligent productivity partner.