🌐 Language

  
    English
    简体中文
    繁體中文
    日本語
    한국어
    हिन्दी
    ไทย
    Français
    Deutsch
    Español
    Itapano
    Русский
    Português
    Nederlands
    Polski
    العربية
    فارسی
    Türkçe
    Tiếng Việt
    Bahasa Indonesia
  

SparkyFitness - Selfhosted alternative of MyFitnessPal

SparkyFitness is a comprehensive fitness tracking and management application designed to help users monitor their nutrition, exercise, and body measurements. It provides tools for daily progress tracking, goal setting, and insightful reports to support a healthy lifestyle.

Docs: https://codewithcj.github.io/SparkyFitness

✨ Features

🍎 Nutrition Tracking

• Log your daily meals
• Create and manage custom foods and categories
• View summaries and analyze trends with interactive charts

💪 Exercise Logging

• Record your workouts
• Browse and search a comprehensive exercise database
• Track fitness progress over time

💧 Water Intake Monitoring

• Track daily hydration goals
• Simple, quick water logging

📏 Body Measurements

• Record body metrics (e.g. weight, waist, arms)
• Add custom measurement types
• Visualize progress through charts

🎯 Goal Setting

• Set and manage fitness and nutrition goals
• Track progress over time

🗓️ Daily Check-Ins

• Monitor daily activity
• Stay consistent with habit tracking

🤖 AI Nutrition Coach (SparkyAI)

• Log food, exercise, body stats, and steps via chat
• Upload food images to log meals automatically
• Includes chat history and personalized guidance

🔒 User Authentication & Profiles

• Secure login system
• Switch between user profiles
• Support for family access and management

📊 Comprehensive Reports

• Generate summaries for nutrition and body metrics
• Track long-term trends over weeks or months

🎨 Customizable Themes

• Switch between light and dark mode
• Designed with a minimal, distraction-free interface

Need Help?

• Join discord https://discord.gg/vcnMT5cPEA
• Post in discussion

!image (https://github.com/user-attachments/assets/ccc7f34e-a663-405f-a4d4-a9888c3197bc)

� Quick Start

Get SparkyFitness running in minutes:

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

# 2. Download Docker files only
curl -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml
curl -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.example

# 3. (Optional) Edit .env to customize your setup
# e.g., update database credentials, ports, etc.
# if you require Gamrin integration, uncomment Garmin section from compose file.

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

# Access application at http://localhost:8080

📖 Documentation

For complete installation guides, development setup, and usage instructions, visit our comprehensive documentation:

👉 SparkyFitness Documentation Site (https://codewithcj.github.io/SparkyFitness)

Quick Links

• 🚀 Getting Started (https://codewithcj.github.io/SparkyFitness/developer/getting-started) - Complete setup guide for development and production
• 🐳 Docker Guide (https://codewithcj.github.io/SparkyFitness/developer/docker) - Docker deployment and configuration
• 🔧 Development Workflow (https://codewithcj.github.io/SparkyFitness/developer/workflow) - Developer guide and contribution process
• 📊 Features Overview (https://codewithcj.github.io/SparkyFitness/features/) - Complete feature documentation
• 🏗️ Architecture (https://codewithcj.github.io/SparkyFitness/app-overview) - Technical architecture and design
• Refer WIiki for sample env setup and Mobile App configuration.

Star History

Translations

Repository activity

!Alt (https://repobeats.axiom.co/api/embed/828203d3070ff56c8873c727b6873b684c4ed399.svg "Repobeats analytics image")

Contributors

⚠️ Known Issues / Beta Features ⚠️

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

• AI Chatbot
• Multi-user support
• Family & Friends access
• Apple Health Data integration

This application is under heavy development. Things may not work as expected due to the Supabase to PostgreSQL migration. BREAKING CHANGES might be introduced until the application is stable. You might need to change Docker/environment variables for new releases. Therefore, auto-upgrades using Watchtower or similar apps are not recommended. Read release notes for any BREAKING CHANGES.