Skip to content

Ruthwik000/Arasie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

108 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ‹๏ธโ€โ™‚๏ธ ARAISE - AI-Powered Fitness Tracking Platform

ARAISE Logo

A comprehensive fitness ecosystem combining AI-powered form analysis, nutrition tracking, hydration monitoring, and gamified progress visualization.

React Firebase Vite Tailwind CSS License

๐Ÿš€ Live Demo | ๐Ÿ“– Documentation | ๐Ÿ› Report Bug | ๐Ÿ’ก Request Feature


๐ŸŽฏ Overview

ARAISE is a next-generation fitness tracking application that revolutionizes how users approach their health and wellness journey. Built with cutting-edge technologies including React 19, Firebase, and MediaPipe AI, it offers real-time form correction, comprehensive progress tracking, and an intuitive user experience optimized for all devices.

โœจ Key Highlights

  • ๐Ÿค– AI-Powered Form Analysis - Real-time exercise form correction using MediaPipe
  • ๐ŸŽฅ Video Exercise Demonstrations - HD workout videos with seamless integration
  • ๐Ÿ“Š Professional Dashboard UI - Modern glassmorphism design with enhanced animations and micro-interactions
  • ๏ฟฝ Premfium Visual Design - Gradient progress bars, sophisticated card layouts, and polished typography
  • ๐ŸŽฎ Advanced Gamification - Levels, streaks, achievement badges with glow effects and celebrations
  • ๏ฟฝ Mobilei-First Excellence - Touch-optimized responsive design with premium interactions
  • ๐Ÿ”ฅ Real-Time Sync - Firebase-powered instant data synchronization with smooth transitions
  • โšก Enhanced Performance - Optimized animations and state management for fluid user experience

๐Ÿ  Enhanced Dashboard Overview

Dashboard Screenshot Professional modern dashboard with enhanced glassmorphism cards, gradient progress bars, and sophisticated animations

๐Ÿ’ช AI-Powered Workout Analysis

Workout Analysis Screenshot Live form correction using MediaPipe pose detection with real-time feedback

๐Ÿ’ง Water & ๐Ÿฝ๏ธ Diet Tracking

Tracking Features Screenshot Intuitive progress visualization with animated charts and goal management

๐Ÿ“ฑ Mobile-Responsive Design

Mobile Screenshots Seamless experience across all device sizes with touch-optimized interactions


๏ฟฝ๐Ÿš€ Core Features

๐Ÿ’ช Smart Workout System

  • Multi-Level Training Plans - Beginner, Intermediate, and Advanced routines
  • AI Form Analyzer - Real-time pose detection and correction feedback
  • Video Demonstrations - High-quality exercise videos (biceps.mp4 and more)
  • Progress Tracking - Session completion and performance metrics
  • Dynamic Exercise Display - Animated elements and responsive layouts

๐Ÿ’ง Hydration Tracking

  • Circular Progress Visualization - Beautiful water intake progress rings
  • Quick Add Buttons - 250ml, 500ml, 750ml, 1000ml preset options
  • Custom Amount Entry - Flexible manual logging
  • Smart Goal Management - 3L daily target with achievement notifications
  • Time-Stamped Logs - Complete hydration history tracking

๐Ÿฝ๏ธ Nutrition Management

  • Macro Visualization - Interactive pie charts for carbs, protein, and fats
  • Calorie Tracking - Real-time progress bars and goal monitoring
  • Meal Logging - Breakfast, lunch, dinner, and snack categorization
  • Achievement Notifications - Goal completion celebrations
  • Nutritional Insights - Comprehensive macro and calorie breakdowns

๐Ÿ“ˆ Progress Dashboard

  • Radar Chart Analytics - Multi-dimensional progress visualization
  • Streak Calendar - 35-day heatmap showing consistency
  • Real-Time Updates - Live progress synchronization across all features
  • Gamification Elements - Level progression and achievement badges
  • Responsive Design - Optimized spacing and layouts for mobile and desktop

๐Ÿ› ๏ธ Tech Stack

Frontend Framework

  • โš›๏ธ React 19.1.1 - Latest React with enhanced performance
  • ๐ŸŽจ Tailwind CSS 3.4.17 - Utility-first styling with custom components
  • ๐ŸŒŸ Framer Motion 12.23.12 - Smooth animations and transitions
  • ๐Ÿงญ React Router DOM 7.8.2 - Client-side routing and navigation

