🍳 LiveBite — The Ultimate Local-First Kitchen Companion

Twoja inteligentna, lokalna książka kucharska z asystentem gotowania na żywo, trybem bezdotykowym i dynamicznym skalowaniem porcji.

---

🌟 Dlaczego LiveBite?

LiveBite zostało stworzone z myślą o pasjonatach gotowania, którzy cenią sobie prywatność, prostotę oraz wygodę podczas pracy w kuchni z brudnymi rękami.

Aplikacja łączy w sobie potęgę lokalnej bazy danych SQLite z asystentem AI, inteligentnymi minutnikami i możliwością wygodnego pisania przepisów na komputerze.

---

🚀 Kluczowe Funkcje

✋ 1. Tryb Gotowania na Żywo (Hands-Free Kitchen Mode)

• Ekran nigdy nie gaśnie (expo-keep-awake) podczas przygotowywania potrawy.
• Sterowanie łokciem / nadgarstkiem: Specjalny tryb z gigantycznymi strefami dotykowymi na dole ekranu, dzięki czemu możesz przełączać kroki nawet mając dłonie w cieście czy sosie.
• Wyrazisty kontrast: Ciemne tło Obsidian z dużym, czytelnym tekstem kroków widocznym z odległości blatu kuchennego.

⏱️ 2. Hub Minutników (Multi-Timer Hub)

• Automatyczne wykrywanie czasów: Silnik analizuje treść przepisu (np. „gotuj wywar przez 90 minut”, „gotuj jajka przez 6 minut i 15 sekund”) i sam konfiguruje minutniki dla każdego kroku.
• Równoległe minutniki w pływającym pasku: Uruchamiaj niezależne odliczanie dla makaronu, piekarnika i mięsa jednocześnie.
• Haptyka i alarm wibracyjny po zakończeniu odliczania.

🧮 3. Dynamiczny Silnik Skalowania Porcji (Step & Ingredient Scaler)

• Zmień porcje z 2 na 4 lub 6 — aplikacja automatycznie przeliczy:
  • Listę składników (w gramach, mililitrach, łyżkach, sztukach itp.).
  • Treść instrukcji w krokach: „W rondelku podgrzej 600 ml bulionu...” ➔ „W rondelku podgrzej 1200 ml bulionu...”.
  • Bezpieczeństwo kulinarne: Czasy gotowania i temperatury pieczenia nie są skalowane, ponieważ nie zależą liniowo od liczby porcji.

📤 4. Błyskawiczne Dzielenie się i Import z Czatu (WhatsApp / SMS / Messenger)

• 1-klik udostępnianie: Wyślij sformatowany przepis z emoji, składnikami i krokami do znajomych przez dowolny komunikator lub skopiuj plik JSON.
• Uniwersalny importer tekstu: Otrzymałeś przepis od znajomego na WhatsAppie? Skopiuj wiadomość, otwórz LiveBite i kliknij 📋 Wklej ze schowka — silnik rozpozna składniki i kroki, od razu zapisując danie w Twojej bibliotece!
• Zero problemów z limitem znaków: Bezpośredni import ze schowka i plików .json radzi sobie z dowolnie rozbudowanymi daniami (np. wieloskładnikowy ramen z licznymi krokami i notatkami).

🤖 5. Import przez AI (ChatGPT, Claude, DeepSeek, BYOK API)

• Wbudowany szablon promptu: 1 kliknięciem kopiujesz profesjonalny prompt kulinarny do wklejenia w ChatGPT/Claude.
• Bring Your Own Key (BYOK): Opcja bezpośredniej integracji z API OpenAI, Google Gemini lub Groq. Klucze API są szyfrowane w sprzętowym magazynie SecureStore (Android Keystore / iOS Keychain).

💻 6. PC Studio Companion (Zero-Setup Web Editor)

• Pisz przepisy na pełnej klawiaturze komputera w darmowym edytorze online: https://sidearker.github.io/LiveBite/.
• Przenoś przepisy na telefon błyskawicznie przez schowek lub pobierając paczkę .json.

🛒 7. Zintegrowana Lista Zakupów

• 1 kliknięciem przenoś brakujące składniki z dowolnego przepisu na wspólną listę zakupów z podziałem na kategorie i odhaczaniem w sklepie.

🎨 8. Ciemny Motyw Obsidian & Płynne Przejścia 60 FPS

• Głęboka paleta barw Obsidian (#0B0F17, #161F2E, #FF5722) oszczędzająca baterię na ekranach OLED.
• Płynne, natywne animacje wejścia i wyjścia z ekranów (ScreenTransition).
• Własny, w 100% ostylowany system dialogów i popupów (CustomDialog).

---

🏗️ Architektura i Struktura Projektu

LiveBite/
├── assets/                       # Ikony aplikacji, splash screen i grafiki
├── docs/                         # Publiczny Web Editor na GitHub Pages (index.html)
├── src/
│   ├── components/               # Współdzielone komponenty (CustomDialog, ScreenTransition)
│   ├── db/                       # Baza danych SQLite, repozytorium, migracje i starter recipes
│   ├── features/
│   │   ├── ai-importer/          # Parsery JSON AI, prompty i integracje BYOK API
│   │   ├── live-cooking/         # Tryb gotowania na żywo, tryb bezdotykowy, multi-timery
│   │   ├── recipes/              # Lista przepisów, edytor, ekran szczegółów, panel udostępniania
│   │   ├── settings/             # Ustawienia, backup bazy, konfiguracja API
│   │   ├── shopping-list/        # Lista zakupów z synchronizacją ze składnikami
│   │   └── sync/                 # PC Sync Companion i szybki import ze schowka
│   ├── theme/                    # Kolorystyka Obsidian, typografia i kategorie
│   ├── types/                    # Definicje typów TypeScript (Recipe, Ingredient, Step, Timer)
│   └── utils/                    # Silnik skalowania kroków, timerDetector, kalkulator makro
├── tests/                        # 8 pakietów testowych Jest (42 testy jednostkowe i integracyjne)
├── App.tsx                       # Główny kontener aplikacji z animowaną nawigacją
├── app.json                      # Konfiguracja Expo SDK 57 i uprawnień Android/iOS
└── package.json                  # Zależności projektu

---

🛠️ Uruchomienie i Rozwój

Wymagania wstępne:

• Node.js 20+
• Aplikacja Expo Go na telefonie (Android lub iOS)

Instalacja i uruchomienie:

# 1. Klonowanie repozytorium
git clone https://github.com/SideArker/LiveBite.git
cd LiveBite

# 2. Instalacja zależności
npm install

# 3. Uruchomienie serwera deweloperskiego Expo
npm start

Zeskanuj kod QR wyświetlony w terminalu za pomocą aplikacji Expo Go lub aparatu w telefonie.

Uruchomienie testów:

npm test

Budowanie paczki instalacyjnej APK (Android):

npx eas build -p android --profile preview

---

🔒 Prywatność i Bezpieczeństwo

1. Zero Tracking: Aplikacja nie zbiera żadnych danych telemetrycznych, analitycznych ani ciasteczek.
2. 100% Offline First: Baza przepisów, historia gotowania i lista zakupów działają całkowicie bez dostępu do Internetu.
3. Szyfrowanie Kluczy: Wszelkie klucze API AI (jeśli podane przez użytkownika) są zapisywane w zaszyfrowanym magazynie Expo SecureStore.

---

📄 Licencja

Projekt udostępniony na licencji MIT. Smacznego gotowania z LiveBite! 🍜