ELITE Gym & Fitness

🇱🇰 Sri Lanka's Premier AI-Powered Digital Fitness Management Platform

Features • Tech Stack • Installation • Usage • Architecture

Overview

ELITE Gym & Fitness is a cutting-edge, full-stack fitness management platform engineered specifically for the Sri Lankan fitness industry. Combining the power of modern web technologies with AI-driven personalization, this platform delivers an all-in-one solution for gym members, personal trainers, and facility administrators.

Built with Next.js 15, Convex real-time database, Stripe payment processing, Clerk authentication, and Vapi voice AI for conversational program generation, ELITE transforms how fitness businesses operate and how members achieve their health goals.

Features

AI-Powered Fitness Program Generator

Voice-Enabled Consultation - Interactive voice conversations with Vapi AI to create personalized plans
Conversational Input - Natural dialogue to gather fitness goals, limitations, and preferences
Smart Workout Plans - Customized training programs generated by Google Gemini AI
Personalized Diet Plans - Nutrition recommendations tailored to individual goals
Real-Time Transcripts - Live display of conversation during AI consultation
Seamless Experience - Voice consultation automatically redirects to profile with generated plans

Comprehensive Membership Management

Flexible Membership Tiers - Basic, Premium, and Elite packages
Automated Renewals - Stripe-powered subscription management
Member Dashboards - Track workouts, attendance, and progress
QR Code Check-ins - Contactless gym access (planned)
Membership History - Complete transaction and usage records

Professional Trainer Booking System

Trainer Profiles - Detailed bios, specializations, and certifications
Real-Time Availability - Live scheduling and booking calendar
Session Management - Track past and upcoming training sessions
Trainer Applications - Apply to become a trainer with admin approval
Salary Management - Admin dashboard for trainer compensation
Booking Payments - Stripe integration for session payments

E-Commerce Marketplace

Product Catalog - Supplements, equipment, apparel, and accessories
Shopping Cart - Add multiple items and manage quantities
Secure Checkout - Stripe-integrated payment processing
Inventory Management - Admin control of stock levels
Order History - Complete purchase records in user profile
Product Reviews - Community-driven ratings and feedback

Payment Integration

Local Currency Support - Optimized for Sri Lankan Rupees (LKR)
Multiple Payment Gateways - Stripe for cards and digital wallets
Subscription Billing - Automated recurring membership payments
One-Time Payments - Trainer bookings and product purchases
Webhook Integration - Real-time payment status updates
Payment Slips - Track all transaction history

Advanced Authentication & Authorization

Secure Login - Clerk-powered authentication
Role-Based Access Control - Separate permissions for users, trainers, and admins
Social Login - Google and email authentication
Session Management - Secure token-based sessions
Protected Routes - Middleware-based route protection

Admin Dashboard

User Management - CRUD operations for all user accounts
Membership Analytics - Track active subscriptions and revenue
Trainer Administration - Approve applications and manage trainers
Inventory Control - Manage products, stock, and pricing
Blog Management - Create and manage fitness content
Recipe Database - Add and manage healthy recipes
Salary Management - Track and manage trainer payments
System Configuration - Platform settings and customization

Mobile-First Design

Responsive UI - Optimized for all screen sizes
Dark/Light Mode - Theme toggle with next-themes
Touch-Friendly Interface - Intuitive mobile interactions
Fast Loading - Turbopack for rapid development
Modern Components - shadcn/ui component library

Localization

Sri Lankan Focus - Currency (LKR), language, and cultural considerations
Time Zone Support - Accurate scheduling for local time (Asia/Colombo)
Local Payment Methods - Stripe configured for Sri Lankan market

Tech Stack

Frontend Architecture

Technology	Purpose	Version
	React framework with App Router and Server Components	15.2
	Type-safe development	5.0+
	UI component library	19.0
	Utility-first CSS framework	4.0
	Beautiful, accessible UI components	Latest
	Dark/Light mode theming	Latest
	Modern icon library	Latest
	Interactive maps for gym locations	1.9

