Skip to main content

Mo - Development Plan Document

1. Development Approach​

PrincipleDescription
Vertical SlicesBuild complete features end-to-end (DB → API → UI)
Ship EarlyDeploy after Sprint 0, iterate continuously
You FirstYou're the first user - build what you need
Mobile FirstAll features work on mobile before desktop polish
Core Before PolishFunctionality first, animations/3D later

2. Sprint Overview​

SprintDurationFocusOutcome
03-4 daysSetupProject scaffolded, deployed, ready to build
15-7 daysAuth + OnboardingUsers can sign up and complete onboarding
27-10 daysWorkout CoreLog workouts, track sets/reps
35-7 daysDashboard + ProgressMoBoard, weight tracking, basic stats
45-7 daysAI CoachMoCoach chat with personality
55-7 daysExercise Library + ProgramsMoGuide, MoPhase, wellness guide data
65-7 daysPolish + PWAAnimations, offline, installable
75-7 daysPayments + LaunchStripe, final testing, launch

Total Estimated Duration: 6-8 weeks

3. Sprint 0: Project Setup​

Duration: 3-4 days Goal: Development environment ready, deployed skeleton

Tasks​

TaskPriorityTimeDetails
Initialize Next.js 15P01hrApp router, TypeScript, Tailwind v4
Configure shadcn/uiP01hrInstall base components
Setup Drizzle + NeonP02hrDatabase connection, initial schema
Run initial migrationsP01hrUsers, coaches tables
Configure ClerkP02hrAuth provider, create OAuth apps
Setup Vercel projectP01hrDeploy, environment variables
Configure ESLint/PrettierP030minCode quality rules
Setup project structureP01hrFolders per architecture doc
Create design tokensP02hrTailwind config from UI doc
Setup Framer MotionP11hrBase animation config
Create base componentsP13hrButton, Card, Input with Mo styling
Setup CI/CDP11hrGitHub Actions for linting/tests

Checklist​

□ Next.js 15 with App Router
□ TypeScript configured
□ Tailwind v4 with design tokens
□ shadcn/ui installed
□ Drizzle ORM configured
□ Neon database connected
□ Initial migrations run
□ Clerk authentication setup
□ Google OAuth configured
□ Apple OAuth configured
□ Vercel project deployed
□ Environment variables set
□ ESLint + Prettier configured
□ Project structure created
□ Base UI components created
□ GitHub repo initialized

Deliverable​

Empty app deployed at production URL with:

  • Working auth flow (Clerk)
  • Database connected
  • Design system ready

4. Sprint 1: Authentication + Onboarding​

Duration: 5-7 days Goal: Users can create account and complete onboarding

Tasks​

TaskPriorityTimeDetails
Landing page (basic)P04hrHero section, features, pricing, CTA
Clerk sign-up flowP02hrEmail + OAuth options
Clerk sign-in flowP01hrReturn users
User creation on signupP02hrWebhook or first-login handler
Users table completeP01hrAll fields from schema
Coaches table + seedP03hr8 coaches with system prompts
Onboarding: GoalsP02hrGoal selection screen
Onboarding: ExperienceP02hrExperience level screen
Onboarding: StatsP02hrHeight, weight, goal weight
Onboarding: QuizP13hrPersonality matching quiz
Onboarding: CoachesP03hrCoach selection (1-8)
Onboarding: ProgramP02hrProgram selection
Onboarding: CompleteP01hrSave all data, redirect
Protected routesP02hrMiddleware for auth + onboarding
User profile APIP02hrGET/PATCH /users/me

Database Tables​

-- Users (expand from Sprint 0)
users (
  id, clerk_id, email, full_name, avatar_url,
  height_cm, current_weight, goal_weight,
  experience, fitness_goal, units, theme,
  subscription, onboarded_at, created_at, updated_at
)

-- Coaches
coaches (
  id, name, slug, gender, role, personality,
  voice_example, avatar_url, system_prompt, is_active
)

