PTTrak is an early-stage fitness tracking application for personal trainers and their clients. It includes trainer and client dashboards, workout creation and assignment, progress tracking, authentication, and a Supabase-backed data model.
- React 18, TypeScript, and Vite
- Tailwind CSS and Radix UI components
- Supabase authentication, database, and Edge Functions
- Capacitor support for iOS and Android shells
- Node.js 20 or later
- npm
- A Supabase project for authentication and persistence
- Supabase CLI if you want to apply migrations, deploy the Edge Function, or regenerate database types
git clone https://github.com/startupsandcode/pttrak.git
cd pttrak
npm ci
cp .env.example .env
npm run devSet VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY in .env. The committed migrations in supabase/migrations/ define the expected schema. Review them and your Row Level Security policies before connecting the application to sensitive client data.
The invitation Edge Function uses the server-only SUPABASE_URL, SUPABASE_SERVICE_KEY, and APP_URL settings documented in .env.example. Never expose a service-role key in browser code. Apply all committed migrations, including the Row Level Security migration, before serving user data.
| Command | Purpose |
|---|---|
npm run dev |
Start the Vite development server |
npm run lint |
Run ESLint |
npm run build |
Type-check and build the production bundle |
npm run preview |
Preview the production bundle locally |
npm run types:supabase |
Regenerate Supabase TypeScript types using SUPABASE_PROJECT_ID |
After configuring the web application:
npm run build
npx cap sync
npx cap open ios # macOS and Xcode required
npx cap open android # Android Studio requiredThe native projects are generated locally and intentionally ignored by Git.
PTTrak is under active development and is not presented as production-ready healthcare software. Exercise, progress-photo, and client data can be sensitive; deployments are responsible for access controls, retention, backups, and applicable privacy requirements.
MIT © 2026 Startups and Code. See LICENSE.