IQ Iron Fitness
Cloud-hosted gym management platform and billing engine
The Problem
The gym owner needed to track 110+ active members, handle billing, and calculate trainer pay. The system had to run smoothly on an older laptop and provide a usable mobile experience on an iPhone 15 Pro Max. There was no room for a heavy, sluggish UI.
The Solution
Built a Next.js + Supabase cloud platform with real-time sync, a custom billing engine that generates membership invoices, and a salary-slip builder that computes trainer commissions. The dashboard gives the owner an immediate operational snapshot: pending memberships, expiring memberships, expired memberships, today’s birthdays, outstanding payments, and monthly collection totals.
Architecture & Flow
A cloud-hosted architecture with real-time data sync, automated billing, and a hardware-conscious UI layer.
Real-time Sync
Supabase subscriptions broadcast changes instantly across all connected devices.
Billing Engine
Computes membership dues, tracks payments, and generates downloadable invoices.
Salary-Slip Generator
Calculates trainer base pay plus PT commissions and produces employee salary statements.
Hardware-Conscious UI
Responsive design tested and optimized for older hardware and iOS Safari.
Key Challenges & Fixes
Client-Side Invoice Rendering
Issue: Generating print-accurate invoice layouts on mobile browsers caused CSS overflow bugs.
Fix: Implemented a clean grid-based print layout using flexbox and standard print styles, producing high-resolution outputs without heavy library dependencies.
Concurrent State Updates
Issue: Multiple receptionists updating records simultaneously caused stale data and UI inconsistencies.
Fix: Configured optimistic UI updates via React hooks alongside Supabase real-time replication broadcasts, keeping the interface responsive while maintaining data integrity.
Impact & Metrics
Business Value
Replaced manual record-keeping with a cloud platform that gives the owner instant operational visibility. Billing and payroll are automated, and the system is built to scale comfortably as the gym grows toward 500+ members.
Engineering Lessons
Designing for real-world hardware constraints, like the owner’s specific older laptop, shapes performance and UI decisions more than abstract benchmarks ever will.
Future Roadmap
Full SMS gateway integration and biometric scanner API sync.