Backend & Database

  • ๐Ÿ”ฅ Firebase 12.2.1 - Authentication, Firestore, and real-time sync
  • ๐Ÿ“Š Firebase Analytics - User behavior and performance tracking
  • โ˜๏ธ Firebase Hosting - Fast, secure web hosting

State Management & UI

  • ๐Ÿ—ƒ๏ธ Zustand 5.0.8 - Lightweight state management
  • ๐ŸŽฏ Radix UI Components - Accessible, customizable UI primitives
  • ๐Ÿ“Š Recharts 3.1.2 - Responsive chart library for data visualization
  • ๐ŸŽจ Lucide React 0.542.0 - Beautiful, consistent icons

AI & Analysis

  • ๐Ÿค– MediaPipe - Advanced pose detection and form analysis
  • ๐Ÿ“ธ WebRTC - Real-time camera integration for form checking
  • ๐Ÿง  Computer Vision - Real-time feedback and rep counting

Development Tools

  • โšก Vite 7.1.2 - Lightning-fast build tool and dev server
  • ๐Ÿ” ESLint 9.33.0 - Code quality and consistency
  • ๐Ÿ“ฆ PostCSS & Autoprefixer - CSS processing and optimization

๐Ÿ“ Project Structure

araise/
โ”œโ”€โ”€ ๐Ÿ“‚ public/
โ”‚   โ”œโ”€โ”€ ๐ŸŽฌ videos/
โ”‚   โ”‚   โ””โ”€โ”€ biceps.mp4          # Exercise demonstration videos
โ”‚   โ”œโ”€โ”€ ๐Ÿ“„ manifest.json        # PWA manifest
โ”‚   โ”œโ”€โ”€ โš™๏ธ sw.js               # Service worker
โ”‚   โ””โ”€โ”€ ๐Ÿ–ผ๏ธ vite.svg            # App icons
โ”œโ”€โ”€ ๐Ÿ“‚ src/
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ assets/
โ”‚   โ”‚   โ””โ”€โ”€ react.svg
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ components/
โ”‚   โ”‚   โ”œโ”€โ”€ Navigation.jsx      # Responsive navigation bar
โ”‚   โ”‚   โ”œโ”€โ”€ ProtectedRoute.jsx  # Route protection wrapper
โ”‚   โ”‚   โ”œโ”€โ”€ UI.jsx             # Reusable UI components
โ”‚   โ”‚   โ””โ”€โ”€ ๐Ÿ“‚ ui/
โ”‚   โ”‚       โ”œโ”€โ”€ button.jsx      # Custom button component
โ”‚   โ”‚       โ”œโ”€โ”€ card.jsx        # Card layout component
โ”‚   โ”‚       โ”œโ”€โ”€ input.jsx       # Form input component
โ”‚   โ”‚       โ”œโ”€โ”€ ModernLogin.jsx # Styled login form
โ”‚   โ”‚       โ””โ”€โ”€ ModernSignup.jsx# Styled signup form
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ pages/
โ”‚   โ”‚   โ”œโ”€โ”€ Dashboard.jsx       # Main hub with analytics
โ”‚   โ”‚   โ”œโ”€โ”€ Diet.jsx           # Nutrition tracking page
โ”‚   โ”‚   โ”œโ”€โ”€ Login.jsx          # Authentication page
โ”‚   โ”‚   โ”œโ”€โ”€ Signup.jsx         # Registration page
โ”‚   โ”‚   โ”œโ”€โ”€ Water.jsx          # Hydration tracking page
โ”‚   โ”‚   โ”œโ”€โ”€ Welcome.jsx        # Landing page
โ”‚   โ”‚   โ””โ”€โ”€ Workout.jsx        # Comprehensive workout system
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ store/
โ”‚   โ”‚   โ””โ”€โ”€ userStore.js       # Zustand state management
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ utils/
โ”‚   โ”‚   โ”œโ”€โ”€ cn.js              # Class name utilities
โ”‚   โ”‚   โ””โ”€โ”€ helpers.js         # Common helper functions
โ”‚   โ”œโ”€โ”€ App.jsx                # Root application component
โ”‚   โ”œโ”€โ”€ main.jsx               # Application entry point
โ”‚   โ””โ”€โ”€ index.css              # Global styles
โ”œโ”€โ”€ ๐Ÿ“„ eslint.config.js         # ESLint configuration
โ”œโ”€โ”€ ๐Ÿ“„ package.json            # Dependencies and scripts
โ”œโ”€โ”€ ๐Ÿ“„ postcss.config.js       # PostCSS configuration
โ”œโ”€โ”€ ๐Ÿ“„ tailwind.config.js      # Tailwind CSS configuration
โ”œโ”€โ”€ ๐Ÿ“„ vite.config.js          # Vite build configuration
โ”œโ”€โ”€ ๐Ÿ“‹ USER_FLOW_CHART.md      # Comprehensive user flow documentation
โ””โ”€โ”€ ๐Ÿ“– README.md               # Project documentation

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+ and npm/yarn
  • Firebase project with Authentication and Firestore enabled
  • Modern web browser with WebRTC support

