ad0284585b
Goon — self-hosted aggregator for adult-content scene metadata. Indexes scenes from TPDB, StashDB, and 30+ public adult tube sites. Cross-source deduplication via perceptual hash + Levenshtein distance. FastAPI backend + APScheduler worker + React Native (Expo) mobile client. FOSS, ad-free, donation-funded. See README for details.
71 lines
2.1 KiB
Markdown
71 lines
2.1 KiB
Markdown
# goon mobile (Expo / React Native)
|
|
|
|
Mobile client do self-hosted goon backendu. iOS/Android jeden codebase.
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
cd mobile
|
|
npm install
|
|
npx expo start
|
|
```
|
|
|
|
Następnie:
|
|
- **Expo Go** (iOS/Android): zeskanuj QR z terminala
|
|
- **Android emulator**: `npm run android`
|
|
- **iOS simulator**: `npm run ios` (tylko macOS)
|
|
- **Web preview**: `npm run web`
|
|
|
|
## Konfiguracja
|
|
|
|
Po pierwszym uruchomieniu zobaczysz ekran logowania:
|
|
|
|
- **Backend URL** — adres twojego goon backendu, np.:
|
|
- `http://192.168.1.10:8000` (LAN)
|
|
- `https://goon.tvojadomena.dev` (przez Cloudflare Tunnel/Caddy)
|
|
- `http://100.x.x.x:8000` (przez Tailscale)
|
|
- **API Key** — klucz wygenerowany dla backendu, ustawiony w `.env`:
|
|
```
|
|
API_KEYS=<klucz>
|
|
```
|
|
Generowanie:
|
|
```bash
|
|
python -c "import secrets; print(secrets.token_urlsafe(32))"
|
|
```
|
|
|
|
Klucz jest trzymany w `expo-secure-store` (Keychain na iOS, Keystore na Androidzie).
|
|
|
|
## Ekrany
|
|
|
|
- **Login** — backend URL + API key, weryfikacja przez `/healthz` + `/scenes`
|
|
- **Scenes** — lista scen z search; pull-to-refresh
|
|
- **Scene detail** — performerzy, tagi, źródła, opis
|
|
- **Merge queue** — pending merge candidates, sortowane po score (desc)
|
|
- **Merge detail** — side-by-side dwóch scen + reasons + akcje:
|
|
- **Merge → keep LEFT** (default — left to wcześniejsza/kanoniczna)
|
|
- **Merge → keep RIGHT** (gdy nowsza wersja ma lepsze metadane)
|
|
- **Reject (keep both)** — to nie jest duplikat, zostawiamy oddzielnie
|
|
|
|
## Stack
|
|
|
|
- Expo SDK 52 + React Native 0.76 (new architecture)
|
|
- TypeScript strict
|
|
- React Navigation 7 (native stack)
|
|
- TanStack Query 5 (cache, optimistic invalidation)
|
|
- expo-secure-store (credentials)
|
|
|
|
## Build .apk (sideload na Androida)
|
|
|
|
```bash
|
|
npx eas build --profile preview --platform android
|
|
```
|
|
|
|
Wymaga konta Expo. Bez niego można użyć `expo prebuild` + `gradlew assembleRelease`.
|
|
|
|
## Dlaczego nie PWA
|
|
|
|
Wybrany RN+Expo zamiast PWA bo:
|
|
- swipe gestures pasują do triage merge queue
|
|
- secure-store jest natywny (Keychain/Keystore) zamiast localStorage
|
|
- pull-to-refresh i FlatList virtualization out-of-the-box
|
|
- Jeden .apk można rozdać testerom bez App Store
|