UltimateHealth

UltimateHealth — Open-Source Health Intelligence Platform

A fully open-source health library, article management, and AI-powered wellness platform delivering trusted, multilingual content worldwide.

🧾 License	🛠️ Frontend CI	📱 Expo CI	🌟 Stars	👀 Views
🍴 Forks	🐛 Issues	🔄 Open PRs	✅ Closed PRs
🤖 Android Build CI	🍎 iOS Build CI	⏱️ Last Commit	📦 Repo Size

APP and WEB UPDATE:

1. GSSOC CONTRIBUTOR’S TASK LIVE with new authentication system (UPCOMING, NEXT WEEK)
2. New Article Publish

UltimateHealth has now moved to a new domain! 🚀

Some broken links may still exist on the server due to references to our old URL. We’re already working on it, and everything will be resolved in the next update.

📛 Repository Badges Explained

The badges displayed at the top of this README provide a quick overview of the repository’s health, activity, and development status.

Maintainer Notice

Table of Contents

• 🌟 UltimateHealth (HealthGuide)
• 📢 Maintainer Notice
• 📛 Repository Badges Explained
• 📖 About the Project
• 🏗️ Architecture Overview
• ✨ Features
• 🧩 Feature-to-Technology Mapping
• 🛠️ Tech Stack
• 📱 Platform Support
• 📊 Code Quality
• 🚀 Latest Releases
• 🗺️ Project Roadmap & Release Pipeline
• ⚙️ Getting Started
• 🔧 Environment Setup
• 🧩 Version Compatibility Matrix
• 🚀 Installation
• 📖 Glossary
• 📁 Project Structure
• 🔁 Development Workflow
• 🏗️ Build & Deployment
• 🔌 Services & API Dependencies
• 🤖 Automation & Bot System
• 🤝 Contribution Workflow
• 🔗 Submodule Repositories
• 🤝 Contribution Guidelines
• 🚀 Programs Participated In
• 📚 Blogs & Resources
• ❤️ Our Contributors

📖 Overview

Our AI bot suite handles the initial pipeline automatically. See Automation & Bot System for a full breakdown.

Documentation update for issue #2224.

About the Project

UltimateHealth (also known as HealthGuide) is a fully open-source platform that combines a React Native mobile app, a Next.js web frontend, a Node.js REST API, and a Python content intelligence service — all working together to deliver trusted health content worldwide.

Live Platform: ultimatehealth.blog  |  Android App: Play Store

🏗️ Architecture Overview

UltimateHealth is organized into multiple components, each responsible for a specific part of the platform. These components communicate through the backend API to provide a consistent experience across mobile and web applications.

                     UltimateHealth
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
        ▼                  ▼                  ▼
React Native App     Next.js Web App    Documentation
        │                  │
        └──────────┬───────┘
                   ▼
            Node.js REST API
                   │
         ┌─────────┴─────────┐
         ▼                   ▼
      MongoDB      Python Content
                   Intelligence Service

Where to Contribute

• Mobile features → frontend/
• Backend functionality → Node.js backend repository
• Content intelligence → Python content service repository
• Documentation → README.md and docs/

Features

Admin Features: Interactive review dashboard, moderation tools and analytics.

🧩 Feature-to-Technology Mapping

The following table explains which technologies power different features of UltimateHealth. This helps contributors identify the correct project area when contributing to a specific feature.

Tech Stack

📱 Platform Support

UltimateHealth is designed to support both development and end-user deployment across multiple platforms. The following table summarizes the officially supported platforms and any platform-specific requirements.

Note: Android, iOS, and Web are officially supported deployment platforms. Windows, Linux, and macOS are supported development environments.

Latest Releases

🗺️ Project Roadmap & Release Pipeline

Following our October 2026 Core Release (v3.2.0), the next product releases follow a milestone-driven pipeline to systematically activate, polish, and deploy all currently hidden and newly integrated modules.

📅 Release Pipeline & Deadlines

📋 Feature Implementation & Visibility Status

Getting Started

Prerequisites

The following tools are required for setting up the development environment:

Version Compatibility Matrix

The following versions are recommended for a smooth development setup. Using these versions helps avoid compatibility issues during installation and development.

Installation

1. Fork and Clone

git clone https://github.com/<your-username>/UltimateHealth.git
cd UltimateHealth

2. Configure Environment

cp .env.example .env
# Edit .env with your API URLs and keys

Never commit your .env file. It is already in .gitignore.

3. Install Dependencies

cd frontend
yarn install

4. Install Expo and EAS CLI

npm install -g expo-cli eas-cli

5. Android SDK Setup (Linux/macOS)

chmod +x setup-android.sh
./setup-android.sh

Skip this step if you only plan to preview the app via Expo Go (step 6 below) rather than building natively.

