PlanFit

A planning-first workout scheduler. Build a workout library, tag calendar days with workout types, and let a simple rules engine keep your training balanced.

Status: personal hobby project, single-developer. Resuming active development after a planning pause.

Quick start

PlanFit is a single-file HTML app — no install, no build, no server.

open PlanFit-0.85.html        # macOS
# or just double-click the file in any OS

The latest version is whichever PlanFit-X.Y.html has the highest version number. Older files are kept as immutable history.

Your data lives in your browser's localStorage. To back it up or move it to another browser, use File → Save Your Data to export an XML file, and File → Load Data to restore.

What it does

• Workout library — define workouts (with type, duration, program tag) and activities (one-off events).
• Calendar tagging — drag a workout-type "Plan" pill (Upper Body, Cardio, etc.) onto a day to tag the intent, then drag a workout from the library onto the day to fulfill it.
• Rules engine — per-type Min Rest (days between same-type workouts) and Max Gap (days before a type becomes overdue). Violations show as warning dots.
• Auto-Fill — greedy day-tagging for the current month based on rule urgency.
• Recurring — schedule a workout for a recurring day of the week.
• Log — mark workouts complete, add notes and a session link.
• Sample mode — explore with bundled sample data without touching your own library.
• Dark/light theme, desktop drag-drop and a mobile tap-to-place flow.

Tech notes

• Single-file HTML: inline <style>, DOM, and <script>. Only runtime dependency is Google Fonts.
• Vanilla JS — no framework, no build step.
• State persisted to localStorage under planfit_data_v1 (older planfit_v3 payloads are read once and migrated). XML import/export is the durable user-data format.
• See CLAUDE.md for architecture notes (state shape, sample-mode caveats, rendering model, mobile layer).

Project layout

PlanFit-0.85.html              ← latest / canonical version
PlanFit-0.8.html               ← prior releases (frozen history)
…
FitKit-0.2.html                ← earlier prototype line (archived)
docs/
  Workout Options - Workouts.pdf  ← reference: workout type catalogue
samples/
  planfit-your-data.xml        ← sample XML export (data format reference)
  planfit-your-data-2.xml      ← alternate sample with additional workouts
CLAUDE.md                      ← architecture notes for AI-assisted dev
ROADMAP.md                     ← what's planned and why
AUDIT.md                       ← code health findings driving the next refactor passes

Roadmap

See ROADMAP.md.

License

MIT