Ecco il repository di esempi di Katla
Sei progetti di esempio pronti all’uso che mostrano come integrare il consenso ai cookie di Katla con Next.js, Vite e HTML puro.
Abbiamo appena pubblicato katla-app/examples, una raccolta di sei progetti di partenza che mostrano come integrare il consenso ai cookie di Katla in app reali. Ogni esempio è autonomo, gira in locale e copre un diverso schema di integrazione.
Perché gli esempi
La documentazione spiega l’API. Gli esempi mostrano come i pezzi si incastrano. Che tu stia aggiungendo un widget di consenso a un sito di marketing o costruendo un’interfaccia di consenso personalizzata in un’app React, questi progetti ti danno un punto di partenza funzionante da adattare.
Cosa c’è dentro
Widget
Un sito multipagina con Vite che carica il widget ospitato di Katla tramite un tag script e incorpora la pagina della cookie policy in un iframe. Niente SDK, niente framework: solo HTML e la CDN.
Ideale per: siti statici, pagine generate da un CMS, o ovunque tu voglia il consenso senza una fase di build.
Vedi l’esempio · Documentazione del widget
Next.js: SSR dinamico
Un progetto Next.js 16 con App Router che usa getCachedCookies da @katla.app/sdk/next/server per recuperare i cookie sul server. Il client riceve i dati già caricati, senza richieste di rete aggiuntive.
Ideale per: app Next.js renderizzate sul server che vogliono dati dei cookie aggiornati a ogni richiesta.
Vedi l’esempio · Documentazione Next.js
Next.js: statico in fase di build
Un progetto Next.js 16 con App Router che esegue katla pull in fase di build. I dati dei cookie e lo script del blocco dei cookie vengono inclusi come asset statici: zero fetch a runtime.
Ideale per: siti Next.js esportati staticamente, o quando vuoi il caricamento più veloce possibile.
Vedi l’esempio · Documentazione sui cookie statici
Vite + React: fetch dinamico
Un’app Vite 7 + React 19 che recupera i dati dei cookie e della policy a runtime con gli hook dell’SDK. Include i componenti CookieBanner e CookieCatalog.
Ideale per: SPA che vogliono sempre i dati dei cookie più recenti dalla CDN.
Vedi l’esempio · Documentazione React
Vite + React: statico in fase di build
Un’app Vite 7 + React 19 che usa katla pull per recuperare i dati dei cookie in fase di build. Il JSON viene importato direttamente: nessun fetch a runtime.
Ideale per: SPA con una pipeline di build che vogliono eliminare le richieste lato client.
Vedi l’esempio · Documentazione sui cookie statici
Vite + React: interfaccia di consenso personalizzata
Un’app Vite 7 + React 19 che usa l’hook useConsentManager per costruire un’interfaccia di consenso completamente personalizzata. Nessun componente banner già pronto: solo il tuo markup e la tua logica.
Ideale per: team che vogliono il pieno controllo sull’esperienza di consenso e vogliono allinearla al proprio design system.
Vedi l’esempio · Documentazione di useConsentManager
Come iniziare
Tutti gli esempi seguono la stessa configurazione:
git clone https://github.com/katla-app/examples.git
cd examples/<project>
npm installSostituisci il site ID segnaposto con il tuo (da katla.app), poi avvia il server di sviluppo. Il README di ogni progetto contiene i dettagli specifici.
Esplora il repository
Sfoglia tutti e sei gli esempi su GitHub: katla-app/examples