Découvrez le dépôt d’exemples Katla

Nous venons de publier katla-app/examples, une collection de six projets de démarrage qui montrent comment intégrer le consentement aux cookies Katla dans de vraies applications. Chaque exemple est autonome, tourne en local et illustre un mode d’intégration différent.

Pourquoi des exemples

La documentation explique l’API. Les exemples montrent comment les pièces s’assemblent. Que vous ajoutiez un widget de consentement à un site marketing ou que vous construisiez une interface de consentement sur mesure dans une app React, ces projets vous donnent un point de départ fonctionnel, à adapter.

Ce que contient le dépôt

Widget

Un site Vite multipage qui charge le widget Katla hébergé via une balise script et intègre la page de politique de cookies dans une iframe. Pas de SDK, pas de framework : juste du HTML et le CDN.

Idéal pour : les sites statiques, les pages rendues par un CMS, ou partout où vous voulez le consentement sans étape de build.

Voir l’exemple · Documentation du widget

Next.js : SSR dynamique

Un projet Next.js 16 App Router qui utilise getCachedCookies de @katla.app/sdk/next/server pour récupérer les cookies côté serveur. Le client reçoit des données préchargées, sans requête réseau supplémentaire.

Idéal pour : les apps Next.js rendues côté serveur qui veulent des données de cookies fraîches à chaque requête.

Voir l’exemple · Documentation Next.js

Next.js : statique, au moment du build

Un projet Next.js 16 App Router qui lance katla pull au moment du build. Les données des cookies et le script du bloqueur de cookies sont intégrés comme ressources statiques : zéro fetch à l’exécution.

Idéal pour : les sites Next.js exportés en statique, ou quand vous voulez le chargement le plus rapide possible.

Voir l’exemple · Documentation des cookies statiques

Vite + React : récupération dynamique

Une app Vite 7 + React 19 qui récupère les données des cookies et de la politique à l’exécution grâce aux hooks du SDK. Inclut les composants CookieBanner et CookieCatalog.

Idéal pour : les SPA qui veulent toujours les dernières données de cookies depuis le CDN.

Voir l’exemple · Documentation React

Vite + React : statique, au moment du build

Une app Vite 7 + React 19 qui utilise katla pull pour récupérer les données des cookies au moment du build. Le JSON est importé directement : aucun fetch à l’exécution.

Idéal pour : les SPA dotées d’un pipeline de build qui veulent supprimer les requêtes côté client.

Voir l’exemple · Documentation des cookies statiques

Vite + React : interface de consentement sur mesure

Une app Vite 7 + React 19 qui utilise le hook useConsentManager pour construire une interface de consentement entièrement personnalisée. Aucun composant de bannière tout fait : uniquement votre propre balisage et votre propre logique.

Idéal pour : les équipes qui ont besoin d’un contrôle total sur l’expérience de consentement et veulent l’aligner sur leur design system.

Voir l’exemple · Documentation de useConsentManager

Bien démarrer

Chaque exemple s’installe de la même façon :

git clone https://github.com/katla-app/examples.git
cd examples/<project>
npm install

Remplacez le Site ID d’exemple par le vôtre (depuis katla.app), puis lancez le serveur de développement. Le README de chaque projet donne les détails.

Explorer le dépôt

Parcourez les six exemples sur GitHub : katla-app/examples