-- User's selected coaches
user_coaches (
  id, user_id, coach_id, is_primary, context, created_at
)

API Endpoints​

EndpointMethodDescription
/api/v1/users/meGETGet current user
/api/v1/users/mePATCHUpdate profile
/api/v1/users/me/onboardingPOSTComplete onboarding
/api/v1/users/me/coachesGETGet selected coaches
/api/v1/users/me/coachesPUTUpdate coach selection
/api/v1/coachesGETList all coaches

Screens Built​

  • MoHome (landing page - basic)
  • Sign Up (Clerk hosted/embedded)
  • Sign In (Clerk hosted/embedded)
  • Onboarding: Goal Selection
  • Onboarding: Experience Level
  • Onboarding: Starting Stats
  • Onboarding: Personality Quiz
  • Onboarding: Coach Selection
  • Onboarding: Program Selection
  • Onboarding: Welcome/Ready

Checklist​

□ Landing page live
□ Sign up working (email)
□ Sign up working (Google)
□ Sign up working (Apple)
□ Sign in working
□ User created in database on signup
□ Onboarding flow complete (6 steps)
□ Coaches seeded in database
□ Coach selection saving
□ Personality quiz matching
□ Protected routes working
□ Redirect to onboarding if incomplete
□ Redirect to dashboard if complete

Deliverable​

New users can:

  1. Visit landing page
  2. Sign up with email or OAuth
  3. Complete 6-step onboarding
  4. Select their coach(es)
  5. Land on dashboard (empty)

5. Sprint 2: Workout Core​

Duration: 7-10 days Goal: Log complete workouts with sets, reps, weights

Tasks​

TaskPriorityTimeDetails
Exercises table + seedP04hr50+ exercises from wellness guide
Programs table + seedP04hrPPL program with phases
Program phases tableP02hrFoundation, Hypertrophy, etc.
Program days tableP02hrPush A, Pull B, etc.
Program exercises tableP02hrExercises per day
Workouts tableP02hrUser workout sessions
Workout sets tableP02hrIndividual set logs
User programs tableP01hrTrack user's enrollment
Today's workout APIP03hrCalculate scheduled workout
Workout preview screenP03hrShow exercises before starting
Start workout APIP02hrCreate workout record
Active workout screenP06hrMain logging interface
Set logging componentP04hrWeight/reps input
Log set APIP02hrSave individual sets
Rest timer componentP03hrCountdown with coach tip
Complete workout APIP02hrFinish and calculate stats
Workout complete screenP03hrSummary, duration, volume
Previous performanceP12hrShow last workout data
PR detectionP13hrAuto-detect and save PRs
Personal records tableP11hrStore PRs
PR celebration modalP12hrConfetti + coach message

Database Tables​

-- Exercises
exercises (
  id, name, slug, category, equipment,
  primary_muscles, secondary_muscles,
  instructions, tips, common_mistakes,
  demo_url, video_url, is_active
)

-- Programs
programs (
  id, name, slug, description, duration_weeks,
  experience, goal, is_active
)

-- Program phases
program_phases (
  id, program_id, phase_number, name,
  weeks, description, focus
)

-- Program days
program_days (
  id, phase_id, day_number, name,
  workout_type, is_rest_day
)

-- Program exercises
program_exercises (
  id, program_day_id, exercise_id, order,
  sets, reps_min, reps_max, rpe_target,
  rest_seconds, notes, is_warmup
)

-- User programs
user_programs (
  id, user_id, program_id, current_phase,
  current_week, status, started_at, completed_at
)

-- Workouts
workouts (
  id, user_id, program_day_id, date, status,
  started_at, completed_at, duration_min,
  coach_greeting, coach_summary, notes,
  mood_before, mood_after, created_at
)

-- Workout sets
workout_sets (
  id, workout_id, exercise_id, set_number,
  weight, reps, rpe, is_warmup, is_pr,
  notes, completed_at
)

