A comprehensive health symptom tracking application designed to help patients document their symptoms, analyze life impacts, and prepare for doctor visits. Built with a modern glassmorphism UI and powered by Firebase.
- Features
- Tech Stack
- Getting Started
- Usage Guide
- Important Limitations
- Privacy and Security
- Medical Disclaimer
- License
- Commercial Use
- Third-Party Licenses
- Legal Disclaimer
- Support
- Click-to-select body region interface
- Visual feedback with animated selections
- Comprehensive anatomical coverage from head to toe
Track how symptoms affect daily life across five key categories:
- Work/School Impact - Productivity and attendance effects
- Sleep Quality - Rest and recovery patterns
- Social Activities - Impact on relationships and events
- Mobility - Physical movement and functional limitations
- Mood - Emotional wellbeing assessment
- Log bedtime and wake times with datetime precision
- Rate sleep quality on a 1-5 scale
- Track correlations between sleep patterns and symptoms
- Export sleep data as CSV for external analysis
- Upload symptom photos for visual documentation
- Maximum of 17 photos total across all symptoms
- Photos stored as base64-encoded strings in Firestore
- 1MB file size limit per photo
- Visual timeline with expandable image preview
- Auto-generate visit summaries based on symptom history
- Create and manage custom questions for healthcare providers
- Review symptom patterns and functional impact trends
- Export comprehensive medical reports with photos
- Professional PDF generation with embedded photos
- Customizable timeframes: 2 weeks, 1 month, 3 months, 6 months, or all time
- Summary statistics including severity averages and peak values
- Life impact analysis and sleep correlation insights
- Professional formatting suitable for healthcare providers
- Google Sign-In integration
- Email and password authentication
- Anonymous demo mode for evaluation
- Secure user data isolation by user ID
- Frontend: HTML5, CSS3 (Glassmorphism design), Vanilla JavaScript ES6+
- Backend: Firebase Firestore (NoSQL cloud database)
- Authentication: Firebase Authentication
- PDF Export: jsPDF 2.5.1
- Design: Modern glassmorphism with gradient animations and micro-interactions
Visit the live application at: https://zafeera123.github.io/nutribod-app/
No installation required - simply:
- Open the URL in your web browser
- Sign in using Google, Email, or try Anonymous demo mode
- Start tracking your symptoms immediately
- Modern web browser (Chrome, Firefox, Safari, or Edge)
- Internet connection
- JavaScript enabled
1. Authentication
- Select your preferred sign-in method: Google, Email/Password, or Anonymous
- Your health data is automatically isolated to your account
- Anonymous mode allows feature evaluation without account creation
2. Logging a Symptom
- Click on a body part in the interactive anatomical map
- Select the symptom type from the dropdown menu
- Adjust the severity slider (1-10 scale)
- Provide a detailed description of the symptom
- Complete the life impact assessment across all five categories
- Optionally upload a photo (must be under 1MB)
- Set the datetime when the symptom began
- Add any additional notes about triggers or patterns
- Click "Log Symptom" to save
3. Sleep Tracking
- Navigate to the Sleep tab in the main navigation
- Enter bedtime using the datetime picker
- Enter wake time using the datetime picker
- Rate overall sleep quality on a 1-5 scale
- Add notes about factors affecting sleep
- Click "Log Sleep" to save the entry
4. Reviewing History
- Navigate to the History tab
- View all logged symptoms in reverse chronological order
- Use filters to narrow by body region or specific date
- Review automatically generated pattern insights
- Click on photos to enlarge them
- Delete individual symptoms or bulk delete all data
5. Preparing for Appointments
- Go to the Appointment tab
- Enter doctor name and appointment datetime
- Add the primary reason for the visit
- Review the auto-generated visit summary with key statistics
- Add custom questions to discuss with your healthcare provider
- Generate and review the comprehensive visit summary
6. Generating Medical Reports
- Navigate to the Reports tab
- Select desired timeframe from dropdown
- Click "Generate Medical Report"
- Review the preview with statistics and insights
- Download PDF for printing or sharing with healthcare providers
- Maximum of 17 photos can be stored across all symptoms
- Each photo must be under 1MB in file size
- Photo upload functionality is completely disabled when the 17-photo limit is reached
- To upload new photos after reaching the limit, delete old symptoms containing photos
- Photo limit warning appears at 15 photos
- All data is stored in Firebase Firestore cloud database
- Photos are stored as base64-encoded strings
- Large collections of photos may impact application performance
- No local storage or offline functionality
- Requires modern browser with ES6+ JavaScript support
- Optimal experience on Chrome, Firefox, Safari, or Edge
- Internet connection required for all functionality
- Responsive design supports desktop, tablet, and mobile devices
- End-to-end user authentication via Firebase Auth
- All data isolated by unique user ID
- No cross-user data access or sharing
- Firestore security rules enforce user-level permissions
- HIPAA-aware design (consult legal counsel for full compliance verification)
- Anonymous mode available for privacy-conscious users
- Data stored on Google Cloud Platform infrastructure
- SSL/TLS encryption for data in transit
- Users can delete individual symptoms or all data
- Account deletion removes all associated data
- Export functionality allows data portability
IMPORTANT: This application is NOT HIPAA compliant in its current form. Healthcare providers should not use this application to store patient data subject to HIPAA regulations. This application is intended for personal use only.
CRITICAL: MedPrep Tracker is a documentation and organization tool only.
This application is NOT:
- A diagnostic tool
- A replacement for professional medical advice
- Suitable for medical emergencies
- A treatment recommendation system
This application IS:
- Designed to help you document symptoms
- A tool for organizing health information
- An aid for communicating with healthcare providers
- A preparation tool for medical appointments
IF YOU ARE EXPERIENCING A MEDICAL EMERGENCY, CALL 911 OR YOUR LOCAL EMERGENCY NUMBER IMMEDIATELY.
Always consult with qualified healthcare professionals for medical advice, diagnosis, and treatment. Do not use this application to self-diagnose or delay seeking professional medical care.
For complete medical and legal disclaimers, please read the DISCLAIMER.md file.
This project is licensed under a Custom License with specific terms for use, modification, and commercial distribution.
Copyright (c) 2025 Zafeer Ahmed. All rights reserved.
You MAY:
- ✓ Use the application at the provided URL for personal health tracking
- ✓ Modify the code for personal, educational, or non-profit use (with attribution)
- ✓ Create substantially modified versions for commercial use (with revenue sharing)
You MAY NOT:
- ✗ Use or distribute the original, unmodified software
- ✗ Sell or commercialize superficial modifications (branding/colors only)
- ✗ Use commercially without contacting the copyright holder
- ✗ Remove copyright notices or attribution
Key Requirements:
- Attribution Required: All modified versions must credit "Based on MedPrep Tracker by [Your Name]"
- No Verbatim Use: Original unmodified software cannot be used or distributed
- Commercial Use: Requires substantial modifications AND revenue sharing agreement
- Non-Commercial Use: Free for personal, educational, and non-profit use with attribution
See the complete LICENSE file for detailed terms and conditions.
If you want to create a commercial product based on MedPrep Tracker:
Requirements:
- Make substantial modifications to the software (not just branding changes)
- Contact the copyright holder before launch
- Negotiate revenue sharing agreement (typically 5-10% of gross revenue)
- Maintain attribution to the original project
- Comply with all license terms
Contact for Commercial Licensing:
- Email: nutribod135@gmail.com
- Subject: "MedPrep Tracker Commercial License Inquiry"
Include in your inquiry:
- Description of your planned modifications
- Intended use case and target market
- Expected revenue model
- Proposed revenue share percentage
We're open to fair negotiations that benefit both parties while respecting the original work.
This project uses the following third-party libraries and services:
- License: Apache License 2.0
- Copyright: Google LLC
- Used for: Authentication, Firestore Database, Cloud Storage
- License: MIT License
- Copyright: James Hall and contributors
- Used for: PDF report generation
For complete third-party license information and attributions, see THIRD-PARTY-LICENSES.md.
By using MedPrep Tracker, you acknowledge and agree to the following:
- This software is provided "AS IS" without warranty of any kind
- The developers are not liable for any health outcomes or decisions
- You use this application at your own risk
- You will seek professional medical advice for all health concerns
- This application is not HIPAA compliant and should not be used by healthcare providers for patient data
- You agree to comply with the custom license terms for any use or modification
For the complete legal disclaimer including liability limitations, privacy considerations, and terms of use, please read the DISCLAIMER.md file.
For issues, questions, or feature requests:
- Email: nutribod135@gmail.com
- Report Issues: Describe your problem including browser type and steps to reproduce
When reporting issues, include:
- Browser and version
- Steps to reproduce the problem
- Expected vs actual behavior
- Screenshots if helpful
For commercial use discussions:
- Email: nutribod135@gmail.com
- Subject: "MedPrep Tracker Commercial License Inquiry"
REMEMBER: This application:
- Is NOT a medical device
- Is NOT FDA approved
- Is NOT HIPAA compliant
- Should NOT be used for diagnosis
- Should NOT replace professional medical care
For medical emergencies, call 911 immediately.
MedPrep Tracker - Professional Health Documentation for Better Patient Care
This application assists in tracking and communicating symptoms. Always consult healthcare professionals for medical advice, diagnosis, and treatment.
Copyright (c) 2025 Zafeer Ahmed
Licensed under Custom License - See LICENSE file
Last Updated: January 2025
Version: 1.0.0