Skip to content

Home

Jump to bottom
Ihab Saloum edited this page Jan 9, 2026 · 3 revisions

Welcome to StepSyncAI 🌟

Your Personal Health & Wellness Companion

StepSyncAI is a comprehensive, privacy-first Progressive Web App (PWA) that helps you track and improve your mental health, medication adherence, sleep patterns, and exercise habits—all in one beautiful interface.

🚀 Quick Links

✨ Features

🧠 Mental Health Tracker

  • Mood logging with 1-10 scale and emoji visualization
  • Symptom tracking (anxiety, stress, fatigue, irritability, hopeful feelings)
  • Notes and journaling to capture daily experiences
  • Historical trends to identify patterns

💊 Medication Manager

  • Add medications with dosage and timing
  • Mark as taken with one tap
  • Drug interaction warnings for 65+ dangerous combinations
  • Dosage validation with universal safety checks (150+ medications in database)
  • Daily reminders to maintain adherence

😴 Sleep Tracker

  • Log bedtime and wake time automatically
  • Sleep quality rating (1-10 scale)
  • Calculate sleep hours and track debt
  • Weekly averages and streak tracking
  • Insights for better sleep hygiene

🏃 Exercise Logger

  • Track activities (walking, running, cycling, swimming, yoga, gym, sports, other)
  • Duration and intensity monitoring
  • Calorie estimates for different activities
  • Weekly goals and progress tracking
  • Motivational insights to stay active

📊 Wellness Dashboard

  • Overall wellness score (0-100) based on all metrics
  • Today's stats at a glance
  • 7-day trends chart (powered by Chart.js)
  • Activity streak visualization (last 30 days)
  • Personalized insights based on your data
  • Weekly progress bars for each category

🎨 Modern UI/UX

  • Dark/Light theme toggle
  • Glassmorphism effects and premium design
  • Responsive mobile-first design with bottom navigation
  • Smooth animations and transitions
  • Accessibility optimized with ARIA labels and keyboard navigation

📱 Progressive Web App (PWA)

  • Install as app on any device
  • Offline functionality with service worker caching
  • No app store required
  • Auto-updates when new features are released

📈 Stats

  • 1,927 automated tests with 82.55% coverage
  • 150+ medications in dosage validation database
  • 65+ drug interactions detected
  • 0 security vulnerabilities (regularly audited)
  • 100% client-side - your data never leaves your device

🔒 Privacy First

StepSyncAI is designed with privacy as the foundation:

  • ✅ 100% local storage - All data stored in your browser's localStorage
  • ✅ No servers - No data transmitted to external servers
  • ✅ No tracking - No analytics, cookies, or telemetry
  • ✅ No accounts - No sign-up, login, or personal information required
  • ✅ Export your data - Download all your data as JSON anytime
  • ✅ Full control - Delete all data with one click

Read more: Security & Privacy Policy

🛠️ Technology Stack

  • Frontend: Vanilla JavaScript (no framework dependencies)
  • Styling: CSS Variables with dark/light theme support
  • Storage: Browser localStorage (client-side only)
  • Visualization: Chart.js 4.4.1
  • PWA: Service Worker v4 with offline caching
  • Testing: 1,927 automated tests
  • CI/CD: GitHub Actions (Node 18.x, 20.x)

Learn more: Architecture

🎯 Use Cases

For Individuals

  • Track mood patterns to identify triggers
  • Ensure medication adherence with reminders
  • Improve sleep quality with data-driven insights
  • Maintain fitness goals with exercise tracking
  • Share wellness reports with healthcare providers

For Healthcare Professionals

  • Encourage patients to self-monitor between appointments
  • Review exported data (JSON format) for trends
  • Identify potential medication issues early
  • Track treatment effectiveness over time

For Researchers

  • Export anonymized wellness data
  • Study correlations between mood, sleep, exercise
  • Analyze medication adherence patterns
  • Test behavioral health interventions

📚 Documentation

Getting Started

  • Quick Start - Install and start tracking in 5 minutes
  • FAQ - Common questions answered

For Users

For Developers

For Everyone

🤝 Community

📄 License

StepSyncAI is open source and available under the MIT License.

See LICENSE for details.

🙏 Acknowledgments

Built with ❤️ by the StepSyncAI community.

Special thanks to:

  • All contributors who've helped improve the project
  • Users who've provided feedback and suggestions
  • Healthcare professionals who've validated medication safety features

Ready to start your wellness journey?

👉 Get Started Now or Try the Live Demo

Clone this wiki locally