Eve library

Shakti Domain -- Product Capabilities

Guide

Revision 1

On this page

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#


Core Platform#

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

AI Form Analysis#

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

Instructor and Business Tools#

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

Platform Infrastructure#

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