Alternativa open-source e leggera a Trello, progettata per makers e indie hacker.

Focus su semplicità, velocità e scalabilità. Realizzato con uno stack moderno: Tailwind CSS, shadcn/ui, Supabase, integrazione Stripe. Supporta progetti illimitati, collaborazione in team, modalità scura/chiara ed esperienza utente fluida. Perfetto per sviluppatori singoli e piccoli team che vogliono il pieno controllo senza complessità inutili.

🌟 Se trovi utile questo progetto, considera di lasciargli una stella! Aiuta anche altri a scoprirlo.

Guida al Deployment

Panoramica

Questa applicazione ora utilizza le route API locali di Next.js invece delle Edge Functions di Supabase per l'integrazione con Stripe. Questo rende il deployment più semplice e ti permette di usare i file .env standard per la configurazione.

Configurazione delle variabili d'ambiente

1. Crea il file .env.local

Copia .env.example in .env.local e inserisci i tuoi valori reali:

cp .env.example .env.local

2. Variabili d'Ambiente Richieste

#### Configurazione Supabase

• NEXT_PUBLIC_SUPABASE_URL - L'URL del tuo progetto Supabase
• NEXT_PUBLIC_SUPABASE_ANON_KEY - La tua chiave anonima Supabase
• SUPABASE_SERVICE_ROLE_KEY - La tua chiave di ruolo di servizio Supabase (solo lato server)

#### Configurazione Stripe (opzionale)

• STRIPE_SECRET_KEY - La tua chiave segreta Stripe (solo lato server)
• NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY - La tua chiave pubblicabile Stripe
• STRIPE_WEBHOOK_SECRET - Il tuo segreto webhook Stripe

#### Configurazione Sito

• NEXT_PUBLIC_SITE_URL - L'URL del tuo sito (per la produzione)
• NEXTAUTH_URL - L'URL del tuo sito (uguale a sopra)
• NEXTAUTH_SECRET - Un segreto casuale per NextAuth

Sviluppo Locale

• Installa le dipendenze:

npm install

• Configura le variabili d'ambiente in .env.local
• Avvia il server di sviluppo:

npm run dev

• Testa i webhook di Stripe localmente utilizzando Stripe CLI:

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

Distribuzione in Produzione

Distribuzione su Vercel

• Distribuisci su Vercel:

npx vercel

• Variabili d'Ambiente:

Aggiungi tutte le variabili d'ambiente tramite la dashboard di Vercel o CLI

• Configurazione Webhook Stripe:
• Punta il webhook a: https://your-domain.vercel.app/api/stripe/webhook

Endpoint API

L'applicazione ora utilizza queste rotte API locali:

• POST /api/stripe/checkout - Crea sessioni di checkout Stripe
• POST /api/stripe/webhook - Gestisce eventi webhook Stripe

Vantaggi delle Rotte API Locali

• Deployment più semplice - Nessuna necessità di distribuire funzioni edge separate
• Variabili d'Ambiente - Supporto standard per file .env
• Debug Migliorato - Più facile da fare debug in locale
• Integrazione Framework - Migliore integrazione con Next.js
• Nessun Vendor Lock-in - Può essere distribuito su qualsiasi piattaforma che supporta Next.js

Risoluzione dei Problemi

• Problemi con i Webhook:
• Assicurati che STRIPE_WEBHOOK_SECRET corrisponda al tuo endpoint webhook di Stripe
• Controlla i log dei webhook nella dashboard di Stripe
• Verifica che l’URL del webhook sia corretto
• Variabili d'Ambiente:
• Assicurati che tutte le variabili richieste siano impostate
• Controlla la presenza di errori nei nomi delle variabili
• Verifica che la chiave service role di Supabase abbia i permessi corretti
• Problemi CORS:
• Le rotte API includono gli header CORS corretti
• Assicurati che il tuo dominio sia inserito nella whitelist se necessario

Note di Sicurezza

• Non esporre mai STRIPE_SECRET_KEY o SUPABASE_SERVICE_ROLE_KEY al client
• Usa il prefisso NEXT_PUBLIC_ solo per variabili lato client
• Ruota regolarmente i tuoi segreti webhook
• Monitora la consegna dei webhook nella dashboard di Stripe

--- Tranlated By Open Ai Tx | Last indexed: 2025-08-01 ---