Community
Zu FairOrder beitragen
Beiträge sind willkommen. Ob Bugfix, neue Funktion oder Dokumentation — jeder Pull Request wird gelesen und reviewed.
Development-Setup
Das Contributor-Setup nutzt die :local-Scripts, die keine dotenvx-Verschlüsselung benötigen:
# Repository forken und klonen
git clone https://github.com/DEIN-USERNAME/fairorder.git
cd fairorder
# Umgebung einrichten
cp .env.example .env
# DATABASE_URL in .env anpassen
# Abhängigkeiten installieren
pnpm install
# Datenbank einrichten
pnpm db:generate
pnpm db:push
pnpm db:seed # Optional: Demo-Daten laden
# Dev-Server starten
pnpm dev:local # Startet auf http://localhost:3000
Tech Stack
| Bereich | Technologie |
|---|---|
| Framework | Next.js 16 (App Router, Turbopack) |
| Sprache | TypeScript (strict mode) |
| Datenbank | PostgreSQL mit Prisma ORM v7 |
| UI | Tailwind CSS v4, Radix UI, shadcn/ui |
| Auth | Magic Link mit httpOnly Session Cookies |
| Tests | Vitest |
| Package Manager | pnpm |
Code-Style
- -TypeScript strict mode. Keine
anyohne ESLint-Disable-Kommentar. - -
cn()auslib/utils.tsfür bedingte Klassen. - -Deutsche Locale mit informellem "du".
- -Border-Radius: immer
0px. - -Fonts: Plus Jakarta Sans (Headings), JetBrains Mono (Zahlen, Metadata).
Pull-Request-Prozess
- -Fork erstellen und Feature-Branch anlegen (
feat/mein-featureoderfix/mein-bugfix). - -Änderungen implementieren. Tests schreiben oder aktualisieren.
- -
pnpm lintundpnpm testlaufen lassen. - -Pull Request gegen
mainöffnen. Beschreibung auf Deutsch oder Englisch.
Commit-Konventionen
Wir verwenden Angular-Style Commit Messages:
feat: neue Funktion hinzufügen
fix: Bug in der Bestelllogik beheben
docs: README aktualisieren
chore: Abhängigkeiten updaten
refactor: Auth-Middleware vereinfachen
Einstiegspunkte
Gute Startpunkte für erste Beiträge:
- -Issues mit dem Label
good first issueauf GitHub - -Übersetzungen (z.B. Englisch)
- -Test-Coverage erweitern
- -Dokumentation verbessern