-- Personal records
personal_records (
  id, user_id, exercise_id, weight, reps,
  estimated_1rm, achieved_at, workout_set_id, created_at
)

API Endpoints​

EndpointMethodDescription
/api/v1/workouts/todayGETGet today's scheduled workout
/api/v1/workoutsPOSTStart a new workout
/api/v1/workouts/:idGETGet workout details
/api/v1/workouts/:idPATCHUpdate workout (complete, skip)
/api/v1/workouts/:id/setsPOSTLog a set
/api/v1/workouts/:id/sets/:setIdPATCHUpdate a set
/api/v1/workouts/historyGETGet workout history
/api/v1/exercisesGETList exercises
/api/v1/programs/enrollPOSTEnroll in program

Screens Built​

  • Workout Preview (MoLog)
  • Active Workout (MoLog)
  • Rest Timer (overlay)
  • Workout Complete
  • PR Celebration (modal)

Checklist​

□ Exercises seeded (50+)
□ PPL program seeded
□ Today's workout API working
□ Workout preview shows exercises
□ Can start workout
□ Set logging UI functional
□ Weight input with +/- buttons
□ Reps input with +/- buttons
□ Sets save to database
□ Rest timer counts down
□ Coach tips show during rest
□ Can skip rest timer
□ Previous performance displayed
□ PR auto-detection working
□ PR celebration shows
□ Workout completion saves
□ Duration tracked
□ Volume calculated

Deliverable​

Users can:

  1. See today's workout
  2. Start workout session
  3. Log weight and reps for each set
  4. Use rest timer between sets
  5. See their previous performance
  6. Get PR celebrations
  7. Complete and save workout

6. Sprint 3: Dashboard + Progress​

Duration: 5-7 days Goal: Dashboard with stats, weight tracking, progress charts

Tasks​

TaskPriorityTimeDetails
Dashboard layoutP03hrMoBoard structure
Coach greeting componentP02hrDynamic from selected coach
Today's workout cardP02hrQuick access widget
Streaks tableP01hrTrack workout streaks
Streak calculationP02hrLogic for streak counting
Streak display componentP02hrFire icon + counter
Weight entries tableP01hrDaily weight logs
Weight logging screenP03hrMoBody entry screen
Weight logging APIP02hrCRUD for weight
Weight chart componentP04hrRecharts line chart
Weekly averagesP02hrCalculate from entries
Progress overview APIP02hrDashboard stats endpoint
Quick actions gridP02hrWeight, Coach, Stats buttons
Workout history listP13hrPast workouts
Strength progress chartP13hrPR tracking over time
Volume chartP22hrWeekly volume

Database Tables​

-- Weight entries
weight_entries (
  id, user_id, weight, date, notes, created_at
  UNIQUE(user_id, date)
)

-- Streaks
streaks (
  id, user_id, current_streak, longest_streak,
  last_workout, updated_at
)

API Endpoints​

EndpointMethodDescription
/api/v1/progress/overviewGETDashboard stats
/api/v1/progress/streaksGETStreak data
/api/v1/weightGETWeight history
/api/v1/weightPOSTLog weight
/api/v1/weight/:idPATCHUpdate entry
/api/v1/weight/:idDELETEDelete entry
/api/v1/weight/statsGETWeekly averages, trends
/api/v1/progress/prsGETPersonal records

Screens Built​

  • MoBoard (Dashboard)
  • MoBody (Weight tracking)
  • MoStats (Progress - basic)

Checklist​

□ Dashboard layout complete
□ Coach greeting displays
□ Today's workout card works
□ Streak counter shows
□ Streak calculation accurate
□ Weight logging screen
□ Weight saves to database
□ Weight chart renders
□ Weekly average calculated
□ Quick actions work
□ Workout history loads
□ PR list displays
□ All stats update in real-time

Deliverable​

