SparkyFitness - Samohostowana alternatywa dla MyFitnessPal

SparkyFitness to kompleksowa aplikacja do monitorowania i zarządzania kondycją fizyczną, zaprojektowana, aby pomóc użytkownikom śledzić odżywianie, ćwiczenia oraz pomiary ciała. Oferuje narzędzia do codziennego monitorowania postępów, wyznaczania celów i przejrzystych raportów wspierających zdrowy styl życia.

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

✨ Funkcje

🍎 Monitorowanie odżywiania

• Rejestruj swoje codzienne posiłki
• Twórz i zarządzaj własnymi produktami oraz kategoriami
• Przeglądaj podsumowania i analizuj trendy na interaktywnych wykresach

💪 Rejestrowanie ćwiczeń

• Zapisuj swoje treningi
• Przeglądaj i wyszukuj w obszernej bazie ćwiczeń
• Śledź postępy w sprawności fizycznej w czasie

💧 Monitorowanie spożycia wody

• Śledź codzienne cele nawodnienia
• Proste, szybkie rejestrowanie wypitej wody

📏 Pomiary ciała

• Rejestruj parametry ciała (np. waga, talia, ramiona)
• Dodawaj własne typy pomiarów
• Obserwuj postępy na wykresach

🎯 Ustalanie celów

• Ustalaj i zarządzaj celami fitness i żywieniowymi
• Śledź postępy w czasie

🗓️ Codzienne odprawy

• Monitoruj codzienną aktywność
• Pozostań konsekwentny dzięki śledzeniu nawyków

🤖 AI Trener Żywienia (SparkyAI)

• Rejestruj jedzenie, ćwiczenia, parametry ciała i kroki poprzez czat
• Przesyłaj zdjęcia jedzenia, aby automatycznie rejestrować posiłki
• Zawiera historię czatu i spersonalizowane wskazówki

🔒 Uwierzytelnianie użytkownika i profile

• Bezpieczny system logowania
• Przełączanie między profilami użytkowników
• Wsparcie dla dostępu rodzinnego i zarządzania

📊 Kompletne raporty

• Generowanie podsumowań dotyczących żywienia i parametrów ciała
• Śledzenie długoterminowych trendów przez tygodnie lub miesiące

🎨 Personalizowane motywy

• Przełączanie między trybem jasnym i ciemnym
• Zaprojketowany z minimalnym, bezrozpraszającym interfejsem

Potrzebujesz pomocy?

• Dołącz do Discorda

https://discord.gg/vcnMT5cPEA

• Zadaj pytanie na forum dyskusyjnym

� Szybki start

Uruchom SparkyFitness w kilka minut:

# Clone the repository
git clone https://github.com/CodeWithCJ/SparkyFitness.git
cd SparkyFitness
Copy environment template and edit as needed
cp docker/.env.example .env
Start development environment (with live reloading)
./docker/docker-helper.sh dev up
Access application at http://localhost:8080

📖 Dokumentacja

Aby uzyskać pełne przewodniki instalacyjne, instrukcje dotyczące konfiguracji środowiska deweloperskiego oraz zasady użytkowania, odwiedź naszą kompleksową dokumentację:

👉 SparkyFitness Dokumentacja

Szybkie linki

• 🚀 Pierwsze kroki - Kompletny przewodnik po konfiguracji dla deweloperów i produkcji
• 🐳 Przewodnik Docker - Wdrażanie i konfiguracja Docker
• 🔧 Przepływ pracy deweloperskiej - Przewodnik dla deweloperów oraz proces kontrybucji
• 📊 Przegląd funkcji - Pełna dokumentacja funkcji
• 🏗️ Architektura - Architektura techniczna i projekt
• Zajrzyj do Wiki, aby uzyskać przykładową konfigurację środowiska i konfigurację aplikacji mobilnej.

🐳 Wdrażanie Docker

Produkcja (zalecane):

cp docker/.env.example .env  # Edit as needed
./docker/docker-helper.sh prod up
Access at http://localhost:3004

Rozwój:

cp docker/.env.example .env  # Edit as needed  
./docker/docker-helper.sh dev up
Access at http://localhost:8080 (live reloading)

Aby uzyskać szczegółowe instrukcje dotyczące konfiguracji, ustawienia środowiska i rozwiązywania problemów, zobacz pełną dokumentację.

⚠️ Znane problemy / Funkcje beta ⚠️

Poniższe funkcje są obecnie w fazie beta i mogą nie być dokładnie przetestowane. Oczekuj potencjalnych błędów lub niepełnej funkcjonalności:

• Chatbot AI
• Wsparcie dla wielu użytkowników
• Dostęp dla rodziny i znajomych
• Integracja z danymi Apple Health

Ta aplikacja jest intensywnie rozwijana. Rzeczy mogą nie działać zgodnie z oczekiwaniami z powodu migracji z Supabase do PostgreSQL. MOGĄ POJAWIĆ SIĘ KRYTYCZNE ZMIANY aż do osiągnięcia stabilnej wersji. Może być konieczna zmiana zmiennych Docker/środowiskowych przy nowych wydaniach. Dlatego automatyczne aktualizacje przez Watchtower lub podobne aplikacje nie są zalecane. Przeczytaj notatki o wydaniu w poszukiwaniu KRYTYCZNYCH ZMIAN.

--- Tranlated By Open Ai Tx | Last indexed: 2025-10-04 ---