Backend & Database

Technology	Purpose
	Real-time backend-as-a-service with TypeScript
	API routes and webhook handlers
Convex Functions	Queries, mutations, and actions

Authentication & Authorization

Technology	Purpose
	Complete user authentication and management
Clerk Middleware	Route protection and session handling
Role-Based Access	Admin, Trainer, and User roles

Payment Processing

Technology	Purpose
	Payment gateway for memberships, bookings, and products
Stripe Checkout	Secure hosted payment pages
Stripe Webhooks	Real-time payment event handling
Subscription Management	Recurring membership billing

AI & Voice Integration

Technology	Purpose
	Voice AI for conversational fitness program generation
Google Gemini AI	Workout and diet plan generation (Gemini 2.5 Flash)
Speech Recognition	Real-time voice transcription during consultation
Natural Language Processing	Understanding user fitness goals and preferences
Workflow Integration	Vapi workflows with custom variable passing

Development Tools

Technology	Purpose
	Next-gen bundler for faster development
	Code linting and quality control
	Version control

Deployment & Infrastructure

Technology	Purpose
	Hosting and deployment
Edge Functions	Global CDN and low latency
Serverless Architecture	Scalable infrastructure

System Architecture

┌─────────────────────────────────────────────────────────────────┐
│                       NEXT.JS 15 FRONTEND                       │
│                     (App Router + React 19)                     │
│                                                                 │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────────────┐   │
│  │   User      │  │   Trainer    │  │   Admin            │   │
│  │   Portal    │  │   Dashboard  │  │   Dashboard        │   │
│  │             │  │              │  │                    │   │
│  │ - Profile   │  │ - Sessions   │  │ - User Mgmt       │   │
│  │ - Plans     │  │ - Schedule   │  │ - Memberships     │   │
│  │ - Orders    │  │ - Earnings   │  │ - Inventory       │   │
│  │ - Bookings  │  │              │  │ - Blog/Recipes    │   │
│  └─────────────┘  └──────────────┘  └────────────────────┘   │
│         │                │                     │               │
│         └────────────────┴─────────────────────┘               │
│                          │                                     │
│                 ┌────────▼────────┐                           │
│                 │  Clerk Auth     │                           │
│                 │  Middleware     │                           │
│                 └────────┬────────┘                           │
└──────────────────────────┼─────────────────────────────────────┘
                           │
┌──────────────────────────▼─────────────────────────────────────┐
│                    CONVEX BACKEND LAYER                        │
│                                                                │
│  ┌───────────────┐  ┌─────────────┐  ┌──────────────────┐   │
│  │   Queries     │  │  Mutations  │  │    Actions       │   │
│  │ (Read Data)   │  │ (Write Data)│  │ (External APIs)  │   │
│  │               │  │             │  │                  │   │
│  │ - Users       │  │ - Create    │  │ - Stripe         │   │
│  │ - Plans       │  │ - Update    │  │ - Webhooks       │   │
│  │ - Products    │  │ - Delete    │  │ - Email          │   │
│  └───────────────┘  └─────────────┘  └──────────────────┘   │
│         │                 │                    │              │
│         └─────────────────┴────────────────────┘              │
│                           │                                   │
│                  ┌────────▼────────┐                         │
│                  │  Convex RT DB   │                         │
│                  │  - users        │                         │
│                  │  - memberships  │                         │
│                  │  - bookings     │                         │
│                  │  - products     │                         │
│                  │  - trainers     │                         │
│                  │  - fitnessPlans │                         │
│                  │  - dietPlans    │                         │
│                  └─────────────────┘                         │
└─────────────────────────┬───────────────────────────────────────┘
                          │
        ┌─────────────────┼─────────────────────────┐
        │                 │                 │       │