Users can:

  1. See dashboard with greeting
  2. View current streak
  3. Access today's workout quickly
  4. Log daily weight
  5. View weight trend chart
  6. See weekly averages
  7. View workout history
  8. Track PRs

7. Sprint 4: AI Coach​

Duration: 5-7 days Goal: Chat with AI coach in their unique personality

Tasks​

TaskPriorityTimeDetails
Vercel AI SDK setupP02hrInstall, configure
Claude API integrationP02hrAPI key, client setup
Coach system promptsP04hr8 unique personalities
Chat messages tableP01hrStore conversation
Chat UI layoutP03hrMessage list, input
Chat bubble componentP02hrUser vs coach styling
Coach avatar in chatP01hrShow coach image
Send message APIP03hrStream response
Streaming displayP03hrReal-time text rendering
Chat history APIP02hrLoad previous messages
Context builderP13hrInclude user stats in prompt
Coach switchingP12hrChange coach mid-chat
Typing indicatorP11hrDots animation
Coach greeting APIP12hrContext-aware greeting
Clear chatP21hrDelete history option
Workout tipsP22hrTips during workout

Database Tables​

-- Chat messages
chat_messages (
  id, user_id, coach_id, role, content,
  context, created_at
)

API Endpoints​

EndpointMethodDescription
/api/v1/coach/chatPOSTSend message (streaming)
/api/v1/coach/chat/historyGETGet chat history
/api/v1/coach/chat/historyDELETEClear chat history
/api/v1/coach/greetingGETGet contextual greeting
/api/v1/coach/tipGETGet workout tip

Coach System Prompts Structure​

const coachPrompts = {
  sam: {
    name: "Sam",
    role: "The Buddy",
    personality: `You are Sam, a friendly and supportive fitness coach.
    You speak like a workout buddy - encouraging, warm, and balanced.
    You celebrate wins, show empathy for struggles, and keep things positive.
    Example phrases: "Let's crush this together!", "You got this!", "Great work!"
    Never be harsh or critical. Always find the positive angle.`,
    // ... context injection points
  },
  max: {
    name: "Max",
    role: "Drill Sergeant",
    personality: `You are Max, a tough and intense fitness coach.
    You speak like a drill sergeant - direct, no-nonsense, pushing for results.
    You don't accept excuses and demand the best effort.
    Example phrases: "No excuses.", "Get it done.", "Push harder."
    Be tough but fair. Challenge users to exceed their limits.`,
    // ...
  },
  // ... other coaches
};

Screens Built​

  • MoCoach (Chat interface)

Checklist​

□ Claude API connected
□ System prompts for all 8 coaches
□ Chat UI complete
□ Messages save to database
□ Streaming responses work
□ Chat history loads
□ Coach personality distinct
□ Context includes user stats
□ Coach switching works
□ Typing indicator shows
□ Greeting API works
□ Mobile keyboard handling

Deliverable​

Users can:

  1. Open MoCoach chat
  2. Send messages to their coach
  3. Receive streaming responses
  4. See coach personality in responses
  5. Switch between coaches
  6. View chat history
  7. Get contextual advice based on their data

8. Sprint 5: Exercise Library + Programs​

Duration: 5-7 days Goal: Browse exercises, view program details, import wellness guide

Tasks​

TaskPriorityTimeDetails
Exercise library screenP04hrGrid/list view
Exercise searchP02hrFull-text search
Muscle group filterP02hrFilter tabs
Exercise detail screenP04hrFull info page
Exercise demo displayP02hrGIF/video player
Exercise historyP12hrUser's history with exercise
Program overview screenP03hrMoPhase layout
Phase displayP02hrShow all phases
Current phase highlightP01hrVisual indicator
Week progressP02hrProgress bar
Import wellness guideP06hrParse and seed content
Exercise instructionsP02hrFrom wellness guide
Exercise tipsP01hrFrom wellness guide
Swap exercise featureP13hrReplace during workout
Equipment filterP21hrFilter by equipment

Content Import (Wellness Guide)​

