CineLoop
Il tuo hub personale e sociale per film, serie e anime. Tieni traccia di cosa guardi, scopri cosa vedere stasera, confronta i gusti con gli amici e lascia che la ruota scelga il film della serata.
CineLoop non è una piattaforma di streaming: non riproduce contenuti e non accede ai tuoi account. Ti riporta al servizio dove stai guardando.
Avvio rapido
npm install
npm run dev
Apri http://localhost:3000 e premi Entra con l'account demo (oppure [email protected] / cineloop-demo).
Senza configurazione l'app usa dati demo in memoria: libreria, amici, attività e statistiche sono generati rispetto a oggi, quindi "questa settimana" ha sempre dati.
Con PostgreSQL
cp .env.example .env.local # imposta DATABASE_URL
npm run db:migrate # applica le migrazioni in ./drizzle
npm run db:seed # catalogo + persone demo (--reset per ripartire da zero)
npm run dev
Con DATABASE_URL impostato l'app usa PostgreSQL. Anche npm run build applica le migrazioni e carica il catalogo di base, quindi un deploy (es. Vercel con Neon) crea da solo tabelle e titoli: basta impostare DATABASE_URL. In questa modalità il pulsante dell'account demo non compare: accedi con le credenziali sopra.
Catalogo TMDB (opzionale)
Imposta TMDB_READ_TOKEN (il "token di accesso in lettura" API di TMDB). Senza, Esplora e la ricerca usano il piccolo catalogo demo; con TMDB hai tutto il catalogo: ricerca, filtri per genere e tipo, tendenze e consigli "Per te" basati sui titoli che hai votato. I titoli trovati vengono salvati in cache, così si possono aggiungere alle liste. Quando è attivo, l'app mostra l'attribuzione richiesta da TMDB.
Estensione browser
extension/ contiene l'estensione per Chrome e browser simili: aggiorna la libreria mentre guardi Netflix, AnimeUnity o StreamingCommunity quando la pagina espone titolo e progresso, mostra agli amici cosa stai guardando e permette loro di unirsi. npm run build la impacchetta in public/cineloop-extension.zip, scaricabile da Impostazioni. Dettagli e garanzie su cosa legge in docs/browser-extension.md.
Script
| Comando | Cosa fa |
|---|
npm run dev | Server di sviluppo |
npm run build / npm start | Build e avvio in produzione |
npm run lint / npm run typecheck | ESLint e TypeScript strict |
npm test | Test unitari e di componente (Vitest) |
npm run test:e2e | Test end-to-end e accessibilità (Playwright + axe) |
npm run db:generate | Genera una migrazione dallo schema Drizzle |
npm run db:migrate / npm run db:seed | Migrazioni e dati demo |
Per i test E2E con un Chromium già installato: PLAYWRIGHT_CHROMIUM_PATH=/percorso/chrome npm run test:e2e.
Sezioni
- Home: ora in visione, continua a guardare, cosa fanno gli amici, la tua settimana, da vedere stasera.
- Libreria: tutto quello che hai visto o stai seguendo, con filtri, voti a mezze stelle e stato.
- Wishlist: la tua coda in ordine di priorità, riordinabile anche da tastiera.
- Classifiche: i tuoi preferiti per tipo e cosa mette d'accordo gli amici.
- Amici: attività, compatibilità dei gusti, titoli in comune.
- Serate insieme: scegli chi c'è, CineLoop trova i titoli compatibili, la ruota decide.
- Profilo e Impostazioni: statistiche, privacy, notifiche, servizi che usi, riduzione delle animazioni.
Stack
Next.js 16 (App Router), React 19, TypeScript strict, Tailwind CSS 4, Motion, PostgreSQL con Drizzle, zod, Vitest, Playwright con axe. Nessuna libreria di componenti UI.
Documentazione
Limiti noti
- Nessun provider sincronizza automaticamente: "Continua su…" apre il servizio, ma l'avanzamento nelle serie viene per ora dai dati demo.
- Anime Unity e Streaming Community rilevano il titolo e il progresso tramite l’estensione quando la pagina espone queste informazioni (vedi docs/providers.md).
- Il tema è solo scuro.
Deploy
Il deploy di produzione è gestito dall'integrazione GitHub di Vercel: i commit pubblicati su main devono avviare automaticamente una nuova distribuzione. Verificare in Vercel che il deployment risulti READY e punti al commit atteso.
