New assignments will be announced at scheduled intervals. During that time, contributors may start working on issues based on their eligibility criteria.
- You should not have any active issue assigned to you.
- You must be the first eligible commenter or among the first inactive contributors (i.e., others may already have active issues assigned).
- The issue you choose must be relevant, non-duplicate, within GSSoC scope, and not part of admin-only tasks.
- You must be a registered GSSoC contributor to participate.
- Any security-related exposure or vulnerability should be reported immediately. Contributors are encouraged to raise such issues for the overall safety and improvement of the product.
- Admins have the authority to assign or reassign themselves to any active issue when required.
- Admin-only issues, including infrastructure, moderation, or sensitive system changes, are not eligible for general assignment.
- Any critical or high-priority system-level changes will be handled exclusively by the admin team.
I appreciate everyone’s interest in contributing.
A small note regarding participation and expectations: this project is maintained primarily by me as a single maintainer, so collaboration and review timelines may differ from larger teams.
This may not always be the ideal place to actively coordinate contributors, and contributors should consider possible delays before taking up work.
For this initiative, I’m contributing with limited availability (maximum ~3 hours/day), while balancing other responsibilities. Contributions are welcome, but they should align with this pace and maintain a healthy workflow.
Thank you for understanding and for your interest in the project.
Platform: React Native (Expo) — Android
- Added Sentry request body redaction to prevent credentials and sensitive health data from being exposed.
- Improved sensitive key detection for tokens, passwords, auth data, and similar fields.
- Hardened Axios auth handling to avoid sending invalid
Bearer undefined/nullheaders.
- Fixed TTS player staying visible after playback completion.
- Resolved Home feed pagination inconsistencies with selected categories and Saved filtering.
- Fixed keyboard overlap in comments input.
- Unified API timeout error messaging.
- Improved Podcast playback resume/rewind behavior.
- Fixed guest deep link routing for restricted screens.
- Corrected timezone parsing to preserve local time behavior.
- Integrated Sentry monitoring + safe network logging.
- Added centralized API timeout handling with fetch + Axios support.
- Improved accessibility support across multiple screens.
- Introduced custom audio waveform visualization for podcast playback.
- Migrated date utilities from moment → date-fns with locale support.
- Refactored Axios instance architecture for cleaner initialization.
- Improved TypeScript safety for AntDesign icons.
- Added ESLint cleanup and stricter Redux typing.
-
Added unit tests for:
- API timeout handling
- Date utilities
-
Removed production console noise and improved developer comments/logging.
- React Navigation Sentry instrumentation (requires navigation ref architecture changes).
- Future cleanup for scoped Jest mocks.
| 🧾 License | 🛠️ Frontend CI | 📱 Expo CI | 🌟 Stars |
|
|
&logo=expo&color=blue){kind=icon}
|
](https://github.com/SB2318/UltimateHealth/stargazers)
|
| 🍴 Forks | 🐛 Issues | 🔄 Open PRs | ✅ Closed PRs |
|
|
|
|
| 🤖 Android Build CI | 🍎 iOS Build CI | ⏱️ Last Commit | 📦 Repo Size |
|
|
|
|
UltimateHealth (also known as HealthGuide) is a fully open-source health library and article management platform that delivers trusted, multilingual wellness content to users worldwide.
It combines a React Native (Expo) mobile app, a Node.js REST API backend, a Python-powered content intelligence service, and a React web frontend — all working together to provide:
- Verified health articles authored and reviewed by the community
- AI-powered health chat assistant
- Health podcasts
- Multilingual content support
- A moderated, plagiarism-checked content pipeline
🌐 Live Platform: uhsocial.in | 📱 Android App: Play Store
| Feature | Description |
|---|---|
| 📝 Multilingual Articles | Write and read health content in any language |
| 🤝 Collaborative Reviews | Community editing, feedback & approval workflow |
| 🎙️ Health Podcasts | Publish and stream verified health podcasts |
| 🤖 AI Health Chat | AI-powered assistant for health-related queries |
| 📊 Contribution Analytics | Track your contribution impact |
| 🛡️ Content Integrity | Plagiarism detection, grammar checks & originality scoring |
| 🔒 Community Safety | Flagging system + RBAC for reviewers & admins |
| 🌐 Guest Mode | Read articles and listen to podcasts without signing in |
| 🔖 Content Preferences | Save preferences for a personalized experience |
| 🌍 Translation Support | Extend any article in your preferred language |
Admin Features: Interactive review dashboard, moderation tools & analytics.
(Video Tour)
| Layer | Technology |
|---|---|
| Framework | React Native + Expo |
| Language | TypeScript / JavaScript |
| State Management | Context API / Redux |
| Navigation | React Navigation |
| Build System | EAS Build (Expo Application Services) |
| CI/CD | GitHub Actions |
| Layer | Technology |
|---|---|
| Runtime | Node.js |
| Framework | Express.js |
| Database | MongoDB + Mongoose ODM |
| Authentication | JWT (JSON Web Tokens) |
| API Docs | Swagger — uhsocial.in/docs |
| Layer | Technology |
|---|---|
| Language | Python |
| Purpose | Plagiarism detection, grammar analysis, originality scoring |
| API Docs | uhsocial.in/content-intel/docs |
| Layer | Technology |
|---|---|
| Framework | React |
| Branch | web branch |
| Live URL | uhsocial.in/frontend/v2 |
UltimateHealth/ # Repository root
├── frontend/ # React Native (Expo) mobile app
│ ├── src/
│ │ ├── components/ # Reusable UI components
│ │ ├── screens/ # App screens/pages
│ │ ├── navigation/ # Navigation configuration
│ │ ├── services/ # API service calls
│ │ ├── context/ # React Context providers
│ │ └── utils/ # Helper utilities
│ ├── app.json # Expo app configuration
│ ├── package.json
│ └── ...
├── ieee-submodules/ # IEEE IGDTUW open source contributions
├── .github/ # GitHub Actions CI/CD workflows
│ └── workflows/
│ ├── frontend-ci.yml # Frontend lint/test pipeline
│ ├── eas-build.yml # Expo EAS build (Android + iOS)
│ ├── android-build-validation.yml
│ └── ios-build-validation.yml
├── .env.example # Environment variable template
├── setup-android.sh # Android environment setup script
├── CONTRIBUTING.md # Contribution guidelines
├── CODE_OF_CONDUCT.md # Code of conduct
├── TEST_GUIDELINES.md # Testing guidelines
├── Learn.md # Learning resources
├── LICENSE # MIT License
└── README.md # This file
Note: The backend (Node.js + MongoDB) and web frontend (React) live in separate repositories/branches. See Services & Dependencies below.
Make sure you have the following installed before proceeding:
| Tool | Version | Purpose |
|---|---|---|
| Node.js | >= 18.x | JavaScript runtime |
| Yarn | >= 1.22.x | Package manager |
| Git | Latest | Version control |
| Expo CLI | Latest | Mobile app tooling |
| Android Studio | Latest | Android emulator & SDK |
| Xcode | Latest (macOS only) | iOS simulator |
npm install -g expo-cli eas-cliA convenience script is included to automate Android environment setup:
chmod +x setup-android.sh
./setup-android.shThis sets up required Android SDK paths and environment variables.
# Fork the repo on GitHub, then clone your fork:
git clone https://github.com/<your-username>/UltimateHealth.git
cd UltimateHealthcp .env.example .env
# Edit .env and fill in the required values (API URLs, keys, etc.)
⚠️ Never commit your.envfile. It is already listed in.gitignore.
cd frontend
yarn installnpx expo prebuild --clean
npx expo run:androidnpx expo prebuild --clean
npx expo run:iosnpx expo startThen scan the QR code with the Expo Go app on your phone.
1. Fork the repository
2. Create a new branch from `main`
git checkout -b feat/your-feature-name
3. Make your changes & commit
git add .
git commit -m "feat: describe your change"
4. Push your branch
git push origin feat/your-feature-name
5. Open a Pull Request → target: main branch
6. Wait for CI checks to pass & request a review
| Prefix | Use for |
|---|---|
feat/ |
New features |
fix/ |
Bug fixes |
docs/ |
Documentation updates |
refactor/ |
Code refactoring |
test/ |
Tests |
chore/ |
Build scripts, CI, tooling |
Follow Conventional Commits:
feat: add multilingual article support
fix: resolve crash on podcast playback
docs: update README environment setup
cd frontend
npx expo start --dev-clientBuilds are triggered automatically via GitHub Actions on pushes to main. You can also trigger them manually:
# Android APK/AAB
eas build --platform android --profile production
# iOS IPA (macOS + Apple Developer account required)
eas build --platform ios --profile production| Workflow | Trigger | Purpose |
|---|---|---|
frontend-ci.yml |
Push / PR to main |
Lint & type-check |
eas-build.yml |
Push to main |
Expo EAS build (Android + iOS) |
android-build-validation.yml |
Push / PR | Android build validation |
ios-build-validation.yml |
Push / PR | iOS build validation |
| Service | URL | Purpose |
|---|---|---|
| REST API | uhsocial.in/docs | Backend API (Node.js + MongoDB) |
| Content Intelligence | uhsocial.in/content-intel/docs | Plagiarism + grammar checks (Python) |
| Web Frontend | uhsocial.in/frontend/v2 | React web app (see web branch) |
| Android App | Play Store | Published Android app |
The backend and content intelligence service are hosted separately. For local development, update your
.envfile to point to either the live APIs or locally running services.
We welcome contributions from everyone — developers, designers, writers, and testers!
- Check open issues or create a new one
- Comment on the issue to get it assigned
- Follow the Development Workflow above
- Read CONTRIBUTING.md for detailed guidelines
- Follow the Code of Conduct
- Follow TEST_GUIDELINES.md when adding tests
- 🐛 Bug reports & fixes
- ✨ New features
- 📝 Health article writing & review
- 🌍 Translations
- 📖 Documentation improvements
- 🎨 UI/UX enhancements
- 🧪 Testing (Android app / web platform)
📖 For detailed PR guidelines, code style, and review process — read CONTRIBUTING.md.
| Event | Description |
|---|---|
 |
GirlScript Summer of Code 2026 3-month open source program empowering next-generation developers through real-world contributions |
 |
IEEE IGDTUW Open Source Week November 12–18 |
 |
Vultr Cloud Innovate Hackathon Build innovative solutions using Vultr cloud |
|
GirlScript Summer of Code 2024 3-month open source program for beginners |
- Backend Repository: ultimatehealth-backend
- Admin Repository: ultimatehealth-admin
- Content Checker Repository: content-checker
Made with ❤️ by the UltimateHealth Community
⭐ Star this repo if you find it helpful — it motivates us to keep building!