SparkyFitness

SparkyFitness: Built for Families. Powered by AI. Track food, fitness, water, and health — together.

What is SparkyFitness?

SparkyFitness: Built for Families. Powered by AI. Track food, fitness, water, and health — together.

Overview of SparkyFitness

What it is

SparkyFitness is a self-hosted, privacy-first alternative to apps like MyFitnessPal, Flo, Hevy, and Shotsy. It is a fitness tracking platform that includes a backend server, a web-based frontend, native mobile apps for iOS and Android, and companion apps for Apple Watch and Wear OS. The platform stores and manages health data on infrastructure you control, without relying on third-party services.

Key features

  • Nutrition, exercise, hydration, sleep, fasting, mood, and body measurement tracking
  • Goal setting and daily check-ins
  • Apple Watch and Wear OS apps with goals, water, weight, fasting, medications, workouts, and watch face complications
  • Interactive charts and long-term reports
  • Multiple user profiles and family access with granular permissions
  • Light and dark themes; supports OIDC, TOTP, Passkey, MFA, etc.

Use cases

SparkyFitness is designed for individuals and families who want to track multiple aspects of health and fitness—such as nutrition, exercise, sleep, and hydration—in one place while keeping full control of their data. It is suitable for self-hosted setups where privacy is a priority, and it can replace several separate subscription services.

Getting started

bash# 1. Create a new foldermkdir sparkyfitness && cd sparkyfitness# 2. Download docker-compose.ymlcurl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml# 3. Set up your .env configuration (Choose one option):# Option A (Recommended): Generate custom .env with 1-click secure keys in browser:# 👉 https://codewithcj.github.io/SparkyFitness/install/env-generator# Option B: Minimal template — 5 values, everything else uses the defaults# docker-compose already applies. Fine for most self-hosted installs.curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.simple.example# Option C: Full reference — every supported variable, commented out with its# default. Start here for SSO, SMTP, an external database or a reverse proxy.# curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.example# 4. Replace the placeholders (skip if you used Option A — the generator# already filled these in). The server refuses to start while they are left# as-is, and the database would otherwise initialize with a published password.# SPARKY_FITNESS_DB_PASSWORD any strong password# SPARKY_FITNESS_API_ENCRYPTION_KEY openssl rand -hex 32 (64 hex chars)# BETTER_AUTH_SECRET openssl rand -base64 32 (44 chars)# SPARKY_FITNESS_FRONTEND_URL the URL you will open the app at# 5. Start the appdocker compose pull && docker compose up -d# Access application at http://localhost:3004

License and pricing

The license is not stated in the metadata (NOASSERTION). The README notes that SparkyFitness is source-available, not open source, and the license is non-commercial, requiring permission for commercial use. The pricing type is listed as open_source in the metadata, but the README clarifies it is not open source. No specific pricing is provided; the project is described as free for the whole household.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/codewithcjsparkyfitness.svg)](https://yunodb.com/tools/codewithcjsparkyfitness?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/codewithcjsparkyfitness?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/codewithcjsparkyfitness.svg" alt="Featured on YunoDB" height="20"></a>