RepTrack — Exercise Tracker

Mobile-first PWA for logging gym workouts: exercises, sets, reps, and weight.

What it does

• Log sets, reps, and weight for any exercise
• Custom exercise creation with optional photo (camera capture → Vercel Blob)
• Search and filter exercises by muscle group
• Favorite exercises for quick access
• Workout history view with past sessions
• Installable as PWA on iOS and Android

How it works

sequenceDiagram
    participant U as User (browser/PWA)
    participant N as Next.js App Router
    participant SA as Server Action
    participant DB as Supabase (PostgreSQL)
    participant B as Vercel Blob

    U->>N: Open app (SSR page)
    N->>DB: Fetch exercises + recent logs
    DB-->>N: Data
    N-->>U: Rendered UI

    U->>N: Log a set (exercise + weight + reps)
    N->>SA: createWorkoutLog / addRep
    SA->>DB: INSERT workout_logs / reps
    DB-->>SA: OK
    SA->>N: revalidatePath('/')
    N-->>U: Updated UI

    U->>N: Add custom exercise (with photo)
    N->>B: POST /api/upload → store image
    B-->>N: Blob URL
    N->>SA: createExercise(name, muscle_group, image_url)
    SA->>DB: INSERT exercises
    DB-->>SA: OK

Loading

Tech stack

Layer	Choice
Framework	Next.js 16 (App Router)
UI	React 19 + shadcn/ui + Tailwind CSS v4
Database	Supabase (PostgreSQL)
File storage	Vercel Blob
Deployment	Vercel

Requirements

• Node.js 20+
• pnpm
• A Supabase project
• A Vercel Blob store

Quick start

git clone https://github.com/arunkk/exercise-tracker-app.git
cd exercise-tracker-app
pnpm install

Create .env.local:

NEXT_PUBLIC_SUPABASE_URL=https://xxxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...
BLOB_READ_WRITE_TOKEN=vercel_blob_rw_...

Run the dev server:

pnpm dev

Open http://localhost:3000.

See CONTRIBUTING.md for the full database schema setup.

Configuration

Variable	Required	Description
NEXT_PUBLIC_SUPABASE_URL	Yes	Supabase project URL
NEXT_PUBLIC_SUPABASE_ANON_KEY	Yes	Supabase anon/public key
BLOB_READ_WRITE_TOKEN	Yes	Vercel Blob read-write token

Repo layout

app/                  # Next.js App Router
  api/                # API routes (upload, file serving)
  layout.tsx          # Root layout + PWA metadata
  page.tsx            # Entry page
components/           # React components
  ui/                 # shadcn/ui primitives
lib/
  actions.ts          # Server actions — all DB writes
  types.ts            # Shared TypeScript types
  supabase/           # Supabase client helpers (SSR + browser)
  favorites.ts        # localStorage favorites helper
  image-utils.ts      # Image processing utilities
public/               # Static assets

Contributing

See CONTRIBUTING.md.

License

Apache 2.0 — see LICENSE.