vitaAI - Comprehensive Health & Wellness Platform

🏥 Overview

vitaAI is an end-to-end health and wellness platform that combines cutting-edge AI technology with a mobile-first user experience. The platform enables users to track health metrics, manage wellness goals, get AI-powered recommendations, and connect with a supportive community.

Vision

Democratize personalized health insights through AI while maintaining privacy, accuracy, and user empowerment.

Core Value Proposition

📱 Easy-to-use cross-platform mobile app
🤖 AI-powered AI bot to provide health-related assistance, TODO: FEATURE ADD ON: Photo to nutrition calculation
🔐 Privacy-first secure data handling
👥 Community-driven social wellness features
📊 Data-rich comprehensive health analytics

📦 Project Structure

The vitaAI ecosystem consists of 5 core modules:

1. vitaAI - Mobile Application

React Native mobile app for iOS and Android with health tracking, goal management, and community features.

Type: Cross-platform mobile app
Tech: React Native, TypeScript, Firebase
Status: Active development
📖 Read Full Documentation

2. vitaAI-Backend - API Server

Express.js backend providing RESTful APIs for all platform functionality with PostgreSQL database.

Type: Backend API server
Tech: Express.js, TypeScript, PostgreSQL, Prisma ORM
Status: Production-ready
📖 Read Full Documentation

3. internalRAG - Developer Support System

Retrieval-Augmented Generation system to support developers with documentation and code assistance.

Type: Developer support infrastructure
Tech: LangChain/LlamaIndex, Vector DB, LLMs
Status: In development
Purpose: Help developers find documentation, architecture patterns, and code examples
📖 Read Full Documentation

4. estimation - ML Model Predictions

Machine learning module for health predictions, with focus on nutrition analysis from food plate images.

Type: ML/AI models
Tech: TensorFlow, Python (or TensorFlow.js)
Status: 🔄 Pending (awaiting nutrition vision model)
Primary Focus: Food image recognition → Nutrition prediction
📖 Read Full Documentation

5. vitaAIDocs - API Documentation

Comprehensive API reference with Postman collection for developers.

Type: API documentation & collection
Contents: Postman collection, endpoint references, integration guides
Status: Expandable (more docs coming soon)
📖 Read Full Documentation

🚀 Quick Start Guide

Prerequisites

Node.js 18+ and npm/yarn
Git for version control
Docker (optional, for backend)
PostgreSQL 12+ (for backend)

Clone Repository

git clone https://github.com/sam1code/vita-ai.git
cd vita-ai

Setup Mobile App (vitaAI)

cd vitaAI
npm install
bundle install          # iOS CocoaPods
bundle exec pod install # Install iOS dependencies
npm start               # Start Metro bundler

# In another terminal
npm run android  # for Android
# or
npm run ios      # for iOS

Setup Backend Server (vitaAI-Backend)

cd vitaAI-Backend
npm install

# Create .env file with database and service credentials
cp .env.example .env
# Edit .env with your configurations

npm run prisma:migrate # Setup database
npm run dev            # Start development server

Access API Documentation

Open the Postman collection from vitaAIDocs/vita-ai.postman_collection.json in Postman to explore all available endpoints.

📋 Key Features

👤 User Management

Secure authentication (Firebase + Email/Password)
Google Sign-In integration
Profile customization
Privacy and security settings

🏥 Health Tracking

Vital signs monitoring (Blood pressure, heart rate, weight, etc.)
Activity tracking integration (Steps, calories, exercise)
Sleep analysis and patterns
Nutrition logging and food database
Water intake tracking

🎯 Goal Management

Create personalized health goals
Track progress with visual analytics
Set reminders and notifications
Goal completion tracking
Personalized recommendations

🤖 AI-Powered Features

Health trend predictions
Personalized health recommendations
Nutrition analysis from food images (in development)
Anomaly detection in health data

💬 Community & Social

Connect with other health-conscious users
Share achievements and progress
Community posts and discussions
Follow functionality
Mutual support features

📊 Analytics & Insights

Comprehensive health dashboards
Trend visualization with charts
Weekly/monthly health summaries
Goal achievement statistics
Personal health records

🔔 Smart Notifications

Medication reminders
Goal achievement alerts
Milestone celebrations
Community notifications
Personalized health tips

🏗️ System Architecture

┌─────────────────────────────────────────────────┐
│           vitaAI Mobile App                     │
│    (React Native - iOS & Android)              │
└──────────────┬──────────────────────────────────┘
               │
               │ HTTPS REST API calls
               │
