🧠 MindTrackAI - Mental Health & Wellness Tracking Platform

A production-grade mental health & wellness tracking platform with AI-powered insights, FDA-validated medication safety, and comprehensive privacy protection.

🎯 Try it now → https://isaloum.github.io/MindTrackAI

📚 Documentation • Quick Start • Architecture • Privacy & Security • FAQ

Features • Tech Stack

🎯 What Is This?

A full-stack health and wellness platform that integrates 6 specialized applications into one unified system. Built with test-driven development (82% coverage, 1,927 tests), CI/CD automation, and production-ready code quality.

🚀 Quick Stats

📊 1,927 Automated Tests (100% passing)
🎯 82.55% Test Coverage
⚡ 37 Test Suites
🔒 0 Security Vulnerabilities
🤖 CI/CD with GitHub Actions (Node 18.x & 20.x)
📦 6 Integrated Applications

✨ Features At A Glance

Application	Purpose	Key Features
🧠 Mental Health Tracker	PTSD/trauma recovery support	Mood tracking, symptom monitoring, correlation analysis, insights
💊 Medication Tracker	Medication management	Adherence tracking, drug interaction warnings (65+ interactions), reminders
😴 Sleep Tracker	Sleep pattern analysis	Quality tracking, duration analysis, sleep debt calculation
🏃 Exercise Tracker	Fitness monitoring	Activity logging, goal tracking, intensity levels
📊 Daily Dashboard	Unified wellness overview	0-100 wellness score, correlations, trends, smart recommendations
☁️ AWS Study Guide	Cloud certification prep	20+ concepts, practice quizzes, progress tracking

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                    StepSyncAI Platform                       │
└─────────────────────────────────────────────────────────────┘

┌─────────────────┐    ┌─────────────────┐    ┌──────────────┐
│   Mental Health │    │   Medication    │    │    Sleep     │
│     Tracker     │    │     Tracker     │    │   Tracker    │
│                 │    │                 │    │              │
│  • Mood logs    │    │  • Med schedule │    │  • Duration  │
│  • Symptoms     │    │  • Adherence    │    │  • Quality   │
│  • Insights     │    │  • Interactions │    │  • Patterns  │
└────────┬────────┘    └────────┬────────┘    └──────┬───────┘
         │                      │                     │
         └──────────────────────┼─────────────────────┘
                                │
                    ┌───────────▼────────────┐
                    │   Daily Dashboard API   │
                    │                         │
                    │  • Data Aggregation     │
                    │  • Wellness Scoring     │
                    │  • Correlation Engine   │
                    │  • Trend Analysis       │
                    │  • Smart Recommendations│
                    └───────────┬─────────────┘
                                │
         ┌──────────────────────┼─────────────────────┐
         │                      │                     │
┌────────▼────────┐    ┌────────▼────────┐    ┌─────▼──────┐
│    Exercise     │    │   AWS Learning  │    │  Reminder  │
│    Tracker      │    │      Guide      │    │  Service   │
│                 │    │                 │    │            │
│  • Activities   │    │  • Lessons      │    │  • Cron    │
│  • Goals        │    │  • Quizzes      │    │  • Notifs  │
│  • Intensity    │    │  • Progress     │    │  • Alerts  │
└─────────────────┘    └─────────────────┘    └────────────┘

           ┌──────────────────────────────────┐
           │    Data Layer (JSON Storage)     │
           │                                  │
           │  • Local-first architecture      │
           │  • Privacy-preserving            │
           │  • Backup & restore support      │
           └──────────────────────────────────┘

           ┌──────────────────────────────────┐
           │      CI/CD Pipeline              │
           │                                  │
           │  • GitHub Actions                │
           │  • Multi-version testing         │
           │  • Security audits               │
           │  • Quality gates                 │
           └──────────────────────────────────┘

💻 Tech Stack

Backend & Core

- Runtime environment
- Modern JS features
- Testing framework (1,927 tests!)

Testing & Quality

Test Coverage: 82.55% statements, 90.56% functions
Test Suites: 37 comprehensive test files
Test Types: Unit, integration, error handling, edge cases
CI/CD: GitHub Actions with automated testing

Data & Storage

JSON-based local storage (privacy-first)
Backup & restore system
CSV/JSON/PDF export capabilities

Notifications & Scheduling

node-cron - Scheduled reminders
node-notifier - Desktop notifications
Cross-platform support (Windows, macOS, Linux)

CLI & Visualization

chalk - Colored terminal output
cli-table3 - Beautiful tables
asciichart - ASCII charts & graphs
pdfkit - Professional PDF reports

