explaingit

jherr/tanmaxx-17

20TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A workout tracker demo app built to showcase all 17 TanStack libraries at once, with AI-generated training programs, offline SQLite storage, a 5,000-exercise catalog, and keyboard shortcuts for logging sets without touching the mouse.

Mindmap

mindmap
  root((TanMaxx-17))
    What it does
      Log workout sets
      AI training programs
      Exercise catalog
    TanStack showcase
      Routing and forms
      Tables and hotkeys
      AI integration
    AI features
      Program generation
      Streaming chat
      Agent skill package
    Tech
      TypeScript SQLite
      Node 24 pnpm
      Anthropic API
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Study how all 17 TanStack packages work together in one real TypeScript app before using them in your own project

USE CASE 2

Use the workout tracker to log lifting sets with natural-language input and receive AI-generated training programs

USE CASE 3

Expose the tracker as a discoverable skill so AI coding agents like Cursor or Claude can call its server functions directly

USE CASE 4

Explore a monorepo structure where a shared package bridges a web app and AI agent tooling

Tech stack

TypeScriptTanStackSQLiteNode.jspnpm

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Node 24 and pnpm, an Anthropic API key is needed for all AI features including program generation and the chat interface.

License terms are not mentioned in the explanation.

In plain English

TanMaxx is a single-user workout tracker built to show off every library in the TanStack ecosystem at once. There are 17 TanStack packages in use here, from routing and data fetching to forms, tables, hotkeys, and AI integration. The project was created specifically as a demo app for a video tour of what TanStack can do, so the goal is breadth over practicality. The core idea is simple: log your lifting sets, track your workout history, and let an AI generate training programs for you. You can type a set entry in plain English and the app parses it automatically. The program generator runs as a four-step background workflow, and there is a streaming chat interface where you can ask questions about your sessions or request a new program. The app's most distinctive feature is something called The Maxx, a two-handle slider that goes from Deload all the way up through Volume, Strength, Peaking, and eventually into modes labeled GIGAMAXX and INJURY ZONE. The slider does two things at once: it tells the AI how intensely to program your training, and it changes the entire visual look of the app as you crank it higher. The style gets progressively more dramatic at higher settings. On the practical side, the tracker works offline and saves data locally using SQLite. There is a catalog of 5,238 exercises you can browse, a history view, and keyboard shortcuts for logging sets without touching the mouse. The hotkey system covers everything from adjusting weight and reps to jumping between screens with short key chords. The project is structured as a monorepo with a web app and a shared package that exposes the tracker as a discoverable skill for AI coding agents. That package lets tools like Cursor or Claude pick up the available server functions and call them directly. To run it yourself you need Node 24 and pnpm, plus an Anthropic API key for the AI features.

Copy-paste prompts

Prompt 1
I cloned tanmaxx-17 and want to understand how TanStack Router and TanStack Query work together. Walk me through how a log-set action flows from button click through the router to the SQLite database.
Prompt 2
Show me how tanmaxx-17 exposes workout tracker functions as discoverable skills for AI coding agents so I can copy the same pattern for my own app.
Prompt 3
I want to add a new exercise to the 5,238-exercise catalog in tanmaxx-17. What file or database table do I edit and how does the search feature pick it up?
Prompt 4
Explain how tanmaxx-17's four-step AI program generator works, which TanStack packages are involved and how the streaming chat interface updates the UI in real time.
Open on GitHub → Explain another repo

← jherr on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.