<div>
  <h2>FitForge Installation and Deployment Guide</h2>
  <p>This guide covers local setup for development and production deployment to a Linux VPS. Follow the sections in order. A mid-level developer should be able to run the full stack locally in under 30 minutes.</p>

  <h3>Prerequisites</h3>
  <ul>
    <li>Python 3.10 or higher</li>
    <li>Node.js 18 or higher and npm</li>
    <li>Flutter 3.x with Flutter SDK in PATH</li>
    <li>Android Studio or Xcode for mobile emulator (or a physical device)</li>
    <li>Git</li>
    <li>A Razorpay account (test keys are free) — optional for local dev, mock mode works without it</li>
  </ul>

  <h3>Step 1: Clone the Repository</h3>
  <pre><code>git clone https://github.com/your-org/fitforge.git
cd fitforge</code></pre>

  <p>The repo is organized into three directories: <code>backend/</code>, <code>frontend/</code>, and <code>mobile/</code>. Run each service independently.</p>

  <h3>Step 2: Backend Setup (Django)</h3>
  <pre><code>cd backend
python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt</code></pre>

  <p>Copy and configure the environment file:</p>
  <pre><code>cp .env.example .env</code></pre>

  <p>Open <code>.env</code> and set at minimum:</p>
  <pre><code>SECRET_KEY=your-long-random-secret-key
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1
TIME_ZONE=Asia/Kolkata
ACCESS_TOKEN_MINUTES=60
REFRESH_TOKEN_DAYS=7
FRONTEND_URL=http://localhost:3000
RAZORPAY_KEY_ID=           # leave blank to use mock mode
RAZORPAY_KEY_SECRET=       # leave blank to use mock mode
RAZORPAY_WEBHOOK_SECRET=
WHATSAPP_API_URL=          # leave blank to log notifications to console
WHATSAPP_API_TOKEN=
ENABLE_CELERY=False</code></pre>

  <p>Run migrations and seed demo data:</p>
  <pre><code>python manage.py migrate
python manage.py seed_demo
python manage.py runserver 0.0.0.0:8000</code></pre>

  <p>API is available at <code>http://localhost:8000/api/</code>. Django admin at <code>http://localhost:8000/admin/</code>.</p>

  <h3>Demo Accounts</h3>
  <p>All demo accounts use password <code>demo1234</code>.</p>
  <ul>
    <li>Owner — phone: +919800000001 — full dashboard access</li>
    <li>Staff — phone: +919800000002 — dashboard, no settings</li>
    <li>Trainer — phone: +919800000101 — limited dashboard views</li>
    <li>Member — phone: +919900000001 — mobile app only</li>
  </ul>
  <p>To reset the demo: <code>python manage.py seed_demo --reset</code></p>

  <h3>Step 3: Frontend Setup (Next.js Dashboard)</h3>
  <pre><code>cd ../frontend
npm install
cp .env.example .env.local</code></pre>

  <p>Edit <code>.env.local</code>:</p>
  <pre><code>NEXT_PUBLIC_API_URL=http://localhost:8000/api
NEXT_PUBLIC_RAZORPAY_KEY_ID=       # leave blank for mock mode</code></pre>

  <pre><code>npm run dev</code></pre>

  <p>Dashboard available at <code>http://localhost:3000</code>. Log in with the Owner or Staff credentials above.</p>

  <h3>Step 4: Mobile App Setup (Flutter)</h3>
  <pre><code>cd ../mobile
flutter pub get</code></pre>

  <p>Run on Android emulator (default API URL targets Android emulator host):</p>
  <pre><code>flutter run</code></pre>

  <p>Run on a physical device or with a custom backend URL:</p>
  <pre><code>flutter run \
  --dart-define=API_BASE_URL=http://192.168.1.50:8000/api \
  --dart-define=RAZORPAY_KEY_ID=rzp_test_xxxxxxxxxxxx</code></pre>

  <p>Replace <code>192.168.1.50</code> with your machine's local IP address.</p>

  <h3>Step 5: Build for Production</h3>

  <h4>Backend — Production Settings</h4>
  <pre><code># .env for production