DevOps

GitHub Actions CI/CD
Multi-version Node.js testing (18.x, 20.x)
Automated security audits
Quality gates enforcement

🎓 What I Learned

Building this project taught me:

Backend Development

✅ RESTful API design patterns
✅ Data modeling and relationships
✅ File-based storage systems
✅ Error handling and validation

Test-Driven Development (TDD)

✅ Writing comprehensive test suites (1,927 tests!)
✅ Achieving high test coverage (82%+)
✅ Unit vs integration testing strategies
✅ Mocking and test isolation

DevOps & CI/CD

✅ GitHub Actions workflows
✅ Multi-environment testing
✅ Automated quality gates
✅ Security vulnerability scanning

Software Architecture

✅ Modular design patterns
✅ Service integration
✅ Data aggregation & correlation
✅ Scalable architecture planning

Product Development

✅ User-centric feature design
✅ Data privacy considerations
✅ Healthcare data handling
✅ Professional-grade documentation

🚀 Quick Start

Prerequisites

node --version  # v18.x or v20.x required
npm --version

Installation

# Clone the repository
git clone https://github.com/Isaloum/StepSyncAI.git
cd StepSyncAI

# Install dependencies
npm install

# Run tests to verify installation
npm test

Usage

# Mental Health Tracker
npm run mental

# Medication Tracker
npm run med

# Daily Dashboard (unified view)
node daily-dashboard.js daily

# AWS Study Guide
npm run aws

📊 Testing

Run Tests

# All tests (1,927 tests)
npm test

# With coverage report
npm run test:coverage

# Watch mode
npm run test:watch

Test Coverage Breakdown

Module	Statements	Functions	Lines
Mental Health	86.23%	98.08%	85.42%
Medication	89.33%	96.61%	88.84%
Sleep Tracker	88.23%	98.18%	87.66%
Exercise	81.69%	100%	81.29%
Dashboard	67.91%	79.53%	67.30%
Reminder Service	100% 🎯	100% 🎯	100% 🎯
Overall	82.55%	90.56%	82.34%

🔄 CI/CD Pipeline

Automated quality checks on every commit:

✅ Multi-Version Testing - Node 18.x & 20.x ✅ Automated Tests - 1,927 tests run automatically ✅ Security Audits - Dependency vulnerability scanning ✅ Quality Gates - Coverage thresholds enforced ✅ Lint Checks - Code quality verification

See .github/workflows/ci.yml for pipeline configuration.

📸 Screenshots

Daily Dashboard

╔════════════════════════════════════════════════════════════╗
║           📊 DAILY WELLNESS DASHBOARD                      ║
╚════════════════════════════════════════════════════════════╝

📅 Monday, December 8, 2025

┌─────────────────────────────────────────────────────────┐
│  😊  OVERALL WELLNESS: 78.5/100 (78.5%) - Good          │
└─────────────────────────────────────────────────────────┘

📊 Score Breakdown:

  🧠 Mood:        [████████████████░░░░] 20/25
     Current: 8/10

  😴 Sleep:       [███████████████████░] 23.5/25
     Last: 8.0h, Quality: 9/10

  🏃 Exercise:    [████████████████░░░░] 20/25
     Today: 25 min (Goal: 30 min)

  💊 Medication:  [███████████████░░░░░] 15/25
     Adherence: 60%

💡 Today's Recommendations:
  ✅ 🌟 Your mood is looking great! Keep up the good work.
  🟡 🏃 You're averaging 25 min/day. Try to reach 30 minutes.
  🔴 💊 Medication adherence is at 60%. Consistency is key.

Test Results

Test Suites: 37 passed, 37 total
Tests:       1927 passed, 1927 total
Snapshots:   0 total
Time:        8.5s

Coverage Summary:
  Statements   : 82.55% ( 3418/4140 )
  Branches     : 68.74% ( 968/1408 )
  Functions    : 90.56% ( 385/425 )
  Lines        : 82.34% ( 3354/4074 )

🏆 Key Achievements

Code Quality

🎯 1,927 Automated Tests - Comprehensive test coverage
✅ 82.55% Coverage - High code quality standards
🔒 0 Vulnerabilities - Security-first development
🤖 CI/CD Pipeline - Automated quality gates

Features

📊 6 Integrated Apps - Mental health, medication, sleep, exercise, dashboard, AWS learning
🔗 Correlation Engine - Discover patterns in health data
📈 Trend Analysis - 8-week progress visualization
💡 Smart Insights - AI-like pattern detection
⚠️ Drug Interactions - 65+ dangerous interaction warnings

Architecture