Import from ~/wellness-guide/:
├── 22-exercise-library.md    → exercises table
├── 23-phase1-foundation.md   → program_phases, program_days
├── 24-phase2-hypertrophy.md  → program_phases, program_days
├── 25-phase3-strength.md     → program_phases, program_days
├── 26-phase4-peak.md         → program_phases, program_days
└── 27-phase5-outdoor.md      → program_phases, program_days

API Endpoints​

EndpointMethodDescription
/api/v1/exercisesGETList exercises (paginated, filterable)
/api/v1/exercises/searchGETSearch exercises
/api/v1/exercises/:slugGETExercise details
/api/v1/exercises/by-muscle/:muscleGETFilter by muscle
/api/v1/programsGETList programs
/api/v1/programs/:slugGETProgram details
/api/v1/programs/currentGETUser's current program
/api/v1/programs/currentPATCHUpdate progress

Screens Built​

  • MoGuide (Exercise Library)
  • Exercise Detail
  • MoPhase (Program Tracker)

Checklist​

□ Exercise library displays
□ Search working
□ Muscle filter working
□ Exercise detail page
□ Instructions display
□ Demo GIF/video shows
□ Tips display
□ User history shows
□ Program overview page
□ All phases listed
□ Current phase highlighted
□ Week progress accurate
□ Wellness guide content imported
□ 50+ exercises with full data
□ Swap exercise works

Deliverable​

Users can:

  1. Browse all exercises
  2. Search and filter exercises
  3. View detailed exercise info
  4. See their history with each exercise
  5. View program overview
  6. Track phase/week progress
  7. Swap exercises during workout

9. Sprint 6: Polish + PWA​

Duration: 5-7 days Goal: Beautiful animations, offline support, installable app

Tasks​

TaskPriorityTimeDetails
Page transitionsP03hrFramer Motion setup
Card animationsP02hrEntrance, hover states
Button animationsP01hrPress, loading states
Number animationsP02hrCounting, changes
PR celebration polishP02hrConfetti, coach reaction
Skeleton loadersP03hrAll loading states
PWA manifestP01hrApp manifest file
Service workerP03hrWorkbox setup
Offline detectionP02hrOnline/offline status
Offline workout queueP14hrIndexedDB storage
Background syncP13hrSync when back online
Cache strategiesP12hrStatic vs dynamic
Haptic feedbackP12hrVibration API
Pull to refreshP11hrMobile gesture
3D coach avatarP26hrBasic Three.js setup
Sound effectsP22hrOptional audio

PWA Configuration​