6. Run the App

# Android
npx expo prebuild --clean
npx expo run:android

# iOS (macOS only)
npx expo prebuild --clean
npx expo run:ios

# Quick preview via Expo Go
npx expo start

Common Commands

The following commands are commonly used during local development.

Glossary

• Expo – A framework and toolset for building React Native applications.
• EAS – Expo Application Services used to build and deploy Expo apps.
• CI/CD – Automated workflows that test and deploy code changes.
• JWT – JSON Web Token used for secure user authentication.
• RBAC – Role-Based Access Control manages user permissions based on roles.
• Swagger – A tool for documenting and testing REST APIs.
• MongoDB – A NoSQL database used to store application data.
• REST API – An interface that allows applications to communicate over HTTP.
• API – Application Programming Interface that enables communication between software systems.
• README – The main documentation file that explains the project setup and usage.

Project Structure

UltimateHealth/
├── frontend/                    # React Native (Expo) mobile app
│   ├── src/
│   │   ├── components/          # Reusable UI components
│   │   ├── screens/             # App screens and pages
│   │   ├── navigation/          # Navigation configuration
│   │   ├── services/            # API service calls
│   │   ├── context/             # React Context providers
│   │   └── utils/               # Helper utilities
│   ├── app.json
│   └── package.json
├── ieee-submodules/             # IEEE IGDTUW open source contributions
├── .github/
│   ├── workflows/               # GitHub Actions CI/CD and Bot workflows
│   └── scripts/                 # AI bot Python scripts
├── docs/                        # Documentation files
├── .env.example
├── setup-android.sh
├── BACKEND_SETUP.md         
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── Learn.md
└── README.md

The backend (Node.js + MongoDB) and web frontend (React) live in separate repositories. See Services and Dependencies.

Development Workflow

1. Fork the repository
2. Create a feature branch from main
      git checkout -b feat/your-feature-name
3. Make your changes and 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 targeting the main branch
6. Wait for CI + AI bot review, then request human review

Branch Naming

Commit Messages

Follow Conventional Commits:

feat: add multilingual article support
fix: resolve crash on podcast playback
docs: update README environment setup
chore: update GitHub Actions workflow

Build & Deployment

Local Development

cd frontend
npx expo start --dev-client

Production Build via EAS

# Android APK/AAB
eas build --platform android --profile production

# iOS IPA (macOS + Apple Developer account required)
eas build --platform ios --profile production

Builds are also triggered automatically via GitHub Actions on pushes to main.

🧪 Testing

UltimateHealth includes a comprehensive test suite covering components, hooks, utilities, and Redux slices. The tests use Jest and React Native Testing Library (RNTL).

• Available Tests: 456 tests across 130 test suites.
• Coverage & Purpose: The test suite validates core UI components (screens, cards, buttons), custom hooks (API data fetching and mutations), Redux state management (User, Network, Data slices), and helper services (date utilities, platform notifications).
• Current Status: (130/130 suites passing)

Running Tests Locally

cd frontend
yarn test

For more details on our testing standards, refer to TEST_GUIDELINES.md.

Services & API Dependencies

Submodule Repositories

For local development, update your .env to point to either the live APIs or locally running services.

🛠️ Troubleshooting

1. Android SDK Path Not Found

Error:

ANDROID_HOME is not set or SDK not found

Fix:

# Add to ~/.bashrc or ~/.zshrc
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/platform-tools

# Then reload
source ~/.bashrc

2. Expo Go Version Mismatch

Error:

SDK version mismatch — project uses SDK X but Expo Go supports SDK Y

Fix:

• Update Expo Go on your device to the latest version from Play Store / App Store
• Or use a Development Build instead of Expo Go:

  npx expo start --dev-client

3. Metro Bundler Port Conflict

Error:

Port 8081 is already in use

Fix:

# Kill the process using port 8081
npx kill-port 8081

# Or start Metro on a different port
npx expo start --port 8082

4. iOS Build Failing Without Apple Developer Account

Error:

No signing certificate or provisioning profile found

Fix:

• iOS builds require a paid Apple Developer Account ($99/year)
• For local testing without an account, use the iOS Simulator on macOS:

npx expo start --simulator

For production iOS builds, configure credentials via EAS:

eas credentials

5. yarn install Failing / Dependency Conflicts

Error:

Cannot find module or peer dependency conflict

Fix:

# Clear cache and reinstall
rm -rf node_modules
yarn cache clean
yarn install

6. npx expo prebuild Errors

Error:

Native project already exists

Fix:

# Use --clean flag to reset native project
npx expo prebuild --clean

7. Node.js Version Incompatibility

Error:

Unsupported engine — expected Node >= 18.x

Fix: Use nvm (Node Version Manager) to switch versions easily:

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Install and use correct Node version
nvm install 18
nvm use 18