┌──────────────▼──────────────────────────────────┐
│      vitaAI Backend API Server                  │
│   (Express.js - Node.js TypeScript)            │
│  Routes: /v1/auth, /v1/users, /v1/goals, ..    │
└──────────────┬──────────────────────────────────┘
               │
        ┌──────┼──────┐
        │      │      │
        ▼      ▼      ▼
   ┌─────────────────────┐
   │ Firebase            │  ┌────────────┐
   │ • Auth              │  │ PostgreSQL │
   │ • Firestore         │  │ DB         │
   │ • Cloud Messaging   │  └────────────┘
   │ • Storage           │
   └─────────────────────┘
        │
        ▼
   ┌─────────────────────┐
   │ AWS Services        │
   │ • S3 Storage        │
   │ • File Uploads      │
   └─────────────────────┘

┌─────────────────────────────────────────────────┐
│   ML Models (estimation module)                 │
│ • Nutrition Vision Model                       │
│ • Health Predictions                           │
│ • Anomaly Detection                            │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│   Developer Support (internalRAG)               │
│ • Documentation Retrieval                      │
│ • Code Assistance                              │
│ • Architecture Guidelines                      │
└─────────────────────────────────────────────────┘

🛠️ Tech Stack Overview

Frontend (Mobile)

Framework: React Native 0.79.2
Language: TypeScript
Navigation: React Navigation
State: Redux/MobX (see src/store)
UI Components: React Native Kit, Linear Gradient
Health Integration: HealthKit (iOS), Health Connect (Android)
API Client: Axios

Backend

Framework: Express.js 5.1.0
Language: TypeScript
Runtime: Node.js 18+
Database: PostgreSQL 12+
ORM: Prisma 5.22.0
Authentication: Firebase Admin SDK
File Storage: AWS S3
Logging: Morgan
Containerization: Docker & Docker Compose

Authentication & Services

Auth: Firebase Authentication
Database: Firestore (real-time sync), PostgreSQL (primary DB)
Storage: AWS S3
File Uploads: Pre-signed URLs
Push Notifications: Firebase Cloud Messaging

ML & AI (Planned)

Vision: TensorFlow.js or Python TensorFlow
Embedding: LLM integrations for RAG
Vector DB: Pinecone/Weaviate (for internalRAG)

📚 Documentation Structure

Each module has comprehensive documentation:

Folder	Documentation	Purpose
`vitaAI/`	README.md	Mobile app setup, development, architecture
`vitaAI-Backend/`	README.md	API reference, database, deployment
`internalRAG/`	README.md	Developer support, RAG setup, usage
`estimation/`	README.md	ML models, nutrition prediction, algorithms
`vitaAIDocs/`	README.md	API docs, Postman collection, examples

🚀 Getting Started for Developers

1. Environment Setup

Clone the repo:

git clone https://github.com/sam1code/vita-ai.git
cd vita-ai

Install global tools:

npm install -g react-native-cli
npm install -g @react-native-community/cli-types

2. Backend Setup

cd vitaAI-Backend

# Install dependencies
npm install

# Setup environment
cp .env.example .env
# Edit .env with:
# - DATABASE_URL (PostgreSQL)
# - VFIREBASE_* (Firebase credentials)
# - AWS_S3_* (AWS S3 credentials)

# Initialize database
npm run prisma:generate
npm run prisma:migrate

# Start development server
npm run dev

Server will run on http://localhost:3000

3. Mobile App Setup

cd vitaAI

# Install dependencies
npm install

# iOS setup
bundle install
bundle exec pod install

# Start Metro bundler
npm start

# In another terminal, run on device/emulator
npm run android  # or npm run ios

4. Test API Endpoints

Import vitaAIDocs/vita-ai.postman_collection.json into Postman to test all endpoints.

📖 Development Workflow

Creating a New Feature

Plan - Define feature requirements and API endpoints
Backend API - Implement route, controller, database schema in vitaAI-Backend
Database - Create Prisma migration: npm run prisma:migrate
Mobile UI - Build screen and components in vitaAI
Integration - Connect mobile to backend API
Testing - Test on both Android and iOS
Documentation - Update relevant README files
Review - Create Pull Request for code review

Code Style & Standards

Language: TypeScript (strict mode)
Formatting: Prettier (see .prettierrc.js)
Linting: ESLint
Testing: Jest

Running Tests

Backend:

cd vitaAI-Backend
npm test

Mobile:

cd vitaAI
npm test

🔒 Security & Privacy

Authentication

Firebase handles user authentication securely
JWT tokens for API requests
Refresh token mechanism

Data Security

