How to vibe codeHevy

Prerequisites

• Node.jsfree

  Required for running the React Native / Expo development toolchain.

• Expo Accountfree

  Required for building development builds and managing cross-platform mobile deployments.

• GitHubfree

  Source control and CI/CD integration.

AI coding tools

• Claude Code

  Best-in-class multi-file agentic coding tool for scaffolding React Native components, database schemas, and state management logic.

• Cursor

  Excellent AI code editor for fine-tuning UI layouts, custom chart components, and styling workouts screens.

Build guide

1. 01Project Scaffolding & Database Schema

   Initialize an Expo project with Expo Router and TypeScript. Define the local and remote SQLite database schemas for exercises, routines, routine_exercises, workouts, workout_sets, and sets metadata (weight, reps, type like warmup/drop/failure).

   Initialize a new Expo React Native app using TypeScript and Expo Router. Set up a robust folder structure with directories for components, screens, hooks, and services. Create an SQLite database initialization script using `expo-sqlite` that defines tables for `exercises` (id, name, muscle_group, category), `routines` (id, title, notes), `routine_exercises` (routine_id, exercise_id, order), `workouts` (id, start_time, end_time, notes), and `workout_sets` (id, workout_id, exercise_id, set_index, weight, reps, type). Ensure proper foreign keys and indexes are established for high-performance offline queries.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

2. 02Exercise Library & Custom Exercise Management

   Build the exercise library screen with category filters, muscle group tags, and the ability for users to create custom exercises stored locally and synced remotely.

   Build an Exercise Library screen in Expo Router that displays a searchable, filterable list of exercises grouped by primary muscle group (Chest, Back, Legs, Shoulders, Arms, Core). Include a modal form allowing users to create custom exercises with name, category, and muscle group fields. Save these entries to the local SQLite database with a sync-pending flag, and render clean badge components for muscle groups using React Native primitives.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

3. 03Routine Planner

   Implement the routine planning interface where users can group exercises into reusable workout templates with target sets and reps.

   Create a Routine Planner interface. Allow users to create, edit, and delete named workout routines (e.g., 'Push Day A'). Inside a routine editor view, users should be able to add multiple exercises from the library, reorder them via drag-and-drop or list controls, and pre-define target working sets. Persist routine configurations locally with relational mapping between routines and exercises.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

4. 04Active Workout Logging Screen

   Build the core active workout session tracker featuring set logging, previous performance reference, set type tags (Warmup, Drop, Failure), and live rest timers.

   Develop the active workout logging screen. When a user starts a routine, spawn an active workout session tracking elapsed time. For each exercise, render a table of sets where users input weight and reps. Display the user's previous performance for that exercise/set directly above current inputs for progressive overload reference. Add a picker or toggle on each set row for set types: Normal, Warmup, Drop Set, and Failure. Include a floating or sticky rest timer component that triggers automatically upon completing a set, featuring customizable duration presets and audio/vibration feedback.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

5. 05Progress Analytics & Charts

   Implement exercise history charts, personal records (PR) detection, and estimated 1-Rep Max calculations.

   Build an exercise progress analytics screen using a React Native charting library (such as Victory Native). For any selected exercise, query historical workout sets to compute and plot max weight lifted over time, total volume per session, and estimated One-Rep Max (1RM) using the Epley formula: `weight * (1 + reps / 30)`. Highlight personal records (PR) clearly on the chart and in exercise history lists.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

6. 06Backend Sync & Companion Web View

   Set up a lightweight backend API and web frontend companion view to view workout logs and routines on desktop screens.

   Create a companion web view using Next.js and Tailwind CSS that connects to a shared Turso database via better-auth. Build a clean dashboard displaying historical workout logs, exercise progress graphs, and routine management tools optimized for desktop viewports so users can plan workouts from their computers.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

Cost vs paying for Hevy