Or use fnm (Fast Node Manager) as a lighter alternative:

fnm use 18

Automation & Bot System

This repository uses a custom suite of AI-powered GitHub Actions bots to automate the contribution pipeline. Every issue and PR goes through this automated system before any human review.

Critical    -- Must fix before merge
Important   -- Should fix
Suggestions -- Optional improvements

🤝 Contribution Workflow

New to open source? Follow this simple workflow to contribute to UltimateHealth.

This workflow summarizes the standard contribution process for all new contributors. Following these steps helps ensure a smooth review and merge process.

Contribution Steps

1. Find an open issue that matches your interests or skills.
2. Request assignment by commenting on the issue.
3. Fork the repository to your GitHub account.
4. Create a new feature or documentation branch.
5. Make your changes and test them.
6. Submit a Pull Request.
7. Wait for CI checks and maintainer review.
8. Once approved, your contribution will be merged.

Contributing

We welcome contributions from everyone — developers, designers, writers, and testers!

How to Contribute

1. Browse open issues or create a new one
2. Comment on the issue to request assignment (bot assigns automatically)
3. Follow the Development Workflow above
4. Read CONTRIBUTING.md for detailed guidelines
5. Follow CODE_OF_CONDUCT.md
6. Follow TEST_GUIDELINES.md when adding tests

Types of Contributions

Programs Participated In

	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

Blogs & Resources

• Firebase Cloud Messaging Backend (Node.js)
• Firebase Cloud Messaging in React Native

Our Contributors

Thank you for contributing to UltimateHealth

We appreciate every contribution — big or small.

Susmita Bhattacharya	Suhani Singh Paliwal	Balaharisankar L	SharmaNischay	Neeraj Saini	Meghana Gottapu
Jaickey Joy Minj	Siddheya Kulkarni	Pradnya Gaitonde	Sanmarg Paranjpe	Adrika Dwivedi	Arpna
Alisha Singh	Sibam Paul	HRISHIKESH SHINDE	Soham Adhyapak	Kylie	Himanshu Choudhary
Hemanth Kumar	Nishant Kaushal	Kamalesh Bala	Parth Nakum	Abhigna Arsam	MaryamMohamedYahya
Vijay Shanker Sharma	Tony Stark	Worrell Seville	Aditi	Ananya Gupta	akshathere
Ayushmaan Agarwal	Damini Chachane	Parth Shah	Sree Vidya	Asmita Mishra	Kanhaiya Kumar
Revanth Pasupuleti	Arunima Dutta	Maana Ajmera	Aditya Narayan	Utsav Ladia	Nayanika Mukherjee
Maheshwari Love	Pujan Sarkar	Tristan Al Harrish	SrijanCodes	Sparsh Joshi	Patel Namraa
Kimaya Chavan	Vaishnavi	Chandrika	Bhavya Reddy	Harshit Maurya	Preksha Pravin Salvi
Tanisha Sharma	Saurabh Kumar Bajpai	SarthakKharche	Indresh	Aditya B R	KOUSTAV HALDER
abhilashgedela28	Hariharasudhan D	SujithKumar R	Abdullah Jameel	Hemadri	Basant Nema
Priya09023	Krishna Kumar	Karan Singh	Siddharth	Krushal Hirpara	Sumit Kumar
Pranav Agarkar	Shalini Yadav	KINARA PATEL	SwaraMishra07	Srejoye Saha	Priyanshu Bariar
Yogender Verma	Jyoti	Joshua Jacob Thomas	Vedant	Riya Dumbare	Minhaj Parveen.H
anushkasrvstv	Manish Kumar	Khushi Ambastha	Dipesh	prernaajaypatil-oss	Keerthana
Ashley-Shine	PeswikaBavagni-30	Nikkiraj4	Bhavya sree	vaishnavi003-svg	Prerna singh
Nareshkumawat-star	Shrestha-ijarwal	Gurkaran18	silentguyracer	wombfrk.exe	Deepsikha Dash
Divanshu Aggarwal	Smridhi	Janarthanan G	Shraviya Ramesh Poojary	Mannat Jain	John Stewartsson J R
Deepak-Akuthota	Krishna Jha	MAYUR AJIT SAHARE	ANUSHKA KANDHWAY	GUJJU DINESH	dishamalukani-creator
Kruthi	HASINI	anjali62510-star	Anirudh Sahu	Saylee	Abdulhaque
Priyanshu Singh	Aditya Bhandari	Farisha N A	tenax	Bheeme_497	ARPAN ADHIKARY
Prakash Meena	Piyush Semalti	Parth Nakum	Arpita Raj	pratik ankush bandgar	Vanshika Mah

README 内容过长，已截取前 64 KB。完整内容请前往 GitHub 仓库查看。