SparkyFitness: Built for Families. Powered by AI. Track food, fitness, water, and health — together. https://codewithcj.github.io/SparkyFitness/
  • TypeScript 95.7%
  • PLpgSQL 2.5%
  • JavaScript 0.5%
  • Python 0.5%
  • Go Template 0.3%
  • Other 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
CodeWithCJ b8ac169001
Merge pull request #2280 from CodeWithCJ/ci/schema-backup-sync
chore: sync db_schema_backup.sql with migrations
2026-08-27 21:56:09 -04:00
.agents/skills docs(skills): handle detached HEAD state in pr-submission workflow 2026-08-23 13:51:02 -04:00
.claude/skills fix(db): clarify extension retention notices, retain helm initdb compatibility, and update pr-submission skill 2026-08-23 13:45:56 -04:00
.gemini agent improvements 2026-07-08 16:33:56 -04:00
.github ci: add workflow_dispatch trigger to pr validation workflow 2026-08-27 21:41:26 -04:00
.husky adjusted percent Slider to adjust to the Numbers 2026-05-26 13:05:15 +02:00
agent-docs docs: refine PR review workflow, add anti-patterns, update other docs and agent skill 2026-08-21 15:54:10 -04:00
docker Merge pull request #2254 from garakangas/secret-files 2026-08-25 16:26:13 -04:00
docs feat(reports): add bmr and smart scale metrics to measurement reports and address review feedback 2026-08-27 20:21:18 -04:00
helm fix(db): clarify extension retention notices, retain helm initdb compatibility, and update pr-submission skill 2026-08-23 13:45:56 -04:00
nix chore(nix): update pnpm deps hashes (#2240) 2026-08-24 23:59:01 +00:00
patches (feat) Mobile exercise & workout advanced details sync such as Cal, GPS, HR etc 2026-08-04 21:28:20 -04:00
scripts reset local branches 2026-08-25 16:55:37 -04:00
shared feat(measurements): add BMR support to check-in measurements 2026-08-27 19:35:37 -04:00
SparkyFitnessFrontend fix(bmr): streamline bmr calculation, safe-guard migration backfill, and address review feedback 2026-08-27 20:58:17 -04:00
SparkyFitnessGarmin fix(garmin): optimize historical sync concurrency, incremental persistence, and strength exercise mapping 2026-08-23 11:41:17 -04:00
SparkyFitnessMobile fix(bmr): streamline bmr calculation, safe-guard migration backfill, and address review feedback 2026-08-27 20:58:17 -04:00
SparkyFitnessServer fix(bmr): streamline bmr calculation, safe-guard migration backfill, and address review feedback 2026-08-27 20:58:17 -04:00
.dockerignore Show empty input when serving size is cleared 2026-06-02 21:46:09 +02:00
.gitignore refactor(db): consolidate health telemetry into health_metric_samples & fix weight unit conversions (#1990) 2026-08-03 13:12:56 -04:00
AGENTS.md docs(mobile): document localization conventions 2026-08-22 01:31:48 +02:00
announcement.md Revise announcement for SparkyFitness contributions 2026-08-16 17:14:56 -04:00
CLAUDE.md Add Jest testing infrastructure to enable test execution 2026-01-25 11:15:26 +00:00
CONTRIBUTING.md bot feedback 2026-08-23 12:18:58 -04:00
DB Backup.cmd Fix for Steps showing from previous days instead of current day 2025-10-23 10:44:20 -04:00
db_backup.sh feature: Added Global Food & Exercise data provider. 2026-06-20 18:05:48 -04:00
db_schema_backup.sql chore: sync db_schema_backup.sql with migrations 2026-08-28 01:55:27 +00:00
dev-start.bat dev docker files 2026-02-02 21:34:08 -05:00
flake.lock NixOS module 2026-06-22 01:56:30 +00:00
flake.nix feat: add garmin connect nix module options 2026-07-31 20:55:35 -04:00
LICENSE WIP Meal & Meal Plan Features 2025-07-12 13:41:35 -04:00
package.json reset local branches 2026-08-25 16:55:37 -04:00
pnpm-lock.yaml fix(server): resolve SMTP STARTTLS configuration on port 587 2026-08-24 16:21:47 -04:00
pnpm-workspace.yaml chore: live activity 2026-07-13 02:00:31 -05:00
README.md Update star history section in README.md 2026-08-18 18:23:49 -04:00
start_garmin_microservice.bat Updated withing to save json as mockup files. renamed few other variables used by developers 2026-02-09 18:32:39 -05:00
start_garmin_microservice.sh refactor(db): consolidate health telemetry into health_metric_samples & fix weight unit conversions (#1990) 2026-08-03 13:12:56 -04:00

SparkyFitness

A self-hosted, privacy-first alternative to MyFitnessPal. Track nutrition, exercise, body metrics, and health data while keeping full control of your data. image

SparkyFitness is a self-hosted fitness tracking platform made up of:

  • A backend server (API + data storage)
  • A web-based frontend
  • Native mobile apps for iOS and Android

It stores and manages health data on infrastructure you control, without relying on third party services.

Core Features

  • Nutrition, exercise, hydration, sleep, fasting, mood and body measurement tracking
  • Goal setting and daily check-ins
  • Interactive charts and long-term reports
  • Multiple user profiles and family access
  • Light and dark themes
  • OIDC, TOTP, Passkey, MFA etc.

How SparkyFitness Compares

SparkyFitness is source-available, not open source — the licence is non-commercial and requires permission for commercial use.

Most apps do one thing. One good nutrition app runs $40$100 a year; covering everything SparkyFitness covers means three or four subscriptions, per person, and still no single report across them. SparkyFitness does it in one app, free, for the whole household.

US list prices, 14 Aug 2026. Full cost breakdown →

SparkyFitness wger MyFitnessPal Cronometer Hevy Zero Flo Garmin Connect Google Health
Self-hosted, your data stays yours
No subscription, no ads 🟡 🟡 🟡
Nutrition, strength, sleep, fasting, cycle & meds in one place* 🟡 🟡 🟡 🟡 🟡
Full history & custom date-range reports free 🟡 💰 💰 💰 💰 💰 💰
Wearable & health-platform sync 8+ services 🟡 🟡 🟡
Family sharing with granular permissions 7 permissions 🟡 🟡 🟡
CSV import & free data export 🟡 💰 🟡 🟡 🟡
MCP server + bring your own LLM 🟡

standout  •  supported  •  🟡 partial  •  💰 paid tier only  •  not supported

* Sleep stages, HRV and blood glucose are imported from your watch, phone or meter. SparkyFitness stores, analyses and charts them rather than measuring them itself.

This table is written by the project being compared, so read it that way. Checked 14 Aug 2026 against official docs, repos and store listings; some of it is already out of date. If a cell is wrong or unfair to another project, open an issue — corrections that make SparkyFitness look worse are just as welcome.

See the full comparison → — 17 apps across self-hosted, nutrition, specialist and device-ecosystem categories, plus where each of them beats us.

Health & Device Integrations

SparkyFitness can sync data from multiple health and fitness platforms:

  • Apple Health (iOS)
  • Google Health Connect (Android)
  • Google Health API
  • Fitbit
  • Garmin Connect
  • Withings
  • Polar Flow
  • Oura
  • Hevy
  • OpenFoodFacts
  • USDA
  • Fatsecret
  • Nutritionix
  • Mealie
  • Tandoor
  • Strava (partially tested)
  • Norish
  • Yazio (uses unofficial API)
  • Swiss Food Database
  • Free Exercise DB (Github)
  • Wger

Integrations automatically sync activity data such as steps, workouts, and sleep, along with health metrics like weight and body measurements, to your SparkyFitness server.

Optional AI Features (Beta)

SparkyAI provides a conversational interface for logging data and reviewing progress.

  • Log food, exercise, body stats, and steps via chat
  • Upload food images for automatic meal logging
  • Retains conversation history for follow ups

Note: AI features are currently in beta.

Installation

Choose one of the two ways to run SparkyFitness:

1. Self-Hosted

Get a SparkyFitness server running in minutes using Docker Compose:

# 1. Create a new folder
mkdir sparkyfitness && cd sparkyfitness

# 2. Download Docker files only
curl -L -o docker-compose.yml https://github.com/CodeWithCJ/SparkyFitness/releases/latest/download/docker-compose.prod.yml
curl -L -o .env https://github.com/CodeWithCJ/SparkyFitness/releases/latest/download/default.env.example

# 3. (Optional) Edit .env to customize database credentials, ports, etc.

# 4. Start the app
docker compose pull && docker compose up -d

# Access application at http://localhost:8080

Note: For other self-hosted installation methods, refer to the documentation at https://codewithcj.github.io/SparkyFitness/.

2. Cloud (for non-technical users)

If you are not a technical user and prefer not to run SparkyFitness on your own server, you can deploy a hosted instance in the cloud using one of the following providers.

Run on PikaPods
Deploy with Zenith

Note: These are independent third-party services. We encourage you to explore features provided by each provider to determine the one that best fits your needs.

🎥 Video Tutorial

Watch the video

Quick 2-minute tutorial showing how to install SparkyFitness (self-hosted fitness tracker).

Documentation

For full installation guides, configuration options, and development docs, please visit our Documentation Site.

Need Help?

  • Post in Github issues/discussion.
  • For faster response and get help from other community memebers Join our Discord

Star History

Star History Chart

Translations

Weblate Translations

Translation status

Repository activity

Alt

Contributors

⚠️ Known Issues / Beta Features ⚠️

SparkyFitness is under active development. Breaking changes may occur between releases.

  • Auto-updating containers is not recommended
  • Always review release notes before upgrading

The following features are currently in beta and may not have been thoroughly tested. Expect potential bugs or incomplete functionality:

  • AI Chatbot
  • Family & Friends access
  • API documentation