Installation

  1. Clone the repository

    git clone https://github.com/Ruthwik000/Arasie.git
    cd Arasie/araise
  2. Install dependencies

    npm install
  3. Environment Setup

    cp .env.example .env
  4. Configure Firebase - Add your Firebase config to .env:

    VITE_FIREBASE_API_KEY=your_api_key_here
    VITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
    VITE_FIREBASE_PROJECT_ID=your_project_id
    VITE_FIREBASE_STORAGE_BUCKET=your_project.firebasestorage.app
    VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
    VITE_FIREBASE_APP_ID=your_app_id
    VITE_FIREBASE_MEASUREMENT_ID=your_measurement_id
  5. Start development server

    npm run dev

Tech Stack

  • Frontend: React 19.1.1, Vite 7.1.2
  • Styling: Tailwind CSS 3.4.17, Framer Motion 12.23.12
  • Authentication: Firebase Auth 12.2.1
  • Database: Firebase Firestore, Real-time sync
  • State Management: Zustand 5.0.8
  • Routing: React Router DOM 7.8.2
  • AI Integration: MediaPipe for pose detection
  • Charts: Recharts 3.1.2 for data visualization

๐Ÿš€ Quick Start

Prerequisites

  • Node.js 18+ and npm/yarn
  • Firebase project with Authentication and Firestore enabled
  • Modern web browser with WebRTC support

Installation

  1. Clone the repository

    git clone https://github.com/Ruthwik000/Arasie.git
    cd Arasie/araise
  2. Install dependencies

    npm install
  3. Environment Setup

    cp .env.example .env
  4. Configure Firebase - Add your Firebase config to .env:

    VITE_FIREBASE_API_KEY=your_api_key_here
    VITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
    VITE_FIREBASE_PROJECT_ID=your_project_id
    VITE_FIREBASE_STORAGE_BUCKET=your_project.firebasestorage.app
    VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
    VITE_FIREBASE_APP_ID=your_app_id
    VITE_FIREBASE_MEASUREMENT_ID=your_measurement_id
  5. Start development server

    npm run dev
  6. Open in browser

    http://localhost:5173
    

Build for Production

npm run build        # Build optimized production files
npm run preview      # Preview production build locally

๐ŸŽฎ Usage Guide

๐Ÿ” Authentication Flow

  1. Welcome Screen - Feature overview and call-to-action
  2. Sign Up/Login - Firebase email/password authentication
  3. Protected Routes - Automatic redirection for unauthorized users

๐Ÿ“Š Dashboard Navigation

  • Progress Overview - Radar chart showing workout, water, and diet progress
  • Streak Calendar - Visual representation of daily consistency
  • Quick Actions - Direct access to workout, water, and diet features

๐Ÿ’ช Workout Experience

  1. Select Difficulty - Beginner, Intermediate, or Advanced
  2. Choose Plan - Multiple workout routines per difficulty level
  3. Exercise Session - Video demonstrations and animated guides
  4. AI Form Analysis - Real-time pose detection and feedback
  5. Progress Tracking - Automatic completion and statistics

๐Ÿ’ง Water & ๐Ÿฝ๏ธ Diet Tracking

  • Quick Logging - Preset buttons for common amounts
  • Custom Entry - Manual input with flexible amounts
  • Progress Visualization - Real-time charts and goal tracking
  • Achievement Notifications - Celebration of daily goals

๐Ÿ—๏ธ Architecture & Design Patterns

Component Architecture

App (Root)
โ”œโ”€โ”€ AuthProvider (Firebase Context)
โ”œโ”€โ”€ Navigation (Conditional Sidebar)
โ”œโ”€โ”€ ProtectedRoute (Auth Guard)
โ””โ”€โ”€ Page Components
    โ”œโ”€โ”€ Dashboard (Analytics Hub)
    โ”œโ”€โ”€ Workout (Complex Nested Routes)
    โ”œโ”€โ”€ Water (Progress Tracking)
    โ”œโ”€โ”€ Diet (Nutrition Management)
    โ””โ”€โ”€ Auth Pages (Login/Signup)