┌───────▼──────┐  ┌──────▼────────┐  ┌────▼──────┐ ┌──────▼──────┐
│   Stripe     │  │  Google       │  │  Clerk    │ │   Vapi      │
│   Payment    │  │  Gemini AI    │  │  Auth     │ │  Voice AI   │
│   Gateway    │  │  (v2.5)       │  │  Service  │ │   Agent     │
│              │  │               │  │           │ │             │
│ - Checkout   │  │ - Workout Gen │  │ - Users   │ │ - Voice Call│
│ - Webhooks   │  │ - Diet Gen    │  │ - Sessions│ │ - Workflow  │
│ - Subs       │  │               │  │ - Roles   │ │ - Variables │
└──────────────┘  └───────────────┘  └───────────┘ └─────────────┘

Installation

Prerequisites

Node.js 18.x or higher
npm or yarn or pnpm
Git
Convex Account (Sign up)
Stripe Account (Sign up)
Clerk Account (Sign up)
Google Gemini API Key (Get key)
Vapi Account (Sign up)

Step-by-Step Setup

Clone the repository

git clone https://github.com/PasinduSuraweera/ELITE-Gym-and-Fitness.git
cd ELITE-Gym-and-Fitness

Install dependencies

npm install
# or
yarn install
# or
pnpm install

Set up environment variables

Create a .env.local file in the root directory:

# Convex
CONVEX_DEPLOYMENT=your_convex_deployment_url
NEXT_PUBLIC_CONVEX_URL=your_convex_public_url

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up

# Stripe
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
STRIPE_SECRET_KEY=your_stripe_secret_key
STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret

# Google Gemini AI
GEMINI_API_KEY=your_gemini_api_key

# Vapi Voice AI (for AI Program Generator)
NEXT_PUBLIC_VAPI_API_KEY=your_vapi_public_key
NEXT_PUBLIC_VAPI_WORKFLOW_ID=your_vapi_workflow_id

# Optional: Chatbase
NEXT_PUBLIC_CHATBASE_ID=your_chatbase_id

Set up Convex

npx convex dev

This will:

Initialize your Convex project
Set up the database schema
Deploy functions to development

Configure Vapi Workflow

# In your Vapi dashboard:
1. Create a new workflow
2. Configure workflow to call your Convex HTTP endpoint
3. Set up function calling for fitness plan generation
4. Configure variables: full_name, user_id
5. Test voice interactions

Set up Stripe webhooks (for local development)

stripe listen --forward-to localhost:3000/api/webhooks/stripe

Run the development server

npm run dev
# or
yarn dev
# or
pnpm dev

Access the application

http://localhost:3000

Project Structure