🏗️ Modular Design - Clean separation of concerns
📦 Service Integration - Unified dashboard API
🔄 Backup System - Data protection & recovery
📤 Multi-Format Export - CSV, JSON, PDF with charts

📦 Project Structure

StepSyncAI/
├── 📁 __tests__/               # 37 test suites, 1927 tests
│   ├── mental-health-tracker.test.js
│   ├── medication-tracker.test.js
│   ├── daily-dashboard.test.js
│   └── ... (34 more test files)
│
├── 🏥 Core Applications
│   ├── mental-health-tracker.js    # 92K lines - comprehensive tracker
│   ├── medication-tracker.js       # 55K lines - drug interaction system
│   ├── sleep-tracker.js           # 19K lines - sleep analysis
│   ├── exercise-tracker.js        # 10K lines - fitness tracking
│   ├── daily-dashboard.js         # 192K lines - unified platform
│   └── aws-for-kids.js           # 85K lines - AWS certification prep
│
├── 🔧 Services & Utils
│   ├── reminder-service.js        # 100% test coverage!
│   ├── backup-manager.js
│   ├── export-manager.js
│   ├── analytics-engine.js
│   └── validation-utils.js
│
├── ⚙️ Configuration
│   ├── .github/workflows/ci.yml  # CI/CD pipeline
│   ├── package.json
│   └── eslint.config.js
│
└── 📚 Documentation
    ├── README.md                 # This file
    ├── TESTING_README.md        # Testing guide
    └── CONTRIBUTING.md          # Contribution guidelines

🔮 Future Roadmap

Phase 1: AWS Deployment (Next)

Convert to serverless architecture (Lambda + DynamoDB)
Deploy to AWS with API Gateway
Add Cognito authentication
Setup CloudWatch monitoring

Phase 2: Web Interface

React frontend
Real-time data sync
Responsive mobile design
Progressive Web App (PWA)

Phase 3: Advanced Features

Multi-user support
Machine learning insights
Health device integration
Telemedicine integration

🤝 Contributing

Contributions welcome! Please read CONTRIBUTING.md for guidelines.

Development Workflow

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Write tests for new features
Ensure tests pass (npm test)
Commit changes (git commit -m 'Add amazing feature')
Push to branch (git push origin feature/amazing-feature)
Open a Pull Request

Quality Standards

✅ All tests must pass
✅ Maintain 80%+ test coverage
✅ Follow existing code style
✅ Update documentation

📝 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built with ❤️ to support personal health, wellness, and professional development.

Technologies Used:

Node.js for runtime
Jest for testing framework
GitHub Actions for CI/CD
Various NPM packages for functionality

Special Thanks:

Mental health professionals who inspired this project
Open source community for amazing tools
Healthcare workers on the front lines

📞 Contact & Support

Project Links

GitHub: Isaloum/StepSyncAI
Issues: Report a Bug
Discussions: Feature Requests

Mental Health Resources

National Suicide Prevention Lifeline: 988
Crisis Text Line: Text HOME to 741741
SAMHSA National Helpline: 1-800-662-4357

📈 Project Stats

Version: 3.12.0 Status: ✅ Active Development Last Updated: December 2025 Test Suite: 1,927 tests passing Coverage: 82.55%

⚠️ Important Note

This tool is designed to support your wellness journey, not replace professional medical care. Always consult healthcare professionals for medical advice.

## 👨‍💻 Author

Ihab Saloum

Building production-grade applications • Test-Driven Development • AWS Cloud Solutions

⭐ Support

If this project helped with your wellness journey or inspired your own projects:

⭐ Star this repository
🔀 Share it with others
📝 Provide feedback via issues
🤝 Contribute improvements

