UltimateHealth Backend

🧾 License	🌟 Stars	🍴 Forks	🐛 Issues
🔄 Open PRs	✅ Closed PRs	⏱️ Last Commit

The core backend engine powering UltimateHealth — a community-driven open-source health platform.

Provides secure, scalable REST APIs for:

• Multilingual health articles & podcasts
• Collaborative content review & moderation
• User authentication (JWT)
• Admin & user analytics
• Reporting & safety features

Submodule Repositories

• Frontend Repository: ultimatehealth-app
• Admin Repository: ultimatehealth-admin
• Content Checker Repository: content-checker

---

✨ Key Features

• Full CRUD for Articles & Podcasts with review workflow
• JWT Authentication + Protected Routes
• Content Moderation System (strikes, bans, flagging)
• Admin Dashboard APIs + Analytics
• Swagger UI for interactive API documentation
• Environment-based configuration
• Error handling & validation

Live API Docs: https://uhsocial.in/docs

---

🛠️ Tech Stack

• Runtime: Node.js
• Framework: Express.js
• Database: MongoDB + Mongoose
• Auth: JWT
• Docs: Swagger (OpenAPI 3)
• Others: dotenv, cors, etc.

---

🚀 Quick Start

1. Clone the repo

   git clone https://github.com/SB2318/ultimatehealth-backend.git
   cd ultimatehealth-backend
   

2. Install dependencies

   yarn install
   replace your .env

3. Create .env file (see .env.example)

PORT=YOUR_PORT_HERE

MONGODB_URL= YOUR_DATABASE_URL_HERE
BASE_URL = SERVER_BASE_URL_HERE

# JWT Secrets - Use different secrets for different token types for enhanced security
JWT_ACCESS_SECRET= YOUR_ACCESS_TOKEN_SECRET_KEY
JWT_REFRESH_SECRET= YOUR_REFRESH_TOKEN_SECRET_KEY
JWT_VERIFICATION_SECRET= YOUR_VERIFICATION_TOKEN_SECRET_KEY

# JWT Expiration Times (configurable)
JWT_ACCESS_EXPIRY=15m
JWT_REFRESH_EXPIRY=7d
JWT_VERIFICATION_EXPIRY=1h

# Legacy JWT Secret (deprecated - migrate to separate secrets)
JWT_SECRET= JWT_SECRET_KEY

EMAIL= EMAIL_ID
PASSWORD= MAIL_PASSWORD
SMTP_HOST= YOUR_MAIL_HOST
EMAIL_USER= YOUR_MAIL_ID
EMAIL_PASS= YOUR_MAIL_PASSWORD
VULTR_ACCESS_KEY = 'YOUR_ACCESS_KEY';
VULTR_SECRET_KEY = 'YOUR_SECRET_KEY';
BUCKET_NAME = 'YOUR_BUCKET_NAME';
ENDPOINT_URL = 'YOUR_ENDPOINT_URL';

4. Run The Server

  yarn start

📁Project Structure

ultimatehealth-backend/
├── src/
├── config/          # Database & environment config
├── controllers/     # Request handlers
├── middleware/      # Auth, validation, error handling
├── models/          # Mongoose schemas
├── routes/          # API route definitions
├── utils/           # Helper functions
├── services/      
├── index.js
├── .env.example
├── package.json
└── README.md

🤝 How to Contribute

We welcome contributions! This backend is open for students, developers, and open-source enthusiasts.

Getting Started

• Read our CONTRIBUTING.md for detailed guidelines.
• Look for issues labeled with good-first-issue — perfect for beginners.

Popular Contribution Areas

• Adding new API endpoints
• Improving error handling & validation
• Writing unit/integration tests
• Enhancing Swagger documentation
• Performance optimizations
• Fixing bugs and improving code quality
• Adding more test coverage

---

Thank you for contributing to our repository

We appreciate your help in making UltimateHealth even better.😃

Susmita Bhattacharya

HRUSHIKESH SHINDE

SrijanCodes

If you're new to open source, feel free to ask questions by opening a Discussion or commenting on an issue.