ELITE-Gym-and-Fitness/
│
├── convex/                         # Convex backend
│   ├── schema.ts                  # Database schema definitions
│   ├── http.ts                    # HTTP routes & Vapi webhook handler
│   ├── users.ts                   # User queries/mutations
│   ├── memberships.ts             # Membership management
│   ├── bookings.ts                # Trainer booking system
│   ├── products.ts                # Marketplace products
│   ├── trainers.ts                # Trainer management
│   ├── fitnessPlans.ts            # Workout plans
│   ├── dietPlans.ts               # Diet plans
│   └── payments.ts                # Payment processing
│
├── src/
│   ├── app/                       # Next.js 15 App Router
│   │   ├── (auth)/               # Authentication routes
│   │   │   ├── sign-in/
│   │   │   └── sign-up/
│   │   │
│   │   ├── admin/                # Admin dashboard
│   │   │   ├── page.tsx          # Admin home
│   │   │   ├── users/            # User management
│   │   │   ├── memberships/      # Membership control
│   │   │   ├── inventory/        # Product inventory
│   │   │   ├── blog/             # Blog management
│   │   │   ├── recipes/          # Recipe management
│   │   │   ├── salary/           # Trainer salary
│   │   │   └── trainer-applications/
│   │   │
│   │   ├── api/                  # API routes
│   │   │   ├── create-checkout-session/
│   │   │   ├── create-marketplace-checkout/
│   │   │   ├── create-booking-checkout/
│   │   │   └── webhooks/
│   │   │       └── stripe/
│   │   │
│   │   ├── generate-program/     # 🎙️ Voice AI program generator
│   │   │   └── page.tsx          # Vapi voice consultation page
│   │   │
│   │   ├── profile/              # User dashboard
│   │   │   ├── page.tsx          # Profile overview
│   │   │   ├── fitness-plans/    # View workout plans
│   │   │   ├── diet-plans/       # View diet plans
│   │   │   ├── training-sessions/
│   │   │   ├── orders/
│   │   │   ├── payment-slips/
│   │   │   └── settings/
│   │   │
│   │   ├── membership/           # Membership purchase
│   │   ├── trainer-booking/      # Book training sessions
│   │   ├── become-trainer/       # Trainer application
│   │   ├── marketplace/          # E-commerce
│   │   │   ├── page.tsx
│   │   │   ├── cart/
│   │   │   └── checkout/
│   │   ├── blog/                 # Fitness blog
│   │   ├── recipes/              # Recipe database
│   │   ├── reviews/              # Product reviews
│   │   ├── about/
│   │   ├── contact/
│   │   ├── help/
│   │   ├── privacy/
│   │   └── terms/
│   │
│   ├── components/               # React components
│   │   ├── ui/                  # shadcn/ui components
│   │   ├── Navbar.tsx           # Navigation
│   │   ├── Footer.tsx
│   │   ├── AdminLayout.tsx      # Admin dashboard layout
│   │   ├── UserLayout.tsx       # User dashboard layout
│   │   ├── RoleGuard.tsx        # Authorization
│   │   ├── ThemeToggle.tsx      # Dark/Light mode
│   │   ├── NoFitnessPlan.tsx    # Empty state component
│   │   └── UserPrograms.tsx     # Display user programs
│   │
│   ├── lib/                     # Utility functions
│   │   ├── utils.ts
│   │   ├── membership-utils.ts
│   │   └── vapi.ts              # 🎙️ Vapi SDK initialization
│   │
│   ├── providers/               # Context providers
│   │   └── ConvexClerkProvider.tsx
│   │
│   └── middleware.ts            # Clerk auth middleware
│
├── public/                       # Static assets
│   ├── logo.png
│   ├── logo2.png
│   └── hero-ai.png
│
├── .env.local                    # Environment variables
├── next.config.js
├── tailwind.config.ts
├── tsconfig.json
└── package.json

Usage

For Gym Members

Sign Up & Profile Setup
- Create account via Clerk authentication
- Complete profile information
- Choose membership tier
Generate AI Fitness Plan 🎙️
- Navigate to "AI Plan Generator" page
- Click "Start Voice Consultation"
- Have a natural conversation with Vapi AI:
  - State your age, height, weight
  - Mention any injuries or limitations
  - Specify available workout days
  - Describe your fitness goals
  - Indicate fitness level
  - Share dietary restrictions
- View real-time transcript of conversation
- AI generates personalized workout and diet plans
- Automatically redirected to profile with saved plans
View Your Plans
- Access Workout Plans in profile sidebar
- Access Diet Plans in profile sidebar
- Download plans for offline reference
- Track your progress
Book Training Sessions
- Browse available trainers
- Check schedules and specializations
- Book sessions via Stripe checkout
- View bookings in profile
Shop Products
- Browse marketplace
- Add to cart
- Secure Stripe checkout
- Track orders in profile

For Trainers

Apply to Become Trainer
- Submit application via "Become Trainer" page
- Wait for admin approval
- Set up trainer profile
Manage Schedule
- View upcoming sessions
- Track earnings in dashboard
- Manage availability
Track Clients
- View assigned clients
- Access session history

For Administrators

Dashboard Overview
- Monitor platform metrics
- View user statistics
- Track revenue
User Management
- View all users
- Manage memberships
- Handle support requests
Trainer Administration
- Review trainer applications
- Approve or reject applications
- Manage trainer salaries
Content Management
- Create blog posts
- Add recipes
- Manage product inventory
System Configuration
- Configure membership tiers
- Set pricing
- Manage platform settings