Name		Name	Last commit message	Last commit date
Latest commit History 590 Commits
.github		.github
__mocks__		__mocks__
__tests__		__tests__
docs		docs
examples		examples
src		src
wiki-content		wiki-content
.gitignore		.gitignore
AI_VS_USER_ACTIONS.md		AI_VS_USER_ACTIONS.md
AUDIT_COMPLETE.md		AUDIT_COMPLETE.md
AWS-FOR-KIDS-README.md		AWS-FOR-KIDS-README.md
BUMPIE_MEDS_ARCHITECTURE.md		BUMPIE_MEDS_ARCHITECTURE.md
BUMPIE_MEDS_READY.md		BUMPIE_MEDS_READY.md
CHANGELOG.md		CHANGELOG.md
COMPLETE_STATUS_CHECK.md		COMPLETE_STATUS_CHECK.md
CONTRIBUTING.md		CONTRIBUTING.md
DEPLOYMENT_READY.md		DEPLOYMENT_READY.md
DRUG_INTERACTION_MODULE.md		DRUG_INTERACTION_MODULE.md
FRIDAYAI_SECURITY_FIX.md		FRIDAYAI_SECURITY_FIX.md
FRIDAYAI_TRANSFORMATION_PLAN.md		FRIDAYAI_TRANSFORMATION_PLAN.md
FUNCTION_EXTRACTION_MAP.md		FUNCTION_EXTRACTION_MAP.md
INTEGRATION_GUIDE_BUMPIE_MEDS.md		INTEGRATION_GUIDE_BUMPIE_MEDS.md
LICENSE		LICENSE
MAC_COPY_INSTRUCTIONS.sh		MAC_COPY_INSTRUCTIONS.sh
MEDICATIONS_DROPDOWN_FIX.md		MEDICATIONS_DROPDOWN_FIX.md
MEDICATIONS_INTEGRATION_GUIDE.md		MEDICATIONS_INTEGRATION_GUIDE.md
MIGRATION_PLAN.md		MIGRATION_PLAN.md
PHASE_1_COMPLETE.md		PHASE_1_COMPLETE.md
PREGNANCY_INTEGRATION_SUMMARY.md		PREGNANCY_INTEGRATION_SUMMARY.md
PRE_LAUNCH_ACTION_PLAN.md		PRE_LAUNCH_ACTION_PLAN.md
PRODUCT_HUNT_LAUNCH.md		PRODUCT_HUNT_LAUNCH.md
PR_DESCRIPTION.md		PR_DESCRIPTION.md
PR_FIXES_DESCRIPTION.md		PR_FIXES_DESCRIPTION.md
QUICK_REFERENCE.md		QUICK_REFERENCE.md
QUICK_WINS_SUMMARY.md		QUICK_WINS_SUMMARY.md
README.md		README.md
SECURITY.md		SECURITY.md
SETUP_ON_MAC.md		SETUP_ON_MAC.md
TAXSYNCQC_TRANSFORMATION_PLAN.md		TAXSYNCQC_TRANSFORMATION_PLAN.md
TEST_VALIDATION_COMPLETE.md		TEST_VALIDATION_COMPLETE.md
add_questions.py		add_questions.py
analytics-cli.js		analytics-cli.js
analytics-engine.js		analytics-engine.js
automation-cli.js		automation-cli.js
automation-manager.js		automation-manager.js
aws-for-kids.js		aws-for-kids.js
awsprepai-READY-TO-DEPLOY.html		awsprepai-READY-TO-DEPLOY.html
awsprepai-multicert.html		awsprepai-multicert.html
awsprepai.html		awsprepai.html
backup-cli.js		backup-cli.js
backup-manager.js		backup-manager.js
chart-utils.js		chart-utils.js
copy-to-bumpie.sh		copy-to-bumpie.sh
daily-dashboard.js		daily-dashboard.js
drug-interaction-checker.js		drug-interaction-checker.js
drug-interactions-database.json		drug-interactions-database.json
enhanced-medication-manager.js		enhanced-medication-manager.js
eslint.config.js		eslint.config.js
example-integration.js		example-integration.js
exercise-tracker.js		exercise-tracker.js
export-manager.js		export-manager.js
goal-cli.js		goal-cli.js
goal-manager.js		goal-manager.js
index.js		index.js
insert_test5.py		insert_test5.py
medication-db.js		medication-db.js
medication-enrichment.js		medication-enrichment.js
medication-interactions.json		medication-interactions.json
medication-selection-ui.js		medication-selection-ui.js
medication-tracker-enhanced.js		medication-tracker-enhanced.js
medication-tracker.js		medication-tracker.js
medication-validator.js		medication-validator.js
medications-db.json		medications-db.json
mental-health-tracker.js		mental-health-tracker.js
package-lock.json		package-lock.json
package.json		package.json
parse_test6.py		parse_test6.py
performance-cache.js		performance-cache.js
pregnancy-api-server.js		pregnancy-api-server.js
reminder-cli.js		reminder-cli.js
reminder-manager.js		reminder-manager.js
reminder-service.js		reminder-service.js
report-generator.js		report-generator.js
setup.js		setup.js
sleep-tracker.js		sleep-tracker.js
steps.log		steps.log
test_medication_validation.html		test_medication_validation.html
test_validation_direct.html		test_validation_direct.html
validation-utils.js		validation-utils.js
visualization-cli.js		visualization-cli.js

License

Isaloum/MindTrackAI

Folders and files

Latest commit

History

Repository files navigation