MediHelper is a comprehensive web application designed to help senior citizens and individuals with complex medication regimens manage their health more effectively. The application offers intuitive tools for medication management, appointment tracking, pill identification, health monitoring, and caregiver communication.
- My Medications: Track all your current medications in one place
- Add/Edit Medications: Easily add new medications or update existing ones with dosage, frequency, and timing information
- Medication Reminders: Never miss a dose with customizable reminder notifications
- Text Search: Find medications by name, markings, or physical characteristics
- Image Recognition: Upload photos of pills for automated identification
- Comprehensive Information: Get detailed information about identified medications including purpose, ingredients, and potential interactions
- Calendar View: See all upcoming appointments in an easy-to-read calendar
- Reminders: Get notified about upcoming appointments
- Scheduling: Add and manage healthcare appointments
- Adherence Tracking: Monitor medication compliance over time
- Health Metrics: Record and visualize vital health measurements
- Video Chat: Connect with caregivers and healthcare providers through integrated video calls
- Care Notes: Share important health updates with your care team
- Caregiver Access: Grant limited access to caregivers to help monitor medication adherence
- Brain Games: Simple cognitive exercises to keep the mind active
- Memory Tools: Memory aids and cognitive assistance features
- Frontend: React with TypeScript for type safety
- UI Framework: Tailwind CSS with shadcn/ui components
- Authentication: Supabase Auth
- Database: Supabase PostgreSQL
- API Integration: RxNav API for medication data
- State Management: React Context & TanStack Query
- Deployment: Lovable deployment system
- Node.js (v16+)
- npm or yarn
# Clone the repository
git clone <repository-url>
# Navigate to project directory
cd medihelper
# Install dependencies
npm install
# Start the development server
npm run devVisit http://localhost:5173 to see the application running locally.
- For iOS: macOS with Xcode 14+ installed
- For Android: Android Studio with SDK tools installed
- Capacitor CLI:
npm install -g @capacitor/cli
# Build the web app
npm run build
# Sync the build to the iOS project
npx cap sync ios
# Open the project in Xcode
npx cap open ios
# Run on simulator
npx cap run ios
# For a specific device
npx cap run ios --target="iPhone 14 Pro"
# Build for production
cd ios/App
xcodebuild -workspace App.xcworkspace -scheme App -configuration Release -sdk iphoneos build# Build the web app
npm run build
# Sync the build to the Android project
npx cap sync android
# Open the project in Android Studio
npx cap open android
# Run on emulator
npx cap run android
# For a specific device/emulator
npx cap run android --target="Pixel_5_API_31"
# Build APK for testing
cd android
./gradlew assembleDebug
# Build AAB for Play Store
./gradlew bundleRelease- Navigate to "My Medications"
- Click "Add New" to create a new medication entry
- Enter medication details including name, dosage, and schedule
- Save the medication to your profile
- Receive reminders based on your configured schedule
- Navigate to "Identify Pill"
- Either:
- Enter text description of the pill
- Upload an image of the pill
- Review the identification results
- Add the identified medication to your list if needed
- View all upcoming medication times in the Reminders section
- Mark medications as taken when complete
- Manage appointment schedule in the Calendar view
- Set up voice reminders for more accessible notifications
- ✅ Core medication management functionality
- ✅ Basic pill identification using RxNav API
- ✅ Reminders interface
- ✅ Video chat mockup
- ✅ User authentication
- ✅ Supabase database integration
- ✅ Activity logging
- 🔄 Enhanced pill identification with image analysis
- 🔄 Medication interaction checker
- 🔄 Health metrics dashboard
- 📅 Mobile app versions (iOS/Android)
- 📅 Voice assistant integration
- 📅 Pharmacy integration for automatic refills
- 📅 Wearable device synchronization
- 📅 AI-powered health insights
- 📅 Support for multiple languages
We welcome contributions to MediHelper! To contribute:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Please make sure to update tests as appropriate and adhere to the existing coding style.
MediHelper takes user privacy and data security seriously:
- All personal health information is encrypted
- Authentication is handled through secure providers
- No health data is shared with third parties without explicit consent
- Regular security audits are conducted
- HIPAA compliance guidelines are followed (in applicable regions)
This project is licensed under the MIT License - see the LICENSE file for details.
- RxNav API for medication data
- NIH for health information resources
- Supabase for backend infrastructure
- shadcn/ui for component library
- All contributors and beta testers
For help or questions, please:
- Open an issue in the GitHub repository
- Contact our support team at support@medihelper.com