A comprehensive AI-powered health platform offering medical consultations, wellness planning, medication reminders, and emergency care assistance with multilingual support.
- Real-time chat with AI health assistant
- Natural language processing in 7+ languages
- Conversation history and continuity
- Medical disclaimer and safety guidelines
- Medical image analysis (X-rays, MRI, dermatology)
- Confidence scoring and findings analysis
- Actionable recommendations
- Privacy-focused processing
- Smart medication scheduling
- Adherence tracking and analytics
- Multiple time slots and frequencies
- Visual adherence charts
- Personalized health assessments
- AI-generated nutrition plans
- Custom fitness recommendations
- Mindfulness and stress management
- Weekly scheduling with PDF export
- Country-specific emergency contacts
- Interactive first-aid guides
- Symptom severity checker
- Hospital location finder
- Video-guided emergency procedures
- 7 languages: English, Arabic, Spanish, French, Japanese, Indonesian, Hindi
- RTL support for Arabic
- Localized medical terminology
- Cultural adaptations
- Next.js 15 - React framework with App Router
- TypeScript - Type-safe development
- Tailwind CSS - Utility-first styling
- Radix UI - Accessible component primitives
- React i18next - Internationalization
- Google Gemini AI - Medical reasoning and image analysis
- Firebase Auth - User authentication
- Firestore - Real-time database
- Next.js API Routes - Serverless backend
- Lucide React - Icon system
- Date-fns - Date manipulation
- React Hook Form - Form management
- Sonner - Toast notifications
- Node.js 18+
- pnpm (recommended) or npm
- Firebase project
- Google AI API key
- Clone the repository:
git clone https://github.com/yourusername/vitashifa.git
cd vitashifa- Install dependencies:
pnpm install- Set up environment variables:
cp .env.example .env.localAdd your configuration:
# Firebase Configuration
NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_domain
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_bucket
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id
# Firebase Admin (Base64 encoded service account)
FIREBASE_SERVICE_ACCOUNT_BASE64=your_base64_service_account
# Google AI
GEMINI_API_KEY=your_gemini_api_key-
Set up Firebase:
- Create a Firebase project
- Enable Authentication (Email/Password)
- Enable Firestore Database
- Generate service account key
-
Run the development server:
pnpm devOpen http://localhost:3000 to see the app.
├── app/ # Next.js App Router
│ ├── api/ # API routes
│ │ ├── ai-diagnosis/ # Image analysis
│ │ ├── medical-consultation/ # Chat API
│ │ ├── medication-reminders/ # Medication CRUD
│ │ └── wellness-planning/ # Wellness plans
│ ├── signin/ # Authentication pages
│ └── signup/
├── components/ # React components
│ ├── ui/ # Reusable UI components
│ ├── ai-diagnosis.tsx # Medical image analysis
│ ├── medical-consultation.tsx # Chat interface
│ ├── wellness-planning.tsx # Health assessments
│ └── dashboard-layout.tsx # Main layout
├── lib/ # Utilities and configuration
│ ├── firebase.ts # Firebase client
│ ├── firebaseAdmin.ts # Firebase admin
│ ├── i18n.ts # Internationalization
│ └── utils.ts # Helper functions
├── public/locales/ # Translation files
└── context/ # React context providers
- Context-aware conversations
- Medical reasoning with chain-of-thought
- Safety guardrails and disclaimers
- Multilingual medical terminology
- HIPAA-compliant processing
- Multi-modal AI analysis
- Confidence scoring
- Structured medical reports
- Personalized recommendations
- BMI and health metrics
- Activity level assessment
- Cultural dietary preferences
- Geolocation-based contacts
- Interactive first-aid videos
- Severity triage algorithms
- Multi-language emergency phrases
- Data Protection: No medical images stored permanently
- HIPAA Compliance: Privacy-first architecture
- Encryption: All data encrypted in transit and at rest
- Authentication: Secure Firebase Auth integration
- Disclaimers: Clear medical advice limitations
Supported languages with full localization:
- 🇺🇸 English (en)
- 🇸🇦 Arabic (ar) - RTL support
- 🇪🇸 Spanish (es)
- 🇫🇷 French (fr)
- 🇯🇵 Japanese (ja)
- 🇮🇩 Indonesian (id)
- 🇮🇳 Hindi (hi)
- Connect your GitHub repository
- Set environment variables in Vercel dashboard
- Deploy automatically on push
- Netlify: Set build command to
pnpm build - Railway: Dockerfile included
- Firebase Hosting: Static export supported
POST /api/medical-consultation
Content-Type: application/json
{
"message": "string",
"conversationId": "string (optional)",
"language": "string"
}
Response:
{
"reply": "string",
"conversationId": "string"
}POST /api/ai-diagnosis
Content-Type: application/json
{
"image": "string (base64)",
"language": "string"
}
Response:
{
"confidence": "number",
"findings": ["string"],
"recommendations": ["string"]
}GET /api/medication-reminders # List all reminders
POST /api/medication-reminders # Create reminder
PUT /api/medication-reminders/[id] # Update reminder
DELETE /api/medication-reminders/[id] # Delete reminder- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open Pull Request
- Follow TypeScript best practices
- Use existing UI components from
components/ui/ - Maintain i18n support for new features
- Add proper error handling and loading states
- Write descriptive commit messages
This project is licensed under the MIT License - see the LICENSE file for details.
VitaShifa is an AI-powered health information tool and should not replace professional medical advice, diagnosis, or treatment. Always consult qualified healthcare providers for medical concerns.
- Google AI for Gemini API
- Firebase for backend infrastructure
- Radix UI for accessible components
- The open-source community for amazing tools
For support, email support@vitashifa.com or join our Discord community.
Built with ❤️ for global health accessibility
- Integration with wearable devices
- Telemedicine video consultations
- Advanced AI models for better medical reasoning
- Integration with electronic health records
- Mobile app development
- Voice-based interactions
- Community health features
Mohammed Sameer Syed
📧 mohammedsameer@arizona.edu
Special thanks to Amine Montasir for his valuable contribution to this project.
📧 Aminemontasir8.5.2004@gmail.com