# TippKeks

> TippKeks ist ein quelloffenes Fußball-Tippspiel für private Freundesgruppen — zum Selbsthosten, werbefrei und unter MIT-Lizenz.

TippKeks war das private Tippspiel unserer Freundesrunde zur Fußball-Weltmeisterschaft 2026: Ergebnisse tippen, Punkte kassieren, in der Rangliste streiten. Das Turnier ist vorbei — der Code ist jetzt offen. Wer mag, hostet sich seine eigene Runde für das nächste Turnier.

## Wartungsstand

Das Projekt wird derzeit nicht aktiv weiterentwickelt. Es hat mit der WM 2026 sein Ziel erreicht und liegt jetzt als Open Source vor. Es gibt keine Zusage für neue Funktionen, für Antwortzeiten auf Issues oder für regelmäßige Updates — auch nicht für Abhängigkeiten. Wer TippKeks einsetzen möchte, sollte einplanen, den Betrieb selbst zu übernehmen; ein Fork ist ausdrücklich erwünscht.

## Funktionsumfang

- **Tipps bleiben geheim**: Getippt wird bis zum Anpfiff, sichtbar für die anderen wird ein Tipp erst danach. Über die Deadline entscheidet die Uhr der Datenbank — nicht der Browser, an dem sich drehen ließe.
- **Punkte rechnet der Server**: Ergebnisse kommen automatisch von football-data.org, die Punkte berechnet Postgres. Exakter Tipp, Tordifferenz, Tendenz und ein Bonus auf das weiterkommende Team — die Regeln sind pro Gruppe konfigurierbar.
- **Eine Gruppe pro Freundesrunde**: Beitritt per Einladungslink, jede Gruppe mit eigener Rangliste und eigenen Admins. Dass keine Gruppe die Tipps einer anderen sieht, erzwingt Postgres selbst per Row Level Security.
- **Läuft als App auf dem Handy**: Installierbar als PWA, mit optionalen Push-Nachrichten: eine Erinnerung, wenn ein Tipp noch fehlt, und die eigene Punktzahl, sobald ein Spiel abgepfiffen ist.

## Technik

Server-first gebaut: gelesen wird in React Server Components, geschrieben über Server Actions, und die Zugriffsrechte hängen nicht am UI, sondern an Postgres-Policies.

- Next.js 16 · React 19 · TypeScript
- Supabase — Postgres, Auth, Row Level Security
- Tailwind CSS v4 · shadcn/ui
- Container-Image für Podman/Docker

## Häufige Fragen

### Was ist TippKeks?

TippKeks ist ein quelloffenes Fußball-Tippspiel für private Freundesgruppen. Die Mitglieder einer Gruppe tippen vor dem Anpfiff das Ergebnis jedes Spiels, die echten Ergebnisse werden automatisch synchronisiert, und eine Rangliste zeigt, wer vorn liegt. Der Quellcode steht unter MIT-Lizenz auf GitHub.

### Was kostet TippKeks?

Nichts. TippKeks ist kostenlos, werbefrei und verzichtet auf Tracking. Es gibt keinen öffentlichen Dienst zum Mitmachen: Wer TippKeks nutzen möchte, betreibt seine eigene Instanz.

### Kann ich TippKeks selbst hosten?

Ja, das ist der vorgesehene Weg. TippKeks ist eine Next.js-Anwendung mit Supabase (PostgreSQL und Auth) als Backend und wird als fertiges Container-Image für Podman oder Docker veröffentlicht. Die Schritt-für-Schritt-Anleitung steht in der README im Repository.

### Wie werden die Punkte berechnet?

Punkte gibt es für das exakte Ergebnis, für die richtige Tordifferenz und für die richtige Tendenz, dazu einen Bonus für das richtig getippte weiterkommende Team. Die genauen Werte sind pro Gruppe konfigurierbar. Gerechnet wird in der Datenbank, nicht im Browser.

### Wer kann meine Tipps sehen?

Vor dem Anpfiff niemand außer dir selbst und den Administratoren deiner Gruppe. Erst nach dem Anpfiff werden Tipps für die anderen Mitglieder sichtbar. Durchgesetzt wird das von Row-Level-Security-Policies in PostgreSQL, nicht bloß von der Oberfläche.

### Funktioniert TippKeks auch für andere Turniere als die WM 2026?

Ja. Sportart, Wettbewerb, Saison und Turnierphase sind getrennt modelliert, und Spielpläne kommen über einen austauschbaren Anbieter herein — in der Standardkonfiguration football-data.org. Ein anderes Turnier erfordert deshalb keinen Umbau am Code.

### Wird TippKeks aktiv weiterentwickelt?

Nein. Das Projekt wird derzeit nicht aktiv gewartet. Es entstand für die WM 2026 und ist danach als Open Source veröffentlicht worden. Der Code bleibt verfügbar und Sicherheitsmeldungen werden gelesen, aber es gibt keine Zusage für neue Funktionen, Antwortzeiten oder Updates. Wer darauf aufbauen möchte, sollte forken und den Betrieb selbst übernehmen.

## Links

- [Repository](https://github.com/wittfabian/tippkeks)
- [Installationsanleitung (README)](https://github.com/wittfabian/tippkeks#readme)
- [Lizenz (MIT)](https://github.com/wittfabian/tippkeks/blob/main/LICENSE)

Stand: 2026-08-10