SECRET_KEY=a-long-unpredictable-key-never-commit-this
DEBUG=False
ALLOWED_HOSTS=yourdomain.com,www.yourdomain.com
DATABASE_URL=               # optional — defaults to SQLite3, switch to postgres:// for scale
RAZORPAY_KEY_ID=rzp_live_xxxxxxxxxxxx
RAZORPAY_KEY_SECRET=your-live-secret
RAZORPAY_WEBHOOK_SECRET=your-webhook-secret
WHATSAPP_API_URL=https://api.whatsapp-provider.com/v1/messages
WHATSAPP_API_TOKEN=your-token
ENABLE_CELERY=False         # set True only if you add a Redis broker</code></pre>

  <pre><code>python manage.py collectstatic --noinput</code></pre>

  <h4>Frontend — Production Build</h4>
  <pre><code>cd frontend
npm run build</code></pre>

  <p>Build output goes to <code>.next/</code>. Serve with <code>npm run start</code> or use <code>pm2</code> for process management.</p>

  <h4>Mobile — Release APK</h4>
  <pre><code>cd mobile
flutter build apk --release \
  --dart-define=API_BASE_URL=https://api.yourdomain.com/api \
  --dart-define=RAZORPAY_KEY_ID=rzp_live_xxxxxxxxxxxx</code></pre>

  <p>APK output: <code>build/app/outputs/flutter-apk/app-release.apk</code></p>

  <h3>Step 6: VPS Deployment (Ubuntu 22.04)</h3>

  <h4>Install System Dependencies</h4>
  <pre><code>sudo apt update && sudo apt upgrade -y
sudo apt install -y python3 python3-pip python3-venv nginx nodejs npm git</code></pre>

  <h4>Deploy Django Backend with Gunicorn and systemd</h4>
  <pre><code>cd /var/www/fitforge/backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt gunicorn
cp .env.example .env   # edit with production values
python manage.py migrate
python manage.py collectstatic --noinput</code></pre>

  <p>Create a systemd service file at <code>/etc/systemd/system/fitforge.service</code>:</p>
  <pre><code>[Unit]
Description=FitForge Django Backend
After=network.target

