Gymkhana developer docs

API preview, architecture roadmap, and marketplace catalog. The live gym app runs on https://app.gymkhana.fit/; this site is marketing + developers.

Public API v1 (preview)
Preview: 2 endpoints shipped — GET /api/v1/members, GET /api/v1/analytics/cashflow. More endpoints follow domain route migration.
GET /api/v1/membersList members (session or API token)
GET /api/v1/analytics/cashflowCashflow analytics for the active gym

Call these on the product host (https://app.gymkhana.fit/api/v1/members). Auth: session or Bearer token — configure MCP in product Settings → Agent clients.

Architecture docs (OSS repo)
Engineering roadmap and route audit in the public product repo.

Development roadmap

What we ship today, what we are working on, and what is not scheduled.

Done

Core product (shipped)

  • Members, memberships, payments, billing, renewals
  • QR attendance and dashboard analytics
  • WhatsApp reminders (Meta Cloud API)
  • Multi-gym tenancy
  • In-dashboard marketplace installs (Razorpay, class booking, member portal, etc.)
Done

Developer surface (shipped)

  • API reference and interactive playground (this site)
  • Self-host and deployment docs
  • OAuth client_credentials token endpoint (v1)
In progress

In progress

  • Webhook delivery and signing
  • Public API v1 expansion (follows OSS route → domain migration)
  • Agent / MCP integrations (product app → Settings → Agent clients)
Backlog

Backlog (no dates)

Tracked when scoped — not committed to quarterly releases.

  • Third-party OAuth apps directory
  • JS / Python client SDKs
  • External plugin store and developer monetization
Exploring

Exploring only

Ideas under evaluation. Not on the current delivery plan.

  • Sandboxed plugin runtime and hook system
  • Theme marketplace and verified developer badges
  • Mobile SDK, IoT integrations, multi-language packs

Marketplace

Install flagship apps from the product dashboard — class booking, Razorpay, member portal, WhatsApp Business API, and more. Opens on the app host (https://app.gymkhana.fit/dashboard/marketplace).

Scheduling

Class Booking & Schedule

Group classes, capacity, and member bookings

Install in dashboard
Payments

Razorpay Online Payments

UPI, cards, and payment links for renewals

Install in dashboard
Mobile

Member Mobile App

PWA for members — classes, pay, membership card

Install in dashboard
Messaging

WhatsApp Business API

Official WABA templates & delivery receipts

Beta
Localization

India Localization

Hindi, Bengali, INR pricing, and India-first GTM

Install in dashboard
Ecosystem

Integration Hub

Accounting, access control, fitness trackers

Beta

Self-host locally

Run the open-source gym app on your machine, then use this site for marketing and the interactive playground. Production app: https://app.gymkhana.fit/

# Product (port 3000)
git clone https://github.com/gymkhana-fitness-360/gymkhana.git gymkhana && cd gymkhana
cp .env.example .env && npm install && npm run dev

# Cloud / marketing (port 3001) — sibling repo gymkhana-cloud
# NEXT_PUBLIC_PRODUCT_APP_URL=http://localhost:3000