# ๐๏ธ Calistenia
### Your AI calisthenics & fitness coach โ workouts, nutrition, and progress in one app.
Train with a structured calisthenics program, log every set, track your nutrition, run cardio with live GPS, and let an AI coach adapt the plan to you. Free, open source, and self-hostable.
**[๐ฑ Download the Android app](https://gym.guille.tech/download?utm_source=github&utm_medium=readme&utm_campaign=repo)** ยท **[๐ Try the web app](https://gym.guille.tech/?utm_source=github&utm_medium=readme&utm_campaign=repo)** ยท **[โญ Star this repo](https://github.com/guillermoscript/calistenia-app)**
---
## Why Calistenia?
Most fitness apps are paywalled, bloated, or cloud-locked. Calistenia is the opposite:
- **๐ค AI coach built in** โ get a personalized plan, ask questions, and let the app adjust your training and nutrition.
- **๐ One app for everything** โ strength, calisthenics skills, cardio with GPS, nutrition, and habits, instead of five separate apps.
- **๐ต Works offline** โ all your data writes fall back to local storage when you're off the grid. Nothing is lost.
- **๐ Free & open source (MIT)** โ no subscription, no ads. Self-host it on a cheap VPS and own your data.
- **๐ฒ Real native app + web PWA** โ install the Android APK or use it in any browser.
> **Get it now:** [gym.guille.tech/download](https://gym.guille.tech/download?utm_source=github&utm_medium=readme&utm_campaign=repo) (Android) or [gym.guille.tech](https://gym.guille.tech/?utm_source=github&utm_medium=readme&utm_campaign=repo) (web).
## Features
### ๐ช Training
- **15 structured programs** โ beginner to advanced, plus skill roadmaps (pull-up, handstand, muscle-up, planche), each split into progressive phases with daily workouts.
- **Session tracking** โ step through exercises one by one, log sets, reps, and notes.
- **Rest & isometric timers** โ auto-start rest countdowns and hold timers with audio + haptic cues.
- **Form videos inline** โ tap any exercise to watch a tutorial without leaving the app.
- **Circuits & HIIT** โ timed circuit/interval workouts with round tracking.
### ๐ฅ Nutrition
- **Food & macro logging** โ track calories and macros, snap photos, and hit daily targets.
- **AI nutrition scoring** โ quality feedback on what you eat, not just calorie counting.
### ๐ Cardio
- **Live GPS sessions** โ track route, distance, and pace on a map (MapLibre), with a foreground service so it keeps running in your pocket.
- **Races & challenges** โ set distance goals and compete.
### ๐ฎ Engagement
- **Gamification** โ streaks, badges, and achievements to keep you coming back.
- **Social** โ comments and reactions on sessions, with push notifications.
- **Reminders** โ local notifications so you never skip a workout.
- **Home-screen widgets** โ today's workout, weekly cardio km, and a calories ring, right on your Android home screen.
## Tech stack
A pnpm monorepo with shared business logic across native and web.
| Part | Stack |
|---|---|
| **Mobile** (`apps/mobile`) | React Native + Expo, expo-router, MapLibre, Notifee, Sentry, Android widgets |
| **Web** (`apps/web`) | React + Vite, Tailwind CSS, shadcn/ui, PWA |
| **Shared core** (`packages/core`) | Cross-platform hooks, data layer, i18n (EN/ES) |
| **AI / MCP** (`mcp-server`) | MCP server + AI API for the coach and smart tools |
| **Backend** | PocketBase (SQLite, self-hosted) โ 30+ collections, migration-driven |
| **Testing** | Playwright |
๐ ๏ธ For developers โ run it locally, build the Android APK, self-host it
### Repo layout
```
calistenia-app/
โโโ apps/
โ โโโ mobile/ # Expo React Native app (Android APK + iOS)
โ โโโ web/ # React + Vite PWA
โโโ packages/
โ โโโ core/ # Shared hooks, data, locales
โโโ mcp-server/ # AI coach + MCP tools
โโโ pb_migrations/ # PocketBase schema migrations
โโโ pocketbase # PocketBase binary
```
### Getting started
Requires **Node 20+** and **pnpm 10+**.
```bash
# 1. Install deps (whole monorepo)
pnpm install
# 2. Start PocketBase (backend + API)
pnpm pb:serve
# Admin UI: http://127.0.0.1:8090/_/ (create admin on first run)
# 3a. Run the web app
pnpm --filter @calistenia/web dev # http://localhost:5173
# 3b. Run the mobile app
cd apps/mobile && pnpm start # Expo dev server
```
Migrations in `pb_migrations/` apply automatically on PocketBase start.
#### Mobile build (Android APK)
A GitHub Action (`.github/workflows/build-mobile-apk.yml`) builds the release APK and publishes it as a GitHub Release. The web download page fetches the latest release automatically.
```bash
# Trigger a release: bump version in apps/mobile/app.json, then
git tag mobile-v1.0.1 && git push origin mobile-v1.0.1
```
### Deployment
The web app + PocketBase ship as a single Docker image (multi-stage build) and deploy via Dokploy + GitHub Actions on push to `main`. PocketBase serves both the API (`/_/`) and the static frontend from one port (`8090`). See `Dockerfile` and `docker-compose.yml`.
```bash
# Local smoke test
docker compose up --build # http://localhost:8090
```
## Contributing
Issues and PRs welcome. If Calistenia helps you train, a โญ on the repo goes a long way and helps others discover it.
## License
MIT โ see [`LICENSE.md`](./LICENSE.md). Use it, fork it, self-host it.