Aller au contenu
Démarrer un projetDémarrer

Analytics

Sachez ce que les gens font dans votre produit, et ce qui casse. PostHog avec des événements typés, les erreurs et les feature flags, sans cookies par défaut.

Ce qu’il ajoute

  • packages/analytics, construit sur PostHog. Les événements sont typés dans packages/analytics/src/events.ts : un événement mal orthographié fait échouer le typecheck.
  • Les pages vues, les événements côté serveur et les feature flags.
  • Le suivi des erreurs avec des stack traces lisibles : les builds envoient leurs source maps.
  • Le proxy /ingest, pour que les événements passent par votre propre domaine.
  • Un comptage sans cookies : les visiteurs qui n’ont pas accepté les cookies sont comptés sans eux.

L’installer

  1. Créez un projet PostHog sur US Cloud ou EU Cloud. Mettez le token du projet (phc_…) dans NEXT_PUBLIC_POSTHOG_KEY, et https://us.i.posthog.com ou https://eu.i.posthog.com dans NEXT_PUBLIC_POSTHOG_HOST.
  2. Dans les réglages du projet, activez Cookieless server hash mode. Sans lui, PostHog écarte les événements des visiteurs qui n’ont pas accepté les cookies.
  3. Facultatif, pour des stack traces lisibles : une clé d’API personnelle avec le droit d’écriture sur le suivi des erreurs dans POSTHOG_API_KEY, et l’id du projet dans POSTHOG_PROJECT_ID.

Sans la clé, l’analytics est désactivé et rien ne casse.

Avant la mise en ligne

  • Cookieless server hash mode est activé.
  • POSTHOG_API_KEY et POSTHOG_PROJECT_ID sont définis en production.
  • Une visite de test apparaît dans PostHog, via /ingest.
  • La politique de confidentialité nomme PostHog.

L’écarter ou l’ajouter plus tard

Retirez analytics de --modules pour démarrer sans. Si le bandeau de consentement est là aussi, PostHog suit le choix de chaque visiteur. Pour ajouter l’analytics à un projet existant, demandez à votre agent d’utiliser le skill add-module.

Lancez une commande. La CLI pose les autres questions, et votre agent prend la suite.

pnpm create turbinekit my-app
Voir le prompt

Collez-le dans un agent qui peut lancer des commandes, comme Claude Code, Codex ou Cursor. Le prompt est en anglais.

Create a new TurbineKit project with me.
Talk to me in French.

TurbineKit (https://turbinekit.dev) is an open-source Turborepo and Next.js starter. Its CLI, create-turbinekit, needs Node.js 24 and pnpm 10 (run `corepack enable` once).

1. Run `pnpm dlx create-turbinekit --help` to see its options.
2. Ask me its questions one at a time, with their defaults: the folder, the product name, one sentence about the product, the company or legal name, the contact email, the languages and the modules. Skip what I have already told you.
3. The CLI only asks questions in an interactive terminal, so run it with my answers as options and `--yes`. Show me the command before you run it.
4. In the new folder, read AGENTS.md. Then do "1. Minimal setup" in SETUP.md, and tick each box you finish.
5. Tell me the URL of the running app, and which services SETUP.md lists next.

Sans inscription, sans clé d'API. Il faut Node.js 24 et pnpm 10.