State Management Pattern

  • Zustand Store - Centralized state with persistence
  • Firebase Integration - Real-time data synchronization
  • Local Storage Fallback - Offline capability and performance
  • Reactive Updates - Automatic UI updates on state changes

Responsive Design Strategy

/* Mobile-First Approach */
Default (Mobile): Compact layouts, touch-optimized
md: 768px+       : Enhanced spacing, grid layouts
lg: 1024px+      : Full desktop experience, max width

๐Ÿ”ง Configuration

Environment Variables

# Firebase Configuration
VITE_FIREBASE_API_KEY=            # Firebase API key
VITE_FIREBASE_AUTH_DOMAIN=        # Authentication domain
VITE_FIREBASE_PROJECT_ID=         # Project identifier
VITE_FIREBASE_STORAGE_BUCKET=     # Storage bucket URL
VITE_FIREBASE_MESSAGING_SENDER_ID=# Messaging sender ID
VITE_FIREBASE_APP_ID=             # App identifier
VITE_FIREBASE_MEASUREMENT_ID=     # Analytics measurement ID

Firebase Rules

// Firestore Security Rules
rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow read, write: if request.auth != null && request.auth.uid == userId;
    }
  }
}

๐Ÿš€ Deployment

Firebase Hosting

  1. Install Firebase CLI

    npm install -g firebase-tools
  2. Login and Initialize

    firebase login
    firebase init hosting
  3. Build and Deploy

    npm run build
    firebase deploy

Alternative Deployment Options

  • Vercel - Zero-config deployment with GitHub integration
  • Netlify - Continuous deployment with form handling
  • GitHub Pages - Free static hosting for public repositories

๐Ÿค Contributing

We welcome contributions from the community! Here's how you can help:

Development Setup

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes and test thoroughly
  4. Commit with conventional commits: git commit -m 'feat: add amazing feature'
  5. Push to your branch: git push origin feature/amazing-feature
  6. Open a Pull Request

Code Standards

  • ESLint Configuration - Follow existing linting rules
  • Component Structure - Use functional components with hooks
  • Responsive Design - Mobile-first approach required
  • Accessibility - WCAG 2.1 compliance for all interactive elements

๐Ÿ“‹ Roadmap

๐Ÿ”ฎ Upcoming Features

  • Advanced AI Analysis - Enhanced form correction algorithms
  • Social Features - Friend challenges and community boards
  • Wearable Integration - Heart rate and activity sync
  • Meal Planning - AI-powered nutrition recommendations
  • Offline Mode - Complete functionality without internet
  • Progressive Web App - Native app-like experience
  • Multi-language Support - Internationalization (i18n)
  • Voice Commands - Hands-free workout guidance

๐Ÿ› Troubleshooting

Common Issues

๐Ÿ”ฅ Firebase Connection Issues

# Check environment variables
echo $VITE_FIREBASE_API_KEY

# Verify Firebase project settings
firebase projects:list

๐Ÿ“ฑ Video Playback Issues

  • Ensure browser supports HTML5 video
  • Check video file format compatibility
  • Verify HTTPS connection for autoplay

๐Ÿ”ง Build Errors

# Clear node modules and reinstall
rm -rf node_modules package-lock.json
npm install

# Clear Vite cache
rm -rf .vite
npm run dev

๐Ÿ“„ License

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


๐Ÿ‘ฅ Team

Lead Developer: Ruthwik000

  • Full-stack development
  • AI integration and optimization
  • UI/UX design and implementation

Contributors:

PATTASWAMY-VISHWAK-YASASHREE

  • Frontend development
  • UI/UX enhancements
  • Feature implementation

vara-prasad-07

  • Backend development
  • Firebase integration
  • Performance optimization

๐Ÿ™ Acknowledgments

  • MediaPipe Team - For exceptional pose detection technology
  • Firebase Team - For robust backend infrastructure
  • React Team - For the incredible frontend framework
  • Tailwind CSS - For the utility-first CSS framework
  • Open Source Community - For continuous inspiration and support

๐Ÿ“ž Support

Need help or have questions? We're here to assist:


โญ Star this repository if you find it helpful!

๐Ÿ”— Share with your fitness community

๐Ÿค Contribute to make fitness tracking better for everyone


Built with โค๏ธ by the ARAISE team

Empowering fitness journeys through technology

About

AI-powered fitness tracking platform with real-time form analysis, nutrition monitoring, and gamified progress tracking built with React and Firebase

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages