A privacy-focused Progressive Web App for tracking physical therapy exercises and maintaining consistent rehabilitation routines. All data stays on your device—no server, no tracking, no accounts.
This app is intended as an additional aid beyond those provided by medical professionals. The audience is primarily people with recurring or chronic physical issues that require long-term physical therapy regimen, continued at home beyond when they are under the direct care of a therapist.
 |
 |
 |
 |
 |
 |
- Custom Exercise Library: Create duration-based or rep/set-based exercises with instructions
- Session Builder: Group exercises into reusable workout routines
- Flexible Organization: Search, sort, and reorder exercises and sessions
- Real-Time Timers: Countdown timers for duration exercises, rep counters for strength exercises
- Audio & Haptic Cues: Distinct tones and vibrations for exercise transitions, rep timing, and rest periods
- Auto-Rest Between Sets: Configurable automatic rest timers between sets
- Screen Wake Lock: Screen stays on during active sessions
- Full Playback Controls: Pause, resume, skip, go back, save progress, or finish session
- Session Journal: Complete history of all completed sessions
- Statistics Dashboard: Total sessions, weekly, and monthly counts
- Activity Calendar: Visual calendar showing completion patterns
- Session Details: Review exercise-by-exercise performance
- Timing Preferences: Configure countdown delays, rest periods, and auto-rest behavior
- Audio Settings: Master volume, countdown tones, and preview sounds
- Theme Options: Light, dark, or auto (follows system preference)
- Data Management: Export/import for backups and device transfers
- Local-First: All data stored on device using IndexedDB
- Fully Offline: Works completely offline after installation
- No Tracking: No accounts, no servers, no data collection
- Data Portability: Export/import your complete database for backups, or export/import exercises via CSV
-
Clone and install
git clone https://github.com/NateEaton/my-pt-pwa.git cd my-pt-pwa npm install -
Start development server
npm run dev
-
Open in browser
http://localhost:5173
# Production build
npm run build
# Preview build locally
npm run previewThe app generates a static site in build/ directory. Deploy to any static hosting:
GitHub Pages:
./deploy.shNetlify / Vercel:
- Build command:
npm run build - Publish directory:
build
Firebase Hosting:
npm run build
firebase deployOnce deployed via HTTPS, browsers will prompt to install as a standalone app.
my-pt-pwa/
├── src/
│ ├── routes/ # SvelteKit pages (today, journal, play, settings)
│ ├── lib/
│ │ ├── components/ # Reusable UI components
│ │ ├── stores/ # Svelte stores (state management)
│ │ ├── services/ # Business logic (PTService, AudioService)
│ │ ├── types/ # TypeScript type definitions
│ │ └── utils/ # Helper functions
│ ├── app.html # HTML template
│ └── app.css # Global styles
├── static/ # Static assets (icons, fonts, manifest)
└── build/ # Production build output
- UI Components → User interactions
- Svelte Stores → Reactive state management
- PTService → Business logic and CRUD operations
- IndexedDB → Persistent local storage
- Service Worker → Offline support and PWA features
- Local-First Architecture: All data operations use client-side IndexedDB
- Reactive State Management: Svelte stores for reactive data flow
- Component-Based UI: Reusable components with clear separation of concerns
- Progressive Enhancement: Works in browser, enhanced when installed as PWA
- SvelteKit (v2.5) - Full-stack framework with SSG
- Svelte (v4.2) - Reactive UI framework
- TypeScript (v5.0) - Type-safe development
- IndexedDB - Client-side persistent storage
- Custom Service Layer - Type-safe CRUD operations
- Vite (v5.2) - Build tool and dev server
- @sveltejs/adapter-static - Static site generation
- @vite-pwa/sveltekit - PWA integration with Workbox
- Service Worker - Offline support and automatic updates
- Web App Manifest - Installable with custom icons
- Wake Lock API - Screen stays on during sessions
- Vibration API - Haptic feedback for exercise cues
- Material Icons - Consistent iconography
- CSS Custom Properties - Themeable design system
- Mobile-First Design - Optimized for touch interfaces
- No Server Communication: All data stays on your device
- No Tracking: No cookies, analytics, or third-party services
- No Accounts: No sign-up or login required
- Full Control: All data remains on your device
- Export Anytime: Download complete database as JSON
- Import Capability: Restore from backup files
- Data Portability: Move data between devices
- Regular Backups: Export your data regularly via Settings → Data Management
- Secure Storage: Store backup files securely
- HTTPS Only: Access via HTTPS (enforced in production)
- Private Browsing: Note that data will be cleared when private session ends
- Node.js >= 18.0.0
- npm >= 9.0.0
- Fork and clone the repository
- Install dependencies:
npm install - Start dev server:
npm run dev - Make changes and test locally
- Type checking:
npm run check - Build test:
npm run build
| Command | Description |
|---|---|
npm run dev |
Start development server with hot reload |
npm run build |
Build for production |
npm run preview |
Preview production build locally |
npm run check |
Run TypeScript and Svelte type checking |
npm run check:watch |
Type checking in watch mode |
While this is primarily a personal project, suggestions and feedback are welcome. Please open an issue for bugs or feature ideas.
The repository uses the following branch structure:
main: Contains the latest version of the app with all new features and fixes that have been merged via pull request. This is the primary development branch.stable: Production-ready release branch that is updated periodically frommainwhen recent updates have been well-tested and proven stable. The demo version of the app is built from this branch.- Other branches: Active feature development branches or historical snapshots. These are typically prefixed with
claude/for AI-assisted development or represent specific feature work.
When using the app, it's recommended to deploy from the stable branch for production use, or from main if you want the latest features and are comfortable with more frequent updates.
- SvelteKit - Full-stack framework for building this PWA
- TypeScript - Type-safe development
- Vite - Fast build tool and dev server
- Material Icons - Icon library
This project was developed with assistance from AI tools including Claude, AI Studio (Google) and ChatGPT (OpenAI) following best practices in modern web development. The underlying concept, architecture decisions, implementation and testing were performed by the developer.
Created to support individuals undergoing physical therapy who need a simple, reliable way to track their home exercise programs without sacrificing privacy or requiring internet connectivity.
This project is licensed under the GNU General Public License v3.0 or later.
See LICENSE for the full license text.
Made with care for better rehabilitation outcomes