// manifest.json
{
  "name": "Mo - Build Momentum",
  "short_name": "Mo",
  "description": "AI fitness coaching that matches your personality",
  "start_url": "/dashboard",
  "display": "standalone",
  "background_color": "#0a0a0f",
  "theme_color": "#00d4aa",
  "orientation": "portrait",
  "icons": [
    { "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
    { "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" },
    { "src": "/icons/icon-maskable.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
  ]
}

Offline Storage (Dexie.js)​

// Offline database schema
const db = new Dexie('MoOffline');
db.version(1).stores({
  pendingSets: '++id, date, workoutId, exerciseId, synced',
  pendingWeights: '++id, date, weight, synced',
  cachedWorkout: 'date',
  cachedExercises: 'id, slug'
});

Checklist​

□ Page transitions smooth
□ Cards animate on entrance
□ Buttons have press feedback
□ Numbers animate on change
□ PR celebration polished
□ All screens have skeletons
□ PWA manifest configured
□ Service worker registered
□ App installable on mobile
□ Offline indicator shows
□ Workouts save offline
□ Sets queue when offline
□ Syncs when back online
□ Haptics on key actions
□ No jank (60fps)
□ Lighthouse PWA score > 90

Deliverable​

App that:

  1. Feels native with smooth animations
  2. Can be installed to home screen
  3. Works offline at the gym
  4. Syncs data when back online
  5. Provides haptic feedback
  6. Loads fast with proper caching

10. Sprint 7: Payments + Launch​

Duration: 5-7 days Goal: Monetization ready, final testing, production launch

Tasks​

TaskPriorityTimeDetails
Stripe account setupP01hrConnect account
Stripe productsP01hrCreate Pro subscription
Checkout integrationP03hrStripe Checkout
Webhook handlerP03hrHandle subscription events
Subscriptions tableP01hrTrack user subscriptions
Billing portalP02hrManage subscription
Free vs Pro gatesP03hrFeature restrictions
Upgrade promptsP02hrUI for upgrade
Settings completionP03hrAll settings working
Profile editingP02hrUpdate user info
Account deletionP02hrGDPR compliance
Data exportP12hrExport user data
Error boundariesP02hrGraceful error handling
E2E testsP04hrCritical path testing
Performance auditP12hrLighthouse optimization
Security reviewP12hrAuth, data access audit
Analytics setupP02hrVercel Analytics
Error monitoringP01hrSentry setup
Domain setupP01hrCustom domain
Launch checklistP02hrFinal verification

Database Tables​

-- Subscriptions
subscriptions (
  id, user_id, stripe_customer_id, stripe_subscription_id,
  plan, status, current_period_start, current_period_end,
  created_at
)

API Endpoints​

EndpointMethodDescription
/api/v1/subscriptions/currentGETGet subscription status
/api/v1/subscriptions/checkoutPOSTCreate checkout session
/api/v1/subscriptions/portalPOSTGet billing portal URL
/api/v1/subscriptions/cancelPOSTCancel subscription
/api/v1/webhooks/stripePOSTHandle Stripe webhooks
/api/v1/users/me/exportGETExport user data
/api/v1/users/meDELETEDelete account

Free vs Pro Features​

FeatureFreePro
Workouts per month12Unlimited
AI Coach messages20/monthUnlimited
Weight tracking✓✓
Progress chartsBasicAdvanced
Exercise library✓✓
Multiple coaches1Up to 8
Offline mode✓✓
Export data-✓
Priority support-✓

E2E Test Scenarios​

// Critical paths to test
const criticalPaths = [
  'visitor_can_view_landing_page',
  'visitor_can_sign_up_with_email',
  'visitor_can_sign_up_with_google',
  'new_user_completes_onboarding',
  'user_can_start_workout',
  'user_can_log_sets',
  'user_can_complete_workout',
  'user_can_log_weight',
  'user_can_chat_with_coach',
  'user_can_upgrade_to_pro',
  'user_can_cancel_subscription',
  'user_can_delete_account',
];

Launch Checklist​

□ All features working
□ Stripe payments tested
□ Webhooks configured
□ Free/Pro gates working
□ E2E tests passing
□ Performance optimized (Lighthouse > 90)
□ Security audit complete
□ Error monitoring active
□ Analytics tracking
□ Custom domain configured
□ SSL certificate valid
□ Privacy policy page
□ Terms of service page
□ Support email configured
□ Backup strategy in place
□ Monitoring alerts set up

Deliverable​

Production-ready app with:

  1. Working subscription payments
  2. Free and Pro tiers
  3. All features complete
  4. Comprehensive testing
  5. Monitoring and analytics
  6. Custom domain live

11. Build Order Diagram​

                    Sprint 0: Setup
                         │
                         ▼
                Sprint 1: Auth + Onboarding
                         │
           ┌─────────────┴─────────────┐
           ▼                           ▼
    Sprint 2: Workout            Sprint 3: Dashboard
           │                           │
           └─────────────┬─────────────┘
                         │
                         ▼
                  Sprint 4: AI Coach
                         │
                         ▼
              Sprint 5: Library + Programs
                         │
                         ▼
                Sprint 6: Polish + PWA
                         │
                         ▼
              Sprint 7: Payments + Launch
                         │
                         ▼
                    🚀 LAUNCH

12. Testing Strategy​

Test Types​

TypeToolCoverageWhen
UnitVitestUtilities, calculationsEvery PR
ComponentVitest + Testing LibraryUI componentsEvery PR
IntegrationVitestAPI routesEvery PR
E2EPlaywrightCritical flowsPre-merge to main
VisualPlaywright screenshotsUI regressionWeekly
PerformanceLighthouse CICore Web VitalsPre-deploy
ManualYouFull appEvery sprint

Test Coverage Targets​

AreaTarget
Utility functions90%
API routes80%
Components70%
E2E critical paths100%

CI Pipeline​

# .github/workflows/ci.yml
name: CI

on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v2
      - run: pnpm install
      - run: pnpm lint

  typecheck:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v2
      - run: pnpm install
      - run: pnpm typecheck

  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v2
      - run: pnpm install
      - run: pnpm test

  e2e:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v2
      - run: pnpm install
      - run: pnpm exec playwright install
      - run: pnpm test:e2e

13. Definition of Done​

Every feature is complete when:

Functionality​

  • Works on mobile (375px width)
  • Works on tablet (768px width)
  • Works on desktop (1280px width)
  • Handles loading state
  • Handles error state
  • Handles empty state (if applicable)
  • Handles offline state (if applicable)

Quality​

  • No TypeScript errors
  • No ESLint errors
  • No console errors
  • Unit tests passing
  • Manually tested

Accessibility​

  • Keyboard navigable
  • Screen reader compatible
  • Touch targets ≥ 44px
  • Color contrast passes

Performance​

  • No layout shift
  • Images optimized
  • Lazy loaded where appropriate

14. Risk Mitigation​

RiskImpactProbabilityMitigation
AI costs too highHighMediumRate limits, prompt optimization, caching
Offline sync conflictsMediumMediumLast-write-wins, add conflict UI later
3D performance issuesLowMediumProgressive enhancement, 2D fallback
Scope creepHighHighStrict MVP focus, parking lot document
Auth edge casesMediumLowUse Clerk (battle-tested)
Database performanceMediumLowProper indexes, query optimization
BurnoutHighMediumSustainable pace, celebrate milestones

15. Milestones​

MilestoneSprintDate TargetCelebration
M1: Skeleton0Day 4First deploy!
M2: Accounts1Week 1First user signup
M3: Logging2Week 2-3First real workout logged
M4: Tracking3Week 3-4Full tracking working
M5: Coaching4Week 4-5First AI conversation
M6: Complete5Week 5-6Feature complete
M7: Polished6Week 6-7Beautiful + offline
M8: Launch7Week 7-8🚀 GO LIVE

16. Post-Launch Roadmap​

V1.1 (Month 2-3)​

  • PR Records page (MoPRs)
  • Meal tracking (MoFuel) - basic
  • Progress photos (MoBody)
  • Body measurements
  • Push notifications
  • Facebook OAuth

V1.2 (Month 3-4)​

  • Flutter mobile app (iOS)
  • Flutter mobile app (Android)
  • Advanced analytics
  • Workout sharing

Future​

  • Apple Watch integration
  • Social features (MoSquad)
  • Challenges (MoChallenge)
  • Custom workout builder
  • Educational content (MoLearn)

Document Status​

  • Development Approach
  • Sprint Overview
  • Sprint 0: Setup
  • Sprint 1: Auth + Onboarding
  • Sprint 2: Workout Core
  • Sprint 3: Dashboard + Progress
  • Sprint 4: AI Coach
  • Sprint 5: Exercise Library + Programs
  • Sprint 6: Polish + PWA
  • Sprint 7: Payments + Launch
  • Build Order Diagram
  • Testing Strategy
  • Definition of Done
  • Risk Mitigation
  • Milestones
  • Post-Launch Roadmap

Phase 5: Development Plan - COMPLETE

Document created: December 2024 Version: 1.0 Status: Complete