Canonical source: the canonical features document for this domain is
deep-dive/features.md, rendered in the docs
center. This file is its operational companion (service topology, APIs,
schemas, runtime detail) — reconciled by linking, not duplicated (§2, §13).
Comprehensive fitness, wellness, and movement intelligence platform covering
every dimension of physical training -- from yoga and martial arts to
AI-powered form analysis and VR fitness experiences.
Table of Contents#
The foundational layer providing domain types, validation schemas, database
schema, event system, and authentication for the entire Shakti ecosystem.
| Capability |
Description |
| Domain type system |
Comprehensive TypeScript types covering exercises, workouts, sessions, users, instructors, and programs |
| Validation schemas |
Zod-powered runtime validation for all data flowing through the platform |
| Database schema |
Production-ready Drizzle ORM schema for persistent data storage |
| Domain event system |
Event bus for cross-module communication (workout completed, streak achieved, form score recorded) |
| Authentication |
User and instructor authentication with role-based access control |
Yoga and Mindfulness#
A complete yoga instruction system covering asanas, breathing, sequencing,
multiple yoga styles, meditation, and Ayurvedic personalization.
Asana Library#
| Capability |
Description |
| Complete asana database |
Every major yoga pose with Sanskrit and English names, alignment cues, muscle engagement, and difficulty ratings |
| Contraindication tracking |
Each asana annotated with contraindications (injuries, pregnancy, blood pressure) to keep practitioners safe |
| Modification variants |
Beginner, intermediate, and advanced modifications for each pose with prop suggestions |
| Muscle group targeting |
Detailed muscle engagement maps showing which muscles are stretched, strengthened, or stabilized in each pose |
Pranayama (Breathwork)#
| Capability |
Description |
| Breathing technique library |
Comprehensive breathwork techniques (Ujjayi, Nadi Shodhana, Kapalabhati, Bhramari, Box Breathing) with timing patterns |
| Physiological effects |
Documented physiological effects of each technique (calming, energizing, balancing) for informed practice selection |
| Guided timing patterns |
Inhale, hold, exhale ratio configurations for different experience levels |
Sequence Building#
| Capability |
Description |
| Intelligent sequencing |
Automatically order poses with logical transitions, warm-up progression, peak poses, and cool-down |
| Style-specific sequences |
Generate sequences appropriate to specific yoga styles (Vinyasa flow, Ashtanga series, Yin holds) |
| Duration targeting |
Build sequences that fit specified time durations while maintaining pedagogical completeness |
| Custom sequence creation |
Drag-and-drop sequence builder with transition validation |
Yoga Styles#
| Capability |
Description |
| Vinyasa |
Flowing breath-synchronized sequences with creative transitions |
| Ashtanga |
Traditional Ashtanga series with correct pose ordering and progression criteria |
| Yin |
Long-held passive poses with fascia-targeting guidance |
| Restorative |
Prop-supported gentle poses for deep relaxation |
| Kundalini |
Kundalini kriyas with mantra, breathwork, and meditation integration |
| Bikram/Hot yoga |
26-posture hot yoga sequence with heat considerations |
Meditation and Ayurveda#
| Capability |
Description |
| Guided meditation frameworks |
Meditation session templates with guided instructions, ambient sound, and timer management |
| Ayurvedic constitution assessment |
Dosha (Vata, Pitta, Kapha) assessment questionnaire with personalized practice recommendations |
| Practice recommendations |
Yoga and lifestyle recommendations tailored to individual constitution and seasonal considerations |
Strength Training#
Comprehensive exercise science and programming for resistance training at every
level.
Exercise Database#
| Capability |
Description |
| Comprehensive exercise library |
Hundreds of exercises with muscle group targeting, equipment requirements, and detailed form descriptions |
| Compound lifts |
In-depth coverage of the squat, deadlift, bench press, and overhead press with biomechanical analysis |
| Olympic weightlifting |
Complete snatch and clean-and-jerk technique libraries with progression sequences |
| Calisthenics progressions |
Bodyweight exercise skill trees from beginner to advanced (muscle-ups, levers, planches) |
Programming#
| Capability |
Description |
| Program templates |
Proven programs including 5/3/1, Starting Strength, GZCL, PPL, Upper/Lower, and full-body templates |
| Powerlifting meet prep |
Competition preparation with peaking cycles, attempt selection strategy, and meet-day protocols |
| Hypertrophy optimization |
Volume, intensity, and frequency optimization for maximum muscle growth based on current research |
| Periodization |
Linear, undulating, and block periodization with auto-regulated deload detection |
Martial Arts#
A comprehensive martial arts technique library covering striking, grappling,
traditional forms, weapons, and rank progression.
Technique Database#
| Capability |
Description |
| Striking techniques |
Punches, kicks, elbows, and knees with biomechanical analysis, common errors, and drilling progressions |
| Grappling techniques |
Positions, submissions, escapes, sweeps, and transitions for ground-based martial arts |
| MMA integration |
Combined striking and grappling curriculum for mixed martial arts |
| Traditional forms |
Kata (karate), poomsae (taekwondo), and taolu (kung fu) with step-by-step breakdowns |
| Weapons training |
Bo staff, nunchaku, sword forms, and other traditional weapons with safety protocols |
Progression and Competition#
| Capability |
Description |
| Belt/rank tracking |
Multi-style rank progression tracking with grading criteria and testing requirements |
| Sparring management |
Sparring session management with rules configuration, scoring, and partner matchmaking |
| Technique difficulty progression |
Progressive difficulty curves that build from fundamentals to advanced techniques |
Combat Sports#
Sport-specific training modules for competitive combat disciplines.
| Capability |
Description |
| Boxing |
Boxing-specific training including bag work, mitt work, footwork drills, and ring tactics |
| Kickboxing |
Kickboxing technique and conditioning programs with round-based timing |
| Muay Thai |
Muay Thai clinch work, elbow and knee techniques, and traditional conditioning |
| Wrestling |
Takedowns, pins, scrambles, and wrestling-specific conditioning |
| MMA training |
MMA-specific fight preparation with skill integration, conditioning, and game planning |
Mobility and Recovery#
Flexibility, recovery, and injury prevention tools for maintaining movement
quality and longevity.
| Capability |
Description |
| Static and dynamic stretching |
Stretching protocol library with muscle targeting, hold durations, and progression |
| Joint mobility routines |
Joint-specific mobility work using CARs (Controlled Articular Rotations), PAILs, and RAILs |
| Self-myofascial release |
Foam rolling and lacrosse ball protocols organized by body region with video guidance |
| Recovery protocols |
Recovery modality management (cold therapy, heat therapy, compression, contrast therapy) with scheduling |
| Injury prevention |
Pre-habilitation routines and functional movement screening (FMS-style assessments) |
| Rehabilitation progressions |
Return-to-training protocols with graduated loading and clearance checkpoints |
Biometric Tracking#
Health and performance biometrics from heart rate variability to body
composition, with integration across major wearable devices.
Heart Rate and Recovery#
| Capability |
Description |
| Heart rate monitoring |
Real-time heart rate tracking with zone calculation (resting, fat burn, cardio, peak, anaerobic) |
| HRV analysis |
Heart rate variability analysis for recovery assessment, stress monitoring, and readiness scoring |
| Cardiac drift detection |
Detect cardiovascular drift during prolonged exercise for real-time intensity adjustment |
| Recovery scoring |
Composite recovery score combining HRV, sleep quality, subjective readiness, and recent training load |
Body and Performance#
| Capability |
Description |
| Body composition tracking |
Track body composition changes over time with DEXA-equivalent estimate calculations from circumference measurements |
| Performance metrics |
1RM estimates (Epley, Brzycki, Lombardi formulas), power output tracking, and VO2max estimation |
| Training load monitoring |
Acute and chronic training load monitoring with training stress balance and injury risk indicators |
Device Integrations#
| Capability |
Description |
| Apple Watch |
HealthKit integration for heart rate, workouts, activity rings, and sleep |
| Garmin |
Garmin Connect integration for multisport data, running dynamics, and training status |
| Whoop |
Whoop strap integration for strain, recovery, and sleep metrics |
| Oura Ring |
Oura Ring integration for sleep, readiness, and activity data |
| Polar |
Polar device integration for heart rate and training data |
Computer vision-powered exercise form analysis that provides real-time feedback
and post-session review.
| Capability |
Description |
| Motion capture |
Pose estimation from device cameras using ML models (MediaPipe, TensorFlow.js) to capture body joint positions |
| Form quality scoring |
Per-joint angle analysis that scores exercise form quality against ideal movement patterns |
| Technique-specific analysis |
Bar path tracking for lifts, depth checking for squats, elbow flare detection for bench press, and discipline-specific checks |
| Real-time visual feedback |
Live visual overlays showing form corrections, angle measurements, and alignment guides during exercise |
| Audio cues |
Voice-based real-time coaching cues (e.g., "Drive your knees out", "Keep your chest up") |
| Post-session video analysis |
Review recorded sessions with annotated form analysis, side-by-side comparison with ideal form, and rep-by-rep scoring |
Personalization and AI Coaching#
Adaptive training that evolves with each user based on their goals, progress,
recovery, and preferences.
| Capability |
Description |
| Practitioner profiling |
Comprehensive user profiles covering fitness level, goals, injury history, schedule, equipment access, and preferences |
| Adaptive programming |
Training programs that auto-adjust based on performance trends, recovery status, and schedule changes |
| AI workout generation |
LLM and rule-system-powered workout plan generation constrained by user profile, available equipment, and time |
| Recommendation engine |
Suggest exercises, programs, and content based on training history, goals, and community patterns |
| Goal management |
Set, track, and celebrate fitness goals with milestone markers and progress visualization |
| Readiness-based scheduling |
Automatically adjust training intensity and volume based on daily readiness scores |
Gamification and Motivation#
Engagement systems that make training addictive through achievements, streaks,
challenges, and competition.
| Capability |
Description |
| Achievement system |
Unlock badges and achievements for training milestones (first 5K, 100 sessions, bodyweight squat) |
| Streak tracking |
Daily and weekly training streak tracking with freeze mechanics (sick days, rest days) and recovery incentives |
| XP and leveling |
Experience point system with leveling, skill trees, and specialization paths |
| Challenges |
Individual and group challenges with time-limited goals, leaderboards, and completion rewards |
| Leaderboards |
Global and friend leaderboards with anti-gaming measures and fair comparison brackets |
| Virtual rewards |
Cosmetic unlocks, profile customization items, and virtual achievement items |
Community and Social#
Social features connecting practitioners, enabling accountability, and building
training communities.
| Capability |
Description |
| Training profiles |
Public training profiles with privacy controls showing workout history, achievements, and PRs |
| Activity feed |
Social feed showing training logs, achievements, and community activity |
| Training groups |
Create and manage training groups for team workouts, group challenges, and community building |
| Accountability partners |
Match with accountability partners for check-ins, shared goals, and mutual motivation |
| Messaging |
In-app messaging between users and between users and instructors |
Audio and Voice#
Audio content delivery and voice-controlled hands-free training.
| Capability |
Description |
| Audio workout content |
Audio-guided workouts with instructions, timing cues, and motivational coaching |
| Music integration |
Spotify and Apple Music integration with BPM-matched playlists for workout intensity |
| Voice commands |
Hands-free voice control for starting/stopping workouts, navigating exercises, and querying timers |
Video Content#
Video content infrastructure for instructional libraries, follow-along workouts,
and live streaming.
| Capability |
Description |
| Video content management |
Upload, transcode, and deliver video content through CDN |
| Instructional video library |
Categorized video library with searchable exercise demonstrations |
| Follow-along workouts |
Follow-along workout player with synchronized timer, rep counter, and exercise cues |
| Live class streaming |
Live class streaming infrastructure with real-time viewer interaction |
3D Visualization and Immersive Training#
Visual training tools from 3D anatomy overlays to full VR fitness experiences.
| Capability |
Description |
| 3D avatar system |
Customizable 3D avatars with body proportion matching for movement visualization |
| Anatomy visualization |
3D anatomy overlay showing which muscles are being activated during each exercise |
| Movement visualization |
Visualize movement trajectories, range of motion arcs, and joint paths |
| VR training environments |
Immersive VR fitness experiences for Meta Quest and Apple Vision Pro |
| AR exercise guidance |
Augmented reality overlays providing real-world exercise guidance and form feedback |
Tools for fitness professionals to build their business, manage clients, and
create content.
Program Building#
| Capability |
Description |
| Program builder |
Drag-and-drop program creation tool with periodization templates |
| Client management |
Client roster with individual progress tracking, communication, and scheduling |
| Assessment tools |
Client assessment and movement screening tools for intake and progress evaluation |
| Content creation |
Create and publish training content (workout plans, technique videos, articles) |
Business Analytics#
| Capability |
Description |
| Revenue analytics |
Revenue tracking, subscription metrics, and income projections |
| Retention analytics |
Client retention rates, churn analysis, and engagement scoring |
| Engagement metrics |
Content engagement metrics showing which workouts and programs perform best |
Studio and Gym Management#
Operations tools for running fitness facilities -- from scheduling to equipment
management.
| Capability |
Description |
| Facility management |
Room booking, space scheduling, and facility layout management |
| Equipment management |
Equipment inventory, maintenance scheduling, and utilization tracking |
| Class management |
Class scheduling with capacity limits, waitlists, and instructor assignment |
| Membership management |
Membership plans, billing integration, access control, and member self-service |
| Staff management |
Staff scheduling, payroll integration, role-based permissions, and performance tracking |
Events and Scheduling#
Live events, competitions, and calendar management for the fitness community.
| Capability |
Description |
| Class scheduling |
Recurring class and session scheduling with instructor and room assignment |
| Live class delivery |
Infrastructure for delivering live classes with real-time participant interaction |
| Competitions and tournaments |
Competition and tournament management with bracket generation, scoring, and results |
| Workshops and special events |
Workshop organization with registration, capacity management, and materials distribution |
| Calendar integration |
Two-way sync with Google Calendar, Apple Calendar, and Outlook |
Certifications and Credentials#
Manage instructor certifications, continuing education, and platform
credentialing.
| Capability |
Description |
| Credential management |
Verify, store, and display instructor certifications from recognized bodies |
| Continuing education |
Track continuing education requirements, credits, and renewal deadlines |
| Licensing and insurance |
Licensing and professional liability insurance compliance tracking |
| Shakti certification program |
Platform-native certification program with curriculum, assessment, and credential issuance |
State-of-the-Art Critical Features#
Research-driven features based on competitive analysis against Tonal, Whoop,
Down Dog, Zwift, Supernatural VR, Fitbod, PUSH, and Oura.
| Capability |
Description |
Competitive Reference |
| Mental health and mood tracking |
Track mood, stress, and mental wellness alongside physical training with integrated recommendations |
Whoop, Oura |
| Readiness-based scheduling |
Adjust training plans based on daily readiness scores from sleep, HRV, and subjective input |
Whoop, Oura |
| Velocity-based training |
Track bar speed with camera or sensors for autoregulated training intensity |
PUSH, Tonal |
| Dynamic sequence generation |
AI-generated workout sequences that adapt in real-time based on performance and energy |
Down Dog, Fitbod |
| Virtual world gamification |
Zwift-style virtual environments where training in the real world drives avatar progress through virtual landscapes |
Zwift |
| Longevity and healthspan |
Protocols targeting longevity markers (VO2max, grip strength, balance, metabolic health) |
Peter Attia-inspired |
| Genetic and biomarker training |
Training recommendations informed by genetic profiles and blood biomarker results |
InsideTracker, DNAfit |
| VR fitness experiences |
Full-body VR workouts with immersive environments and movement tracking |
Supernatural VR |
| Smart gym intelligence |
Integration with smart gym equipment (Tonal, Tempo, connected racks) for automated load and rep tracking |
Tonal, Tempo |
| AI health coaching |
Proactive AI coaching that identifies trends, suggests interventions, and provides personalized health guidance |
Whoop Coach |
| Advanced social and live |
Live training with friends, group challenges with video, and social accountability features |
Peloton, Strava |
| Edge AI offline |
On-device ML models for form analysis without internet connectivity |
Apple Watch |
| Voice-first interface |
Voice-first hands-free interface for complete workout control without touching a screen |
Alexa Fitness |
| Data privacy controls |
User data export, deletion, and granular sharing controls with GDPR/CCPA compliance |
Apple Health |
| Enterprise B2B |
Corporate wellness programs, gym chain management, and white-label platform capabilities |
Gympass, ClassPass |
State-of-the-Art Advanced Features#
Additional advanced capabilities extending the platform's competitive edge.
| Capability |
Description |
| AI personal trainer |
Conversational AI coach that adapts to your style, remembers your history, and provides motivational support |
| Advanced biomechanical analysis |
Joint angle tracking, force vector estimation, and biomechanical efficiency scoring |
| Deep wearable integration |
Real-time bidirectional communication with wearables for live metric display and haptic feedback |
| Predictive analytics |
Predict injury risk, performance plateaus, and optimal training windows using ML models |
| Social competitive features |
Real-time head-to-head training competitions, team battles, and virtual group classes |
| Accessibility and inclusion |
Adaptive training for users with disabilities, age-appropriate modifications, and inclusive representation |
| Nutrition integration |
Holistic nutrition tracking, macro management, and meal timing relative to training |
| Smart equipment integration |
Deep integration with smart barbells, smart cables, and connected cardio equipment |
| Research-science integration |
Exercise science research database with evidence ratings and study summaries informing program design |
| Global cultural features |
Cultural adaptation of exercises, movement traditions, and training philosophies from around the world |
API and Developer SDK#
Programmatic access to the Shakti platform for third-party integrations and
custom applications.
| Capability |
Description |
| REST API |
Complete REST API covering exercises, workouts, sessions, users, social, and analytics |
| SDK core |
TypeScript SDK client with authentication, request handling, and error management |
| Resource wrappers |
Type-safe API wrappers for exercises, workouts, users, programs, and analytics |
| SDK utilities |
Helper functions for pagination, caching, and common operations |
Web, mobile, testing, deployment, and documentation infrastructure.
Web Application#
| Capability |
Description |
| Next.js foundation |
Production-ready Next.js application with routing, SSR, and optimization |
| Core pages |
Dashboard, workout library, progress tracking, and user profile pages |
| Instructor portal |
Instructor dashboard for client management, content creation, and analytics |
| Studio/gym portal |
Facility owner portal for operations management |
| Video features |
Integrated video player with workout synchronization |
| Marketing pages |
Public-facing marketing and landing pages |
Mobile Application#
| Capability |
Description |
| React Native foundation |
Cross-platform mobile app for iOS and Android |
| Core screens |
Home, workouts, timer, profile, and progress screens |
| Workout features |
Workout tracking, interval timers, and exercise guidance |
| Offline content |
Download content for offline access |
| Health integration |
HealthKit and Google Fit integration for cross-platform health data |
| Platform-specific features |
iOS and Android specific features (widgets, shortcuts, notifications) |
Capability Summary Tables#
Training Discipline Coverage#
| Discipline |
Exercise DB |
Technique Library |
Sequencing |
Progression |
Competition |
| Yoga |
Full asana DB |
Alignment cues |
Intelligent sequencing |
Style mastery |
- |
| Strength |
Hundreds of exercises |
Compound lift mechanics |
Program templates |
Progressive overload |
Powerlifting meets |
| Martial arts |
Striking + grappling |
Biomechanical analysis |
Curriculum design |
Belt/rank system |
Sparring |
| Combat sports |
Sport-specific drills |
Sport-specific technique |
Round-based training |
Skill levels |
Tournament |
| Mobility |
Stretching + mobility |
Joint-specific protocols |
Recovery routines |
ROM tracking |
- |
| Calisthenics |
Bodyweight exercises |
Skill progressions |
Skill tree paths |
Skill milestones |
- |
Technology Integration Points#
| Technology |
Purpose |
Key Capabilities |
| Computer Vision |
Form analysis |
Pose estimation, angle measurement, real-time feedback |
| Machine Learning |
Personalization |
Adaptive programming, recommendation, injury prediction |
| Wearable Devices |
Biometrics |
Heart rate, HRV, sleep, readiness, body composition |
| VR/AR |
Immersive training |
Virtual worlds, AR form guidance, spatial training |
| Voice AI |
Hands-free control |
Voice commands, audio coaching, conversational AI |
| Smart Equipment |
Connected training |
Load tracking, rep counting, velocity measurement |
| Edge AI |
Offline intelligence |
On-device form analysis without internet |
Competitive Feature Matrix#
| Feature |
Shakti |
Tonal |
Whoop |
Down Dog |
Zwift |
Peloton |
| Strength training |
Full |
Full |
- |
- |
- |
Moderate |
| Yoga |
Full |
- |
- |
Full |
- |
Moderate |
| Martial arts |
Full |
- |
- |
- |
- |
- |
| Form analysis |
CV-powered |
Hardware |
- |
- |
- |
- |
| Recovery tracking |
HRV + sleep |
- |
Full |
- |
- |
- |
| VR fitness |
Quest + AVP |
- |
- |
- |
- |
- |
| Virtual worlds |
Zwift-style |
- |
- |
- |
Full |
- |
| Live classes |
Video stream |
- |
- |
- |
Yes |
Full |
| Smart equipment |
Multi-brand |
Proprietary |
- |
- |
Proprietary |
Proprietary |
| Nutrition |
Full |
- |
- |
- |
- |
- |
| Community |
Groups + social |
- |
- |
- |
Clubs |
Leaderboard |
| Instructor tools |
Full platform |
- |
- |
- |
- |
- |
| Certifications |
Full program |
- |
- |
- |
- |
- |
| Studio management |
Full operations |
- |
- |
- |
- |
- |
User Journey Capability Map#
| Stage |
Capabilities |
| Onboarding |
Fitness assessment, goal setting, dosha assessment, equipment inventory |
| Daily training |
AI-generated workouts, form analysis, voice guidance, music sync |
| Progress |
Biometric tracking, streak maintenance, achievement unlocks, PR tracking |
| Recovery |
HRV analysis, recovery scoring, mobility routines, readiness scheduling |
| Community |
Social feed, training groups, challenges, accountability partners |
| Growth |
Skill progression, certification programs, advanced technique mastery |
| Teaching |
Program builder, client management, content creation, business analytics |