[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/fitforge/backend
ExecStart=/var/www/fitforge/backend/venv/bin/gunicorn \
    --workers 3 \
    --bind unix:/run/fitforge.sock \
    config.wsgi:application
EnvironmentFile=/var/www/fitforge/backend/.env
Restart=always

[Install]
WantedBy=multi-user.target</code></pre>

  <pre><code>sudo systemctl daemon-reload
sudo systemctl enable fitforge
sudo systemctl start fitforge</code></pre>

  <h4>Deploy Next.js Frontend</h4>
  <pre><code>cd /var/www/fitforge/frontend
npm install
npm run build</code></pre>

  <p>Create a systemd service at <code>/etc/systemd/system/fitforge-frontend.service</code>:</p>
  <pre><code>[Unit]
Description=FitForge Next.js Dashboard
After=network.target

[Service]
User=www-data
WorkingDirectory=/var/www/fitforge/frontend
ExecStart=/usr/bin/npm run start
Environment=PORT=3001
Restart=always

[Install]
WantedBy=multi-user.target</code></pre>

  <pre><code>sudo systemctl daemon-reload
sudo systemctl enable fitforge-frontend
sudo systemctl start fitforge-frontend</code></pre>

  <h4>Configure Nginx</h4>
  <p>Create <code>/etc/nginx/sites-available/fitforge</code>:</p>
  <pre><code>server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    location /api/ {
        proxy_pass http://unix:/run/fitforge.sock;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    location /admin/ {
        proxy_pass http://unix:/run/fitforge.sock;
        proxy_set_header Host $host;
    }

    location /static/ {
        alias /var/www/fitforge/backend/staticfiles/;
    }

    location / {
        proxy_pass http://127.0.0.1:3001;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}</code></pre>

  <pre><code>sudo ln -s /etc/nginx/sites-available/fitforge /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx</code></pre>

  <h4>SSL with Certbot</h4>
  <pre><code>sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com</code></pre>

  <p>Certbot auto-renews. Verify with <code>sudo certbot renew --dry-run</code>.</p>

  <h3>Razorpay Webhook Setup</h3>
  <p>In the Razorpay dashboard, create a webhook pointing to <code>https://yourdomain.com/api/billing/webhook/</code>. Set the webhook secret in your backend <code>.env</code> as <code>RAZORPAY_WEBHOOK_SECRET</code>. The platform verifies HMAC signatures on every webhook event.</p>

  <h3>WhatsApp Notifications</h3>
  <p>FitForge supports any REST-based WhatsApp API provider. Set <code>WHATSAPP_API_URL</code> and <code>WHATSAPP_API_TOKEN</code> in the backend <code>.env</code>. If these are blank, all notification dispatch logs to the Django console — useful for development and staging.</p>
</div>

<div>
  <p>Running a gym is straightforward. Billing is manageable. Attendance is trackable. Classes are schedulable. But building software that handles all of it without breaking when 300 members hit it on Monday morning — that is the hard part. FitForge is that software, and it is ready to ship.</p>

  <p>This is a production-grade gym and fitness studio management platform built with a Django REST backend, a Next.js admin dashboard for owners and staff, and a Flutter mobile app for members. It covers the full operational surface of running a gym: memberships, billing via Razorpay, QR-based attendance, class scheduling, diet plans, progress tracking, trainer management, and WhatsApp notifications. You buy it, deploy it, and brand it as your own. Your gym clients use your product.</p>

  <h2>What This Product Does</h2>

  <h3>For Gym Owners and Staff — Web Dashboard</h3>
  <p>The admin dashboard is where gym operations actually happen. Owners get full control: create and manage membership plans, oversee member accounts, monitor attendance in real time using QR scanning or manual check-in, assign diet plans, and track renewal alerts for expiring memberships. Trainers get a scoped view — they see their assigned members, manage class schedules, and track individual progress logs. Staff can handle day-to-day operations without touching billing configuration or system settings.</p>

  <h3>For Members — Flutter Mobile App</h3>
  <p>Members download the app, log in with their phone or email, and get instant access to their membership status, attendance calendar, class schedule, assigned diet plan, and progress charts. They can book or cancel classes, pay for membership renewals directly through Razorpay, scan or show their QR code at the gym entrance, and log their own body metrics over time. The app is built on Riverpod with a clean Obsidian Gold theme — deep black backgrounds, gold accents — and performs fast on both Android and iOS.</p>

  <h3>Payments and Billing</h3>
  <p>Razorpay handles all transactions. Members can renew their subscriptions from the mobile app. Staff can process renewals from the dashboard on behalf of members. The platform supports both live and test mode, plus a full mock mode that works without any gateway credentials — useful for demos and local development before you go live.</p>

  <h2>Key Features</h2>
  <ul>
    <li>JWT authentication with phone or email login for both web and mobile</li>
    <li>Role-based access for Owner, Staff, Trainer, and Member roles</li>
    <li>Membership plan management with custom pricing, duration, and features</li>
    <li>QR code attendance scanning from the web dashboard — no extra hardware needed</li>
    <li>Manual attendance check-in and check-out with detailed reports</li>
    <li>Weekly class schedule board with booking and cancellation from the member app</li>
    <li>Razorpay billing with test mode and mock mode built in</li>
    <li>WhatsApp notification dispatch for renewal reminders and broadcasts</li>
    <li>Trainer profiles with assigned member lists and performance views</li>
    <li>Structured diet plan assignment per member, viewable on mobile</li>
    <li>Progress tracking with weight, body fat, and photo logs, plus trend charts</li>
    <li>Expiring membership alerts on the dashboard with renewal prompts</li>
    <li>Dashboard analytics with stats, charts, and activity summaries</li>
    <li>Full demo seed data for testing — all roles, plans, and transactions pre-loaded</li>
    <li>Multi-tenant lite architecture — every query scoped to the authenticated gym</li>
  </ul>

  <h2>Who This Is Built For</h2>

  <h3>Gym and Fitness Studio Owners</h3>
  <p>If you own a gym, a crossfit box, a yoga studio, or a boutique fitness space and you are tired of managing members in spreadsheets or paying recurring SaaS fees for software you do not fully control — FitForge gives you the full stack. White-label it, deploy it on your server, and stop paying per-member fees forever.</p>

  <h3>Fitness Tech Startups</h3>
  <p>Building a fitness management product from scratch takes months. FitForge compresses that to days. You get a working backend, a polished admin panel, and a mobile app, all in one purchase. Customise the branding, extend the feature set, and launch your product without writing boilerplate authentication, billing integration, or attendance logic.</p>

  <h3>Software Agencies Serving the Fitness Industry</h3>
  <p>If a gym client comes to you for a management platform, you have two options: quote three months of custom development, or deploy FitForge with their branding in a week. The second option wins deals. CodeAj's <a href="https://startup.codeaj.com/services/customization">product customization and white-labeling service</a> can handle the branding work for you if needed.</p>

  <h3>SaaS Founders Targeting Gym Chains</h3>
  <p>FitForge's multi-tenant lite architecture is already scoped per gym. Extending it to a full multi-tenant SaaS — where each gym chain is an isolated tenant — requires extending the existing queryset scoping, not rewriting the platform. The foundation is there.</p>

  <h2>Real-World Applications and Use Cases</h2>
  <p>A standalone gym in a metro city replaces their paper attendance register and WhatsApp-based renewal reminders with FitForge. Members check in with QR codes. The owner gets an expiry alert dashboard. Renewal income becomes predictable.</p>

  <p>A fitness franchise with five locations deploys one instance per location, each with their own data and admin staff, under a shared parent domain. No per-seat SaaS fees. Total infrastructure cost is one VPS per location.</p>

  <p>A fitness tech startup acquires FitForge, rebrands it as their own product, adds a custom workout logging module, and launches to their first hundred gym clients within four weeks of purchase.</p>

  <p>An agency building for a yoga chain uses FitForge as the base layer, swaps out the attendance module for a booking-first flow, recolors the dashboard, and ships to the client in two weeks instead of three months.</p>

  <h2>Why Buy This Instead of Building It</h2>
  <p>Building what FitForge already has from scratch — authentication, role-based access, billing integration, QR attendance, class scheduling, mobile app, and WhatsApp notifications — takes a senior developer at minimum four to five months. At market rate for a full-stack developer in India, that is roughly ₹4 to ₹6 lakh in development cost before you have written a single line of business logic. You also pay that cost every time you need a new feature or a bug fixed.</p>

  <p>FitForge is priced at a fraction of that. You get the complete source code, the documentation, and optional deployment support. The money you save in the first month covers the purchase. Every month after that is pure margin.</p>

  <p>If you need changes specific to your business — different billing flows, extra roles, a custom reporting layer — the <a href="https://startup.codeaj.com/services/customization">customization service at CodeAj Startup</a> handles it. You describe what you need, we scope and build it on top of the FitForge codebase you already own.</p>

  <h2>What You Get on Purchase</h2>
  <ul>
    <li>Full Django REST backend source code with all apps, models, serializers, views, and URL configs</li>
    <li>Full Next.js 14 frontend source code — App Router, JSX only, Tailwind, all dashboard pages</li>
    <li>Full Flutter mobile app source code with Riverpod state management and Razorpay integration</li>
    <li>Database schema with migration files — SQLite3 for local, easily swappable to PostgreSQL for production</li>
    <li>Demo seed script that pre-loads a complete gym with members, trainers, plans, and transactions</li>
    <li>Environment variable templates for backend, frontend, and mobile</li>
    <li>Deployment guide covering VPS setup, Nginx, Gunicorn, systemd, SSL, and domain configuration</li>
    <li>Backend and frontend README files with full API reference and route documentation</li>
    <li>Developer onboarding session available as an add-on — <a href="https://startup.codeaj.com/contact">contact CodeAj Startup</a> to schedule</li>
  </ul>

  <p>FitForge is part of the <a href="https://startup.codeaj.com">CodeAj Startup marketplace</a> — a curated catalog of production-ready software products built for founders who want to move fast without compromising on code quality.</p>
</div>

FitForge is a production-ready gym management SaaS — Django backend, Next.js dashboard, Flutter member app. Buy the source code and launch your own platform.

Gym Management Software Source Code — CodeAj Startup

A full-stack gym management SaaS with a web admin dashboard and a Flutter member app. Ready for real gym owners to run on day one.

Your Details

FitForge — Gym & Fitness Studio Management Platform