Environment variables for sensitive data (never commit .env)
HTTPS for all API communications
PostgreSQL with proper access controls
AWS S3 with signed URLs for file access

Privacy

User data encrypted at rest
GDPR-compliant data handling
User controls over data sharing
Community post privacy settings

Best Practices

Validate all user inputs
Rate limiting on sensitive endpoints
Error messages don't expose system details
Regular security audits

🐳 Deployment

Backend Deployment

Using Docker:

cd vitaAI-Backend
docker build -t vitaai-backend .
docker-compose up

Manual Deployment:

npm run build
npm install --production
npm start

For detailed deployment instructions, see vitaAI-Backend/README.Docker.md

Mobile App Deployment

iOS (App Store):

eas build --platform ios
eas submit --platform ios

Android (Google Play):

eas build --platform android
eas submit --platform android

📊 Project Stats

Mobile Screens: 15+
API Endpoints: 40+
Database Models: 10+
Dependencies: 100+
Lines of Code: 20,000+

🤝 Contributing

We welcome contributions! Please follow these guidelines:

Fork the repository
Create a feature branch: git checkout -b feature/my-feature
Commit changes: git commit -m 'Add my feature'
Push to branch: git push origin feature/my-feature
Create a Pull Request

Contributing Guidelines

Follow code style (ESLint, Prettier)
Add tests for new functionality
Update documentation
Write clear commit messages
Keep PRs focused on single features

Reporting Issues

Found a bug? Please open an issue with:

Clear description of the problem
Steps to reproduce
Expected vs actual behavior
Environment details (OS, app version, etc.)

📱 Supported Platforms

Platform	Version	Status
iOS	12.0+	✅ Supported
Android	7.0+ (API 24+)	✅ Supported
Web	N/A	🔄 Future

🗂️ Important Files

vita-ai/
├── Readme.md                          # This file
├── vitaAI/                            # Mobile app
│   ├── src/                           # App source code
│   ├── android/                       # Android native code
│   ├── ios/                           # iOS native code
│   └── README.md                      # App documentation
├── vitaAI-Backend/                    # Backend API
│   ├── src/                           # API source code
│   ├── prisma/                        # Database schema
│   ├── Dockerfile                     # Docker config
│   └── README.md                      # API documentation
├── internalRAG/                       # Developer support
│   └── README.md                      # RAG documentation
├── estimation/                        # ML models
│   └── README.md                      # Model documentation
├── vitaAIDocs/                        # API docs
│   ├── vita-ai.postman_collection.json
│   └── README.md                      # API reference
└── .env.example                       # Environment template

📞 Support & Resources

Documentation

External Resources

Community

GitHub Issues for bug reports and feature requests
GitHub Discussions for questions and ideas
Pull Requests for code contributions

Contact

📧 Email: [development team email]
💬 Slack: [community channel]
🐛 Issues: GitHub Issues

📈 Roadmap

Q2 2026

✅ Complete backend API
✅ Mobile app beta
🔄 Internal RAG for developer support
🔄 Nutrition prediction model

Q3 2026

ML-powered health insights
Advanced analytics dashboard
Community features enhancement
Dark mode support

Q4 2026

Web application
Advanced AI recommendations
Integration with wearables
Multi-language support

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Team

vitaAI Development Team

Project Lead: [Name]
Mobile Developer: [Contributors]
Backend Engineer: [Contributors]
ML Engineer: [Contributors]

🎯 Future Vision

vitaAI aims to become the leading AI-powered health platform by:

Accuracy: Providing accurate health predictions through advanced ML
Accessibility: Making health insights available to everyone
Community: Building a supportive health-conscious community
Innovation: Continuously integrating latest health technologies
Privacy: Maintaining highest standards of user data privacy

📊 Quick Links

🔗 GitHub Repository
🐳 Docker Hub
📱 App Store (coming soon)
🎮 Google Play (coming soon)

Last Updated: April 3, 2026
Version: 1.0.0
Status: Active Development

⭐ Show Your Support

If you find vitaAI helpful, please give us a star on GitHub! Your support means a lot to us.

# Clone and explore
git clone https://github.com/sam1code/vita-ai.git
cd vita-ai

# Check out the modules
ls -la

# Read module documentation
cat vitaAI/README.md
cat vitaAI-Backend/README.md

Made with ❤️ by the vitaAI Team

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
estimation		estimation
internalRAG		internalRAG
vitaAI-Backend		vitaAI-Backend
vitaAI		vitaAI
vitaAIDocs		vitaAIDocs
.DS_Store		.DS_Store
Readme.md		Readme.md

Folders and files

Latest commit

History

Repository files navigation