Platform Overview
JCV Fitness combines intelligent personalization, comprehensive exercise and nutrition databases, and modern subscription management into a seamless fitness platform. Here’s everything you need to know about what makes JCV Fitness powerful.All features are built with Next.js 16, React 19, and TypeScript, ensuring a fast, type-safe, and modern user experience.
Core Features
Interactive Workout Wizard
9-step personalization engine for creating custom fitness plans
Meal Planning System
Personalized nutrition plans with food exchange tables
Subscription Management
Multi-tier pricing with MercadoPago payment integration
Exercise Library
100+ exercises with form videos and alternatives
Secure Authentication
Supabase-powered auth with magic links and row-level security
PDF Generation
Downloadable plans with personalized watermarks
Interactive Workout Wizard
Our signature 9-step wizard collects comprehensive information to generate truly personalized fitness programs.How It Works
The wizard is built with Zustand for state management, ensuring smooth transitions and data persistence:Step Breakdown
Step 1: Training Level
Purpose: Determines exercise complexity and progression speedOptions:
- Principiante (Beginner) - < 3 months experience
- Básico (Basic) - 3-6 months experience
- Intermedio (Intermediate) - 6-18 months experience
- Avanzado (Advanced) - 2+ years experience
- Elite - 4+ years competitive experience
- Beginners get simpler exercises with detailed form cues
- Advanced users get complex compound movements and periodization
- Elite athletes receive sport-specific programming
Step 2: Training Goal
Purpose: Defines program structure and exercise selectionEight specialized goals:
- 🔥 Quemar Grasa - Fat loss with metabolic conditioning
- 💪 Ganar Musculo - Hypertrophy focus with progressive overload
- ✨ Tonificar - Body recomposition and definition
- 🏃 Resistencia - Cardiovascular endurance and stamina
- 🧘 Flexibilidad - Mobility and injury prevention
- 🏋️ Fuerza Pura - Powerlifting-style strength training
- ⚡ Más Energía - General fitness and vitality
- ❤️ Salud General - Holistic health and wellness
- Fat loss gets HIIT and circuit training
- Muscle gain gets 8-12 rep ranges with higher volume
- Strength gets 1-5 rep ranges with longer rest periods
Step 3: Time Availability
Purpose: Creates realistic training schedulesOptions:
- 2-3 days/week - Full body splits
- 4-5 days/week - Upper/lower or push/pull/legs
- 6-7 days/week - Body part splits or specialized programs
- Lower frequency gets more exercises per session
- Higher frequency allows targeted muscle group focus
- Rest days are strategically placed for recovery
Step 4: Equipment Access
Purpose: Ensures all exercises are performableOptions:
- Casa (Home) - Bodyweight, bands, dumbbells
- Gimnasio (Gym) - Full equipment access
- Ambos (Both) - Hybrid programming
- Home plans use progressive calisthenics
- Gym plans leverage barbells and machines
- Hybrid plans offer location flexibility
Step 5: Workout Duration
Purpose: Fits training into your scheduleOptions:
- 20-30 minutes - Condensed, efficient workouts
- 45-60 minutes - Standard training sessions
- 60-90 minutes - Extended, high-volume training
- Shorter sessions use supersets and circuits
- Longer sessions allow traditional straight sets
- Warm-up and cool-down scale with duration
Step 6: Body Measurements
Purpose: Calculates nutritional needs and tracks progressCollected data:
- Age (affects metabolism calculations)
- Current weight (in kg)
- Height (in cm)
- Target weight (optional)
- Body fat percentage (optional)
- Determines caloric needs using Harris-Benedict equation
- Influences macronutrient ratios
- Establishes baseline for progress tracking
Step 7: Exercise Preferences
Purpose: Personalizes exercise selectionFeatures:
- Browse 100+ exercise library
- Mark exercises to avoid (injuries/limitations)
- Star favorite exercises to prioritize
- Filter by muscle group and equipment
- Avoided exercises are never included
- Favorites appear more frequently
- Alternatives are provided for variety
Step 8: Food Preferences
Purpose: Creates enjoyable, sustainable meal plansCollected information:
- Dietary restrictions (vegetarian, vegan, pescatarian, etc.)
- Allergies and intolerances
- Disliked foods to exclude
- Meal frequency preference (3-6 meals/day)
- Cooking time availability
- Only includes foods you can and will eat
- Respects ethical/religious dietary choices
- Adjusts meal timing to your schedule
Step 9: Review Summary
Purpose: Final verification before plan generationShows:
- All selections from previous steps
- Estimated plan characteristics
- Option to edit any previous step
- Plan generation confirmation
- Saves wizard data to
wizard_datatable - Generates personalized plan
- Redirects to subscription selection
Technical Implementation
The wizard uses modern React patterns for optimal performance:Meal Planning System
Personalized nutrition plans are generated based on your body measurements, goals, and food preferences.Components
Daily Meal Plans
Structured meals for breakfast, lunch, dinner, and snacks
Food Exchange Tables
Swap foods within categories while maintaining macros
Macro Breakdown
Protein, carbs, fats, and calorie targets
Portion Guidance
Exact measurements for each food item
Meal Plan Structure
Meal plans are organized by phase and day:Food Exchange System
Users can substitute foods within the same category:Food exchanges maintain equivalent macronutrient profiles, allowing meal variety without recalculating your entire plan.
Subscription System
Flexible multi-tier subscription model with secure payment processing.Available Plans
- Básico
- Pro
$49,900 COP/monthEntry-level plan includes:
- 7-day meal plan template
- Home workout routine
- Basic app access
- Email support
- Plan downloads (with watermark)
Payment Integration
JCV Fitness uses MercadoPago for secure payment processing:Webhook Processing
Payment confirmations are processed via Cloudflare Workers:Exercise Library
100+ exercises with comprehensive details and video demonstrations.Exercise Categories
- Push Exercises - Chest, shoulders, triceps
- Pull Exercises - Back, biceps, rear delts
- Leg Exercises - Quads, hamstrings, glutes, calves
- Core Exercises - Abs, obliques, lower back
- Cardio - HIIT, steady state, conditioning
- Mobility - Stretching, flexibility, warm-ups
Exercise Data Structure
Exercise Videos
Pro and Premium subscribers get access to:- Proper form demonstrations
- Common mistake corrections
- Progression and regression videos
- Muscle activation cues
/videos.
Authentication System
Secure authentication powered by Supabase with multiple sign-in methods.Authentication Methods
- Email & Password
- Magic Link
- Password Reset
Traditional authentication with email verification:
Authentication Context
The auth system uses React Context for global state:Row-Level Security
All database access is protected by Supabase RLS policies:Row-level security ensures users can never access another user’s workout plans, meal plans, or subscription information - even if they try to manipulate API requests.
Protected Routes
Pages requiring authentication use theProtectedRoute component:
PDF Generation
Download personalized plans with user-specific watermarks to prevent unauthorized sharing.Available Downloads
- Workout Plans - Complete training program with all exercises
- Meal Plans - Nutrition program with recipes and portions
- Exercise Library - Reference guide for all exercises
- Food Exchange Tables - Meal substitution guide
PDF Features
Personalized Watermarks
Each PDF includes the user’s name to prevent sharing
Professional Formatting
Clean, printer-friendly layout
Offline Access
View plans without internet connection
Download Tracking
Track downloads in plan_downloads table
Download Process
Download Limits
- Básico: 5 downloads per month
- Pro: 15 downloads per month
- Premium: Unlimited downloads
plan_downloads table:
User Dashboard
Centralized hub for managing your fitness journey at/dashboard.
Dashboard Components
Plan Status Card
Plan Status Card
Shows current fitness plan information:
- Plan creation date
- Days since plan started
- Progress percentage
- Quick links to workout and meal plans
Subscription Card
Subscription Card
Displays subscription details:
- Current plan tier (Básico/Pro/Premium)
- Next renewal date
- Payment method on file
- Upgrade/downgrade buttons
- Cancel subscription option
Quick Actions
Quick Actions
Fast access to common tasks:
- Create new workout plan
- Regenerate meal plan
- Download PDF
- View exercise videos
- Browse food exchanges
User Profile
User Profile
Account information and settings:
- Name and email
- Account creation date
- Profile photo upload
- Edit profile button
Video Tutorials
Video Tutorials
Educational content library:
- Platform walkthrough videos
- Exercise technique guides
- Meal prep tutorials
- FAQ videos
Additional Features
Freemium Model
New users get access to 5-week trial plans before subscribing:- Complete the wizard without payment
- View sample workout and meal plans
- Limited feature access
- Upgrade anytime to unlock full features
WhatsApp Support
Direct support channel at +57 314 382 6430:- Quick response times
- Personalized guidance
- Technical support
- Coaching questions (Premium only)
Progress Tracking
Track your fitness journey over time:- Weight and body measurement logging
- Workout performance tracking
- Before/after photo comparisons
- Progress charts and graphs
Community Features (Premium)
Premium subscribers get VIP community access:- Private Discord/Telegram group
- Weekly Q&A sessions
- Recipe sharing
- Motivation and accountability
Technical Specifications
Frontend Stack
Backend Services
Database Tables
profiles- User profile informationsubscriptions- Active subscription recordswizard_data- Saved wizard responsesuser_plans- Generated fitness plansplan_downloads- Download trackingwebhook_logs- Payment webhook historysubscription_audit_log- Subscription change history
Next Steps
Create Your Plan
Follow the quickstart guide to create your first personalized plan
Technical Documentation
Deep dive into system architecture and implementation
API Reference
Complete API documentation for developers
User Guides
Step-by-step guides for all platform features