⚡ GYM ENGINE

A Modern Role-Based Gym Management & Fitness Booking Platform

   

🚀 Live Demo  ·  📖 Docs  ·  🐛 Report Bug  ·  ✨ Request Feature

---

🌟 What is Gym Engine?

Gym Engine is a full-stack gym management ecosystem that empowers fitness centers to operate smarter. Users can join, train, book fitness classes, and manage programs — all through a beautifully designed, role-aware interface.

Whether you're an admin managing the whole gym, a trainer running classes, or a member crushing goals — Gym Engine has a tailored experience built just for you.

---

✨ Core Features

🔐 Authentication & Security NextAuth + JWT dual-layer auth Role-based route protection Secure password hashing with bcryptjs Session persistence & token refresh 👥 Role Management Admin — Full platform control Trainer — Class & schedule management Member — Booking & progress tracking Non-member — Browse & onboard

📅 Class & Booking System Real-time class scheduling Trainer assignment per class Seat availability management Booking confirmation flow 📊 Dashboard & Analytics Role-specific dashboards Admin analytics & user tracking Dark / Light mode support Mobile-responsive layouts

---

🧑‍💻 User Roles at a Glance

┌─────────────┬───────────────────────────────────────────────────────┐
│    Role     │  Capabilities                                          │
├─────────────┼───────────────────────────────────────────────────────┤
│  🛡️ Admin   │  Full control: users, schedules, analytics, settings  │
│  🏋️ Trainer │  Manage own classes, set schedules, view members       │
│  👤 Member  │  Book classes, track progress, choose trainers         │
│  👥 Non-mem │  Browse programs, register, upgrade to member          │
└─────────────┴───────────────────────────────────────────────────────┘

---

🏋️ Fitness Programs

Program	Description	Level
🟢 Basic Fitness	Foundation training for beginners	Beginner
🧘 Yoga	Flexibility, balance & mindfulness	All Levels
💪 Body Building	Structured hypertrophy programs	Intermediate
🔥 Muscle Courses	Advanced strength & conditioning	Advanced

---

🛠️ Tech Stack

🖥️ Frontend	⚙️ Backend
Next.js — React framework with SSR/SSG TypeScript — Type-safe development Tailwind CSS — Utility-first styling NextAuth.js — Authentication flows Axios — HTTP client	Node.js — Runtime environment Express.js — RESTful API server MongoDB — NoSQL database JWT — Stateless auth tokens bcryptjs — Password encryption

---

🔄 System Flow

User Login
    │
    ▼
Role Detection ──────────────────────────────────┐
    │                                             │
    ▼                                             ▼
Admin Dashboard              Member / Trainer Dashboard
    │                                   │
    ▼                                   ▼
Manage Users             Browse & Book Classes
Manage Schedules                 │
View Analytics                   ▼
                         Select Trainer
                                 │
                                 ▼
                         Confirm Booking ✅

---

🔥 Demo Credentials

⚡ Try the platform instantly — no sign-up needed!

Role	Email	Password
🛡️ Admin	admin@gmail.com	123456
🏋️ Trainer	trainer@gmail.com	123456
👤 Member	member@gmail.com	123456
👥 Non-member	nonmember@gmail.com	123456

---

🌐 API Base URL

https://gym-engine-server.vercel.app/api/v1

---

📁 Project Structure

🖥️ Frontend	⚙️ Backend (MVC)
src/ ├── app/ # Next.js app router ├── components/ # Reusable UI components ├── assets/ # Images & static files ├── lib/ # Helper functions └── styles/ # Global styles	src/ ├── controllers/ # Route handlers ├── models/ # Mongoose schemas ├── routes/ # API route definitions ├── middlewares/ # Auth & validation ├── config/ # DB & env config └── utils/ # Shared utilities

---

📦 Installation

1. Clone the Repositories

# Frontend
git clone https://github.com/tuhin360/gym-engine-client.git
cd gym-engine-client

# Backend
git clone https://github.com/tuhin360/gym-engine-server.git
cd gym-engine-server

2. Install Dependencies

npm install

3. Configure Environment Variables

Frontend — create .env.local:

NEXT_PUBLIC_API_URL=https://gym-engine-server.vercel.app/api/v1
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_nextauth_secret

Backend — create .env:

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
FRONTEND_URL=http://localhost:3000

4. Run Locally

# Frontend
npm run dev   # → http://localhost:3000

# Backend
npm run dev   # → http://localhost:5000

---

📊 Key Modules

Module	Technology	Description
🔐 Auth Module	NextAuth + JWT	Secure login, role detection, session handling
🏋️ Class Management	Express + MongoDB	CRUD for fitness classes & schedules
📅 Schedule Manager	REST API	Create, update & delete time slots
👤 RBAC	Middleware + JWT	Role-based access control across all routes
📈 Analytics Dashboard	Next.js + Charts	Admin insights, user activity, booking trends

---

🚀 Roadmap

• Role-based authentication & dashboards
• Class booking & trainer assignment
• Admin analytics
• Dark / Light mode
• 📱 Mobile App (React Native)
• 🔔 Real-time push notifications
• 💬 In-app chat (Trainer ↔ Member)
• 📊 Advanced analytics & reporting
• 🌍 Multi-language / i18n support
• 💳 Payment integration

---

👨‍💻 Author

Jahedi Alam Tuhin

---

⭐ Support the Project

If Gym Engine helped you or you find it interesting, please consider giving it a ⭐ star on GitHub — it means a lot and helps others discover the project!

    ★ Star    →  github.com/tuhin360

---

Made with ❤️ and 🏋️ by Jahedi Alam Tuhin