- TypeScript 95.6%
- Swift 1.5%
- CSS 1.4%
- JavaScript 0.7%
- Java 0.5%
- Other 0.3%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| android | ||
| ios | ||
| public | ||
| resources | ||
| server | ||
| src | ||
| test | ||
| .env.example | ||
| .gitignore | ||
| AGENTS.md | ||
| capacitor.config.ts | ||
| index.html | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.js | ||
| README.md | ||
| tailwind.config.js | ||
| tsconfig.json | ||
| vite.config.ts | ||
📱 Wer hat's geliked? (YouLiked) — Das Instagram Party-Ratespiel
Ein modernes Multiplayer-Social-Game für Web & Mobile: Die Gruppe sieht ein virales Instagram Reel und muss geheim erraten, wer aus der Runde es geliked hat!
Entwickelt mit Fokus auf ein hochwertiges, maßgeschneidertes Party-Game-Design (kein generischer AI-Slop), mobile-first Touch-Steuerung, Echtzeit-Direktverbindungen und vollem PWA-Support.
Dezentraler Spielzustand: Es gibt keinen zentralen Spielserver. Der Host-Browser ist die Autorität, Gäste verbinden sich per WebRTC-DataChannel direkt mit ihm. Für den automatischen Beitritt wird nur der Answer-Austausch (SDP) relayt — entweder über einen lokalen WLAN-Server (npm run local, ganz ohne Internet) oder im statischen Online-Modus über einen öffentlichen MQTT-Broker. Ohne Relay bleibt der manuelle QR/Paste-Flow. Der statische Build kann überall liegen (GitHub Pages, Netlify, IPFS, eigener Webserver).
✨ Features
- 🎮 Echtzeit-Multiplayer ohne zentralen Spielserver:
- Der Host erstellt einen Raum auf seinem Gerät.
- Gäste verbinden sich per Einladungs-QR direkt mit dem Host. Der Host muss nichts scannen: Der Gast scannt den QR, die App öffnet sich, und die Answer wird automatisch über den Signaling-Kanal zurückgeschickt.
- Fallback ohne Relay: Link kopieren und einfügen, der Host fügt den Antwort-Code ein. Alternativ kann der Host den Answer-QR scannen.
- 📶 WLAN-only-Modus:
npm run localliefert die App über die LAN-IP aus und relayt das Signaling über einen lokalen WebSocket. Kein Internet, kein öffentlicher Broker, Host scannt nichts. - 🎚️ Flexible Rundenanzahl: 3/5/8/10, eine eigene Zahl (1–99) oder „Alle“ — dann werden alle vorhandenen Likes gespielt, bis der Like-Pool leer ist.
- 📱 Mobile-First & PWA-Ready:
- Selbst gezeichnete Avatare und die Avatar-Auswahl werden lokal auf dem Gerät gespeichert und beim nächsten Start wieder geladen. Ein Wechsel zu einem Emoji behält die letzte Zeichnung. Das Löschen der App-/Website-Daten entfernt auch den gespeicherten Avatar.
- Auf Smartphones optimiert (große Touch-Ziele, haptisches Vibrationsfeedback via
navigator.vibrate, Safe-Area-Insets für iOS Notches / Dynamic Island). - Als PWA installierbar ("Zum Home-Bildschirm hinzufügen").
- 📸 4 Wege zur Instagram-Anbindung:
- Insta-Vibe & Archetypen (Party-Schnellstart):
- Wähle aus typischen Feed-Persönlichkeiten: Meme & Shitpost Junkie, Toxic Love & Red Flag Guru, Gym-Rat & Grindset Sigma, Mitternachts-Gourmet & Chaos-Chef, Tier-Therapie & Chaoten-Hunde, 3-Uhr-Nachts Aluhut & Nische, Komm in die Gruppe & High-Performer.
- Echte Instagram-Daten hochladen (Offizieller JSON-Export):
- Unterstützt Instagrams offiziellen Daten-Download (
your_instagram_activity/likes/liked_posts.json). - Drag & Drop Parser mit automatischer Link- und Zeitstempel-Verarbeitung.
- Unterstützt Instagrams offiziellen Daten-Download (
- Eigene Reel-Links einfügen:
- Schnelles Hinzufügen von individuellen Instagram Reel URLs.
- Instagram Demo Login:
- Authentisches Login-Interface zur Demonstration des Account-Syncs.
- Insta-Vibe & Archetypen (Party-Schnellstart):
- 🎬 Authentischer 9:16 Reel Video Player:
- Direkte Wiedergabe der Videodatei im eigenen
<video>-Player, ohne Instagram-Embed oder Instagram-Oberfläche. - Inline-Wiedergabe, Pause, Zeitleiste und Wiederholung. Der Ton ist standardmäßig an. Falls der Browser Autoplay mit Ton blockiert, startet „Video mit Ton starten“ die Wiedergabe nach einem Tippen.
- iOS und Android lösen öffentlich verfügbare Reels direkt über native HTTP-Anfragen auf. Der Browser nutzt
/api/reels/:idauf dem YouLiked-Server bzw. Vite-Entwicklungsserver. - „Neu laden“ ruft eine frische Videoadresse ab. Private, gelöschte oder von Instagram gesperrte Videos zeigen eine Fehlermeldung statt eines endlosen Ladebildschirms.
- Direkte Wiedergabe der Videodatei im eigenen
- 🥁 Dramatischer Reveal & Suspense:
- Trommelwirbel & Countdown-Spannung vor der Auflösung.
- Konfetti-Explosion bei Enthüllung des echten Likers.
- Transparente Stimmenverteilung (wer hat auf wen getippt?).
- 🏆 Punkte- & Bonussystem:
- 1000 Pkt für jeden richtigen Tipp.
- ⚡ Schnelligkeits-Bonus: Bis zu +500 Pkt bei Antworten in den ersten Sekunden.
- 🔥 Serien-Bonus: Extra-Punkte für Treffer-Strähnen.
- 🕵️♂️ Alibi-Bonus: +500 Pkt für den Liker, wenn niemand aus der Gruppe ihn verdächtigt hat!
- 📖 Offenes Buch-Bonus: Bonus wenn die Gruppe den Geschmack sofort durchschaut hat.
- 🥇 Podium & Sonder-Auszeichnungen:
- 3D-Party-Podium (1., 2. und 3. Platz).
- Dynamische Awards: Der Sherlock Holmes, Der Alibi-König, Das offene Buch, Speed-Dämon.
- 🔊 Integrierte Sound-Engine (Web Audio API):
- 100% autark synthetisierte Soundeffekte (Lobby-Chimes, Countdown-Ticken, Lock-In Buzzer, Trommelwirbel, Fanfaren) – zero externe Audio-Assets. Stummschaltbar mit einem Klick.
- 🤖 Demo-Bots für Solo- & Testrunden:
- Ein Klick auf "+ Bot" in der Lobby fügt simulierte Mitspieler mit echten Archetypen und Like-Verhalten hinzu.
🚀 Schnellstart
1. Installation
npm install
2. Entwicklung starten (statisch/online)
npm run dev
- Frontend öffnet auf
http://localhost:5173. - Der Einladungs-QR nutzt auch im Dev-Modus automatisch die LAN-IP statt localhost (Vite injiziert sie). Nach Änderungen an
vite.config.tsden Dev-Server neu starten und die Seite neu laden. - Falls Gäste die LAN-IP nicht erreichen: Die macOS-Firewall muss eingehende Verbindungen für Node erlauben (Node ist unsigniert):
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add "$(node -p 'process.execPath')"und--unblockappmit demselben Pfad. Danach Vite neu starten. - Der automatische Answer-Austausch nutzt hier den öffentlichen MQTT-Broker; für WLAN-only ohne Internet
npm run localnutzen.
3. WLAN-only starten (ohne Internet)
npm run local
- Baut die App und startet den lokalen Server auf Port
3001. - Terminal zeigt
Local: http://localhost:3001undNetz: http://192.168.x.x:3001. - Der Host öffnet die App (localhost oder Netz-URL); der QR nutzt automatisch die Netz-URL, nie localhost.
- Gäste im selben WLAN scannen den QR mit der normalen Handy-Kamera. Der lokale Server liefert die App aus und relayt nur die Answer; der Spielzustand bleibt P2P im Host-Browser.
- Voraussetzungen: gleiches WLAN, kein AP-/Client-Isolation, Port
3001frei, Host-Gerät bleibt an. Die macOS-Firewall muss eingehende Verbindungen für Node erlauben (Systemeinstellungen → Netzwerk → Firewall → Optionen; ggf. Node hinzufügen/freigeben). Sonst können Gäste die LAN-IP nicht erreichen. - Der In-App-Kamera-Scanner funktioniert auf HTTP-LAN nicht (Secure Context); Gäste nutzen die System-Kamera. Der Host muss nicht scannen.
PUBLIC_BASE_URL=http://192.168.x.x:3001 npm startüberschreibt die Basis-URL (z. B. für Tests oder Reverse-Proxys).
4. Production Build (statisch/online)
npm run build
npm run preview
Der komplette Build liegt in dist/. Diesen Ordner kannst du auf einen beliebigen statischen Host legen (GitHub Pages, Netlify, Cloudflare Pages, IPFS-Gateway, nginx …). Für den automatischen Join wird dann der öffentliche MQTT-Broker genutzt.
Die direkte Videowiedergabe im Browser benötigt zusätzlich den YouLiked-Endpunkt /api/reels/:id; dieser ist in npm run dev, npm run preview und npm start enthalten. Ein reiner statischer Host kann Instagram wegen CORS nicht selbst auflösen. Die nativen iOS-/Android-Apps verwenden dafür native HTTP-Anfragen und benötigen diesen Server nicht. Der Resolver verwendet Instagrams öffentliche, nicht offiziell zugesicherte Web-Schnittstelle: Änderungen, Login-Pflicht oder Abruflimits bei Instagram können einzelne Videos verhindern. Der Instagram-Like-Export enthält Links, keine Videodateien.
5. Tests ausführen
npm test
Führt Parser-, Engine-, Reconnect-, Signaling-, lokale Relay- und P2P-Verbindungstests aus (einschließlich verspäteter ICE-Kandidaten, Verbindungs-Timeouts und abgebrochener Beitritte). npm run test:relay prüft zusätzlich die Host-Empfangsbestätigung und erneute Zustellung gegen den öffentlichen MQTT-Broker und benötigt Internet.
🔗 So funktioniert die Verbindung
- Der Host erstellt den Raum lokal in seinem Browser. Die Spiel-Logik (
src/game/engine.ts) läuft ausschließlich dort. - Der Host öffnet „Gäste verbinden" und zeigt einen Einladungs-QR. Der QR enthält
<app-url>#offer=<komprimierter Offer-Code>. - Der Gast scannt ihn mit der normalen Handy-Kamera. Der Link öffnet die App, der Offer-Code wird automatisch übernommen. Nach dem Profil erzeugt der Gast lokal eine Answer und publiziert sie über den Signaling-Broker.
- Der Host empfängt die Answer automatisch — kein Scan nötig — und baut den WebRTC-DataChannel direkt zum Gast auf. Falls der Broker nicht erreichbar ist, kann der Host die Answer manuell scannen oder den Code einfügen.
- Der Host schickt bei jeder Änderung sanitisierte State-Snapshots an alle Gäste. Geheime Liker bleiben während der Runde verborgen.
- Fällt eine Verbindung aus, kann der Gast mit einem neuen Offer/Answer-Handshake wieder beitreten und behält seinen Spieler (Session-Token im
sessionStorage).
Der Offer-Code steckt im URL-Fragment (#offer=...), damit er nicht an Server, Logs oder Referrer geht. Mit VITE_PUBLIC_APP_URL lässt sich die Basis-URL des Einladungslinks überschreiben — nützlich für native Wrapper, Universal Links oder einen festen HTTPS-Host.
WLAN-Modus: Die App erkennt den lokalen Server über /api/network, verwendet die LAN-IP als Einladungsbasis und legt die lokale WebSocket-URL als sig in den Offer. Der Server relayt nur die Answer; es gibt keinen Spielzustand auf dem Server. Online/statisch: Der automatische Answer-Austausch nutzt wss://broker.hivemq.com:8884/mqtt (öffentlicher MQTT-Broker, nur Signaling). Mit VITE_SIGNAL_BROKER kann ein eigener Broker gesetzt werden. Beide Signaling-Wege sehen nur SDP/ICE-Kandidaten, keine Likes oder Spielzustände.
Wichtig für den QR-Scan: Kamera-Zugriff benötigt HTTPS (localhost ist die Ausnahme). Im WLAN-Modus wird die App über HTTP ausgeliefert — Gäste scannen daher mit der normalen Handy-Kamera (der In-App-Scanner bleibt auf HTTP deaktiviert). Der Host braucht keinen Scan; der manuelle Fallback per Paste funktioniert weiterhin.
Grenzen der Dezentralität
- Das Host-Gerät muss während des Spiels online bleiben. Ein Host-Reload stellt den Raum aus dem
sessionStoragewieder her, die Gäste müssen sich danach neu per QR verbinden. - Der 4-stellige Raum-Code ist nur noch ein Etikett; ein Beitritt ohne QR/Code ist ohne Rendezvous-Server nicht möglich.
- Für NAT-Traversal werden standardmäßig öffentliche STUN-Server genutzt. In Mobilfunk-/CGNAT-Netzen oder WLANs mit Client-Isolation kann die Direktverbindung scheitern. Eigene STUN-/TURN-Server können vor dem Build als JSON-Array über
VITE_ICE_SERVERSkonfiguriert werden (Beispiel in.env.example). Ohne konfigurierte TURN-Zugangsdaten steht kein TURN-Relay zur Verfügung. Verwende kurzlebige Zugangsdaten, daVITE_-Werte im ausgelieferten Build sichtbar sind. - Der Online-Signaling-Kanal bestätigt den tatsächlichen Empfang beim Host und wiederholt Antworten bei kurzen Unterbrechungen. Nach spätestens 60 Sekunden ohne erfolgreichen Handshake erscheint ein Fehler mit Hinweisen zum erneuten Beitritt. Beide Geräte benötigen die aktuelle App-Version für den neuen automatischen Austausch; der manuelle Antwort-Code bleibt verfügbar.
- Im Online-Modus hängt der automatische Beitritt von einem öffentlichen MQTT-Broker ab. Ist er blockiert oder überlastet, greift der manuelle Scan/Paste-Fallback. Für volle Kontrolle eigenen Broker über
VITE_SIGNAL_BROKERsetzen. - Im WLAN-Modus müssen sich Host und Gäste im selben WLAN befinden, ohne AP-/Client-Isolation. Die macOS-Firewall muss eingehende Verbindungen für Node erlauben, sonst ist die LAN-IP nicht erreichbar. Der Host-Laptop muss an bleiben.
- Der Host hält die Like-Daten aller Spieler im Browser-Speicher, weil er das Deck baut. Es gibt keinen Server, der sie sieht.
📱 Auf dem Smartphone mitspielen
- Hoste den
dist/-Build über HTTPS (oder nutze für lokale Testsnpm run devauf dem Rechner und öffne die App auf demselben Gerät). - Öffne die App auf Host- und Gast-Gerät.
- Host: Raum erstellen → „Gäste verbinden" → Einladungs-QR zeigen.
- Gast: QR mit der normalen Handy-Kamera scannen → Link öffnet die App → Profil ausfüllen. Die Answer geht automatisch zurück.
- Host: nichts weiter tun — der Gast erscheint automatisch. Nur im Fallback den Answer-QR scannen oder Code einfügen.
- Tippe auf dem Handy im Browser auf "Zum Startbildschirm hinzufügen", um das Spiel wie eine native iOS- oder Android-App im Vollbildmodus zu spielen.
📦 Native App (Capacitor)
Die App ist als Capacitor-Projekt für iOS und Android eingerichtet (ios/, android/). Der komplette Spiel-Code bleibt identisch — die native App ist die gleiche Web-App plus native Features:
- Nativer QR-Scanner (
@capacitor/barcode-scanner) stattgetUserMedia; keine HTTPS-Pflicht für die App. Im Normalfall scannt nur der Gast; der native Scanner dient dem Host nur als Fallback. - Share-Sheet (
@capacitor/share) für Einladungslinks. - Deep Links über das registrierte Custom Scheme
youliked://(@capacitor/app), optional Universal/App Links. - Direkter Reel-Player ohne Embed: native HTTP-Auflösung öffentlicher Videoadressen und Inline-Wiedergabe auf iOS und Android. Es werden keine Instagram-Zugangsdaten abgefragt.
- App-Icon und Splash in
resources/(neu generieren:npm run assets, danachnpm run cap:sync).
Bauen
npm install
npm run cap:sync # Web-Build + Assets in ios/ und android/ kopieren
npm run cap:ios # baut + öffnet Xcode (iOS)
npm run cap:android # baut + öffnet Android Studio
- iOS: Xcode, Signing-Team wählen, auf Gerät/Simulator starten. Capacitor 8 nutzt Swift Package Manager — CocoaPods ist nicht nötig. Falls
xcodebuildauf die Command Line Tools zeigt:sudo xcode-select -s /Applications/Xcode.app/Contents/Developer. - Android: Android Studio / SDK; alternativ
cd android && ./gradlew assembleDebug. Für den Gradle-CLI-Build wird JDK 21+ benötigt (Android Studio bringt ein passendes JDK mit).minSdkVersionist 26 (Vorgabe des nativen Barcode-Scanners). Ein gebautes Debug-APK liegt unterartifacts/app-debug.apk(nach einem eigenen Build sonst unterandroid/app/build/outputs/apk/debug/app-debug.apk). - Bundle-ID / Application-ID:
de.youliked.app(incapacitor.config.ts, Xcode undandroid/app/build.gradleanpassen, falls gewünscht). - Berechtigungen: Kamera (Info.plist / AndroidManifest) und lokales Netzwerk (iOS) sind gesetzt.
Links
Ohne weitere Konfiguration erzeugt die native App Einladungslinks mit youliked://join#offer=.... Der Link funktioniert mit der System-Kamera, wenn die App installiert ist; alternativ den QR direkt in der App scannen (nativer Scanner).
Sollen auch Web-Gäste oder Universal Links funktionieren, setze VITE_PUBLIC_APP_URL auf eine öffentliche HTTPS-Adresse und richte Universal Links (iOS Associated Domains) bzw. App Links (Android assetlinks.json) ein. Beispiel siehe .env.example.
Grenzen
WebRTC-DataChannels funktionieren in den aktuellen iOS-/Android-WebViews. Die P2P-Grenzen (Host muss online bleiben, STUN/TURN) bleiben bestehen. Ein reiner WebView-Wrapper kann im App Store an Guideline 4.2 scheitern — nativer QR-Scanner, Share-Sheet und Deep Links geben der App echten nativen Mehrwert.
Der WLAN-Auto-Modus ist für die im LAN ausgelieferte Web-App gedacht. Native Apps laufen aus einem sicheren Origin und blockieren ws://-LAN-Signaling ggf. als Mixed Content; dort den Online-Relay oder den manuellen Fallback nutzen.
🛠️ Tech-Stack
- Frontend: React 19, TypeScript, Tailwind CSS v4, Lucide Icons, Canvas-Confetti.
- Transport: WebRTC DataChannels (Stern-Topologie, Host = Autorität), gzip-komprimierte Offer/Answer-Codes.
- QR:
qrcodezum Erzeugen,jsqr+ Kamera zum Scannen. - Persistenz:
sessionStoragefür Host-Snapshot und Gast-Session. - Assets: lokal gebündelte Fonts (
@fontsource), keine externen CDNs. - Audio: Web Audio API Sound Synthesizer.
- Architektur: Transport-agnostische State-Machine (
GameEngine) mit sanitisierten Snapshots.