Voice AI Program Generator Details

How It Works

The /generate-program page uses Vapi for voice-based fitness plan generation:

Voice Call Initiation
- User clicks "Start Consultation" button
- Vapi initializes voice call with workflow
- Custom variables passed: full_name, user_id
Conversational Data Collection
- Vapi AI asks questions naturally
- User responds via voice
- Real-time transcript displayed on screen
- Visual indicators show AI speaking state
Backend Processing
- Vapi workflow calls Convex HTTP endpoint /vapi/generate-program
- Payload includes user responses
- Google Gemini AI generates workout and diet plans
- Plans saved to Convex database
Completion & Redirect
- Voice call ends
- Success message displayed
- Auto-redirect to profile page (1.5s delay)
- Plans immediately available in profile

Voice AI Features

// Vapi Event Listeners
- call-start: Voice call begins
- call-end: Voice call completed
- speech-start: AI starts speaking
- speech-end: AI stops speaking
- message: Real-time transcripts
- error: Error handling

Key Features in Detail

Membership Tiers

Basic - Entry-level access Premium - Enhanced features Elite - Complete access with all benefits

(Configure pricing via Stripe products and Convex database)

Booking System

Real-time availability checking
Stripe integration for payments
Automated booking confirmations
Calendar management

E-Commerce

Full shopping cart functionality
Secure Stripe checkout
Order tracking
Admin inventory control

Security Features

Clerk Authentication - Enterprise-grade security
Role-Based Access Control - Admin, Trainer, User roles
Stripe PCI Compliance - Secure payment handling
Protected Routes - Middleware-based authorization
HTTPS Encryption - All data encrypted in transit
Environment Variables - Sensitive data protection
Webhook Verification - Stripe signature validation

Performance Optimizations

Turbopack - Ultra-fast development builds
Convex Real-time - Instant data updates
Image Optimization - Next.js Image component
Code Splitting - Automatic route-based splitting
Server Components - React 19 Server Components
Edge Runtime - Global low-latency responses

Roadmap & Future Features

Planned Features

Native Mobile Apps - iOS and Android
Video Workouts - On-demand fitness classes
Gamification - Achievements and leaderboards
Progress Analytics - Body composition tracking
Push Notifications - Real-time alerts
Multi-Language - Sinhala and Tamil support
Virtual Training - Live video sessions
Multi-Location - Support for gym chains

Contributing

Contributions are welcome! Help make ELITE even better.

How to Contribute:

Fork the Project
Create your Feature Branch
```
git checkout -b feature/AmazingFeature
```
Commit your Changes
```
git commit -m 'Add some AmazingFeature'
```
Push to the Branch
```
git push origin feature/AmazingFeature
```
Open a Pull Request

License

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

Author

Pasindu Suraweera

Acknowledgments

Next.js - The React framework for production
Convex - Real-time backend platform
Stripe - Payment infrastructure
Clerk - Authentication and user management
Vapi - Voice AI platform for conversational interfaces
Google Gemini - AI-powered plan generation
shadcn/ui - Beautiful component library
Tailwind CSS - Utility-first CSS framework
🇱🇰 The Sri Lankan fitness community

Support

Need help or have questions?

If you find ELITE Gym & Fitness useful, please give it a star!

Made for Sri Lanka 🇱🇰

Transform your fitness journey with AI-powered voice consultations and personalized plans

Name		Name	Last commit message	Last commit date
convex		convex
public		public
src		src
.gitignore		.gitignore
CHATBASE_SETUP.md		CHATBASE_SETUP.md
README.md		README.md
components.json		components.json
debug-webhook.js		debug-webhook.js
eslint.config.mjs		eslint.config.mjs
get-price-ids.js		get-price-ids.js
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
stripe-config.js		stripe-config.js
test-recipes.md		test-recipes.md
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation