From 81a752c669a816d20b6ad580c00476b2493d69ca Mon Sep 17 00:00:00 2001
From: Tobias Leuschner <info@leuschner.dev>
Date: Sun, 22 Feb 2026 11:14:09 +0100
Subject: [PATCH] =?UTF-8?q?F=C3=BCge=20README.md=20hinzu,=20um=20die=20Fun?=
 =?UTF-8?q?ktionsweise=20und=20Struktur=20der=20Finger=20Chooser=20App=20z?=
 =?UTF-8?q?u=20dokumentieren?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2710a94
--- /dev/null
+++ b/README.md
@@ -0,0 +1,49 @@
+# Finger Chooser
+
+Eine browserbasierte Multi-Touch-App zum zufälligen Auswählen eines Fingers. Alle Teilnehmer legen einen Finger auf das Display — die App wählt per animierter Roulette-Animation einen Finger als Gewinner aus.
+
+## Funktionsweise
+
+1. Zwei oder mehr Finger auf das Display legen
+2. Nach 700 ms startet automatisch die Auswahl-Animation
+3. Die Kreise leuchten nacheinander auf (Roulette), bis ein Gewinner feststeht
+4. Alle Finger anheben um neu zu starten
+5. Wird während der Wartezeit ein weiterer Finger aufgelegt, beginnt der Timer von vorne
+
+## Besonderheiten
+
+- **Kein Fingerlimit** auf Android, iPad und Desktop (bis zu 20 Touches)
+- **5-Finger-Limit** auf iPhone (iOS Safari Hardware-Grenze)
+- Zusätzliche Finger über dem Limit werden still ignoriert — kein Reset
+- Neuer Finger während der Animation → Auswahl bricht ab und startet neu
+
+## Lokaler Entwicklungsserver
+
+Voraussetzung: Node.js installiert
+
+```bash
+npm start
+```
+
+Der Server läuft auf Port 8080 und ist im lokalen Netzwerk erreichbar.
+
+**Handy verbinden:**
+1. PC und Gerät im selben WLAN
+2. IP-Adresse des PCs herausfinden: `ipconfig` (Windows) → IPv4-Adresse
+3. Im Browser des Geräts aufrufen: `http://<IP>:8080`
+
+## Projektstruktur
+
+```
+ChooserApp/
+├── index.html       # Einstiegspunkt
+├── css/
+│   └── style.css    # Styles & Animationen
+├── js/
+│   └── app.js       # Touch-Logik
+└── package.json     # npm start Script
+```
+
+## Technologie
+
+Reines HTML/CSS/JavaScript — kein Framework, kein Build-Schritt.