MODRACXKENNETH D'SILVA

← Documentation Hub

Iron Discipline Calisthenics PWA: Reference Manual

An offline-first Progressive Web App for progressive bodyweight and calisthenics training. Features an 800+ exercise biomechanical graph, zero-backend IndexedDB data sovereignty, synthesized Web Audio rest timers, and mathematical wave overload periodization.

1. System Architecture & Offline Topology

Iron Discipline does not connect to external logging or user telemetry servers. The application is delivered via a Service Worker cache and stores all user data in the browser's local IndexedDB engine.

Component Technology Role in Architecture
Local Database IndexedDB + Dexie.js Transactional asynchronous storage for workouts, sets, and progression state
Caching Engine Workbox 7 Service Worker Pre-caching application shell, fonts, and exercise metadata
Sound Engine Web Audio API Low-latency synthesized oscillator tones for rest timers without MP3 assets
State Management Zustand + Immer High-performance reactive workout state machine with zero layout jank

2. Progressive Overload & Leverage Progression Engine

Progressive overload in calisthenics is achieved through mechanical advantage modulation rather than simply adding mass. Iron Discipline calculates progression criteria across 5 major movement pillars:

  • Horizontal Push: Push-up → Diamond Push-up → Pseudo-Planche Push-up → Straddle Planche → Full Planche
  • Vertical Push: Pike Push-up → Elevated Pike → Wall Handstand Push-up → Freestanding HSPU → 90-Degree Push-up
  • Vertical Pull: Dead Hang → Negative Pull-up → Strict Pull-up → L-Sit Pull-up → Chest-to-Bar → Muscle-up
  • Horizontal Pull: Incline Row → Horizontal Row → Tuck Front Lever Row → Full Front Lever Row
  • Legs & Posterior: Bodyweight Squat → Bulgarian Split Squat → Pistol Squat → Dragon Pistol → Nordic Curl

3. Offline Installation (PWA)

Iron Discipline can be installed as a standalone native-like application across all major operating systems:

  • iOS (Safari): Tap the Share button in Safari → Tap "Add to Home Screen".
  • Android (Chrome): Tap the three-dot menu → Tap "Install App".
  • macOS / Windows / Linux (Chrome/Edge): Click the install icon in the address bar.

4. Data Backup & Privacy Model

Because there is no cloud database, users maintain absolute data sovereignty. Iron Discipline provides an automated backup tool in Settings > Backup & Storage that creates a timestamped, schema-validated JSON export with SHA-256 integrity verification.