Open-Source, leichtgewichtige Trello-Alternative für Macher und Indie-Hacker.

Fokus auf Einfachheit, Geschwindigkeit und Skalierbarkeit. Gebaut mit modernem Stack: Tailwind CSS, shadcn/ui, Supabase, Stripe-Integration. Unterstützt unbegrenzte Projekte, Teamzusammenarbeit, Dunkel-/Hellmodus und nahtloses Benutzererlebnis. Perfekt für Einzelentwickler und kleine Teams, die volle Kontrolle ohne unnötige Komplexität wünschen.

🌟 Wenn dir dieses Projekt gefällt, gib ihm gerne einen Stern! So können es auch andere entdecken.

Bereitstellungsanleitung

Übersicht

Diese Anwendung verwendet nun lokale Next.js API-Routen statt Supabase Edge Functions für die Stripe-Integration. Dadurch wird die Bereitstellung vereinfacht und du kannst Standard-.env-Dateien für die Konfiguration nutzen.

Einrichtung der Umgebungsvariablen

1. Erstelle die Datei .env.local

Kopiere .env.example zu .env.local und trage deine tatsächlichen Werte ein:

cp .env.example .env.local

2. Erforderliche Umgebungsvariablen

#### Supabase-Konfiguration

• NEXT_PUBLIC_SUPABASE_URL - Die URL Ihres Supabase-Projekts
• NEXT_PUBLIC_SUPABASE_ANON_KEY - Ihr Supabase-Anonym-Schlüssel
• SUPABASE_SERVICE_ROLE_KEY - Ihr Supabase-Service-Rollen-Schlüssel (nur serverseitig)

#### Stripe-Konfiguration (optional)

• STRIPE_SECRET_KEY - Ihr Stripe-Geheimschlüssel (nur serverseitig)
• NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY - Ihr Stripe-Publishable-Key
• STRIPE_WEBHOOK_SECRET - Ihr Stripe-Webhook-Geheimnis

#### Seitenkonfiguration

• NEXT_PUBLIC_SITE_URL - Ihre Seiten-URL (für Produktion)
• NEXTAUTH_URL - Ihre Seiten-URL (wie oben)
• NEXTAUTH_SECRET - Ein zufälliges Geheimnis für NextAuth

Lokale Entwicklung

• Abhängigkeiten installieren:

npm install

• Richten Sie Ihre Umgebungsvariablen in .env.local ein
• Starten Sie den Entwicklungsserver:

npm run dev

• Testen Sie Stripe-Webhooks lokal mit der Stripe CLI:

stripe listen --forward-to localhost:3000/api/stripe/webhook

Produktionsbereitstellung

Vercel-Bereitstellung

• Auf Vercel bereitstellen:

npx vercel

• Umgebungsvariablen:

Fügen Sie alle Umgebungsvariablen über das Vercel-Dashboard oder die CLI hinzu

• Stripe Webhook-Einrichtung:
• Weisen Sie den Webhook auf: https://your-domain.vercel.app/api/stripe/webhook

API-Endpunkte

Die Anwendung nutzt nun diese lokalen API-Routen:

• POST /api/stripe/checkout - Erstellt Stripe-Checkout-Sitzungen
• POST /api/stripe/webhook - Verarbeitet Stripe-Webhooks

Vorteile lokaler API-Routen

• Einfachere Bereitstellung - Kein separates Deployment von Edge-Funktionen erforderlich
• Umgebungsvariablen - Standardmäßige .env-Datei-Unterstützung
• Besseres Debugging - Einfacheres Debuggen lokal möglich
• Framework-Integration - Bessere Integration mit Next.js
• Kein Vendor-Lock-in - Kann auf jeder Plattform eingesetzt werden, die Next.js unterstützt

Fehlerbehebung

• Webhook-Probleme:
• Stellen Sie sicher, dass STRIPE_WEBHOOK_SECRET mit Ihrem Stripe-Webhook-Endpunkt übereinstimmt
• Überprüfen Sie die Webhook-Protokolle im Stripe-Dashboard
• Prüfen Sie, ob die Webhook-URL korrekt ist
• Umgebungsvariablen:
• Stellen Sie sicher, dass alle erforderlichen Variablen gesetzt sind
• Überprüfen Sie Tippfehler in Variablennamen
• Prüfen Sie, ob der Supabase Service Role Key die richtigen Berechtigungen hat
• CORS-Probleme:
• Die API-Routen enthalten korrekte CORS-Header
• Stellen Sie sicher, dass Ihre Domain ggf. auf der Whitelist steht

Sicherheitshinweise

• Geben Sie niemals STRIPE_SECRET_KEY oder SUPABASE_SERVICE_ROLE_KEY an den Client weiter
• Verwenden Sie das Präfix NEXT_PUBLIC_ nur für clientseitige Variablen
• Rotieren Sie regelmäßig Ihre Webhook-Secrets
• Überwachen Sie die Zustellung der Webhooks im Stripe-Dashboard

--- Tranlated By Open Ai Tx | Last indexed: 2025-07-20 ---