Saltar al contenido
Empezar un proyectoEmpezar

Analítica

Conoce lo que hace la gente en tu producto, y lo que se rompe. PostHog con eventos tipados, errores y feature flags, sin cookies por defecto.

Qué agrega

  • packages/analytics, basado en PostHog. Los eventos están tipados en packages/analytics/src/events.ts, así que un evento mal escrito hace fallar el typecheck.
  • Páginas vistas, eventos desde el servidor y feature flags.
  • Seguimiento de errores con stack traces legibles: los builds suben sus source maps.
  • El proxy /ingest, para que los eventos pasen por tu propio dominio.
  • Conteo sin cookies: los visitantes que no aceptaron las cookies se cuentan sin ellas.

Configurarlo

  1. Crea un proyecto de PostHog en US Cloud o EU Cloud. Define NEXT_PUBLIC_POSTHOG_KEY con el token del proyecto (phc_…) y NEXT_PUBLIC_POSTHOG_HOST con https://us.i.posthog.com o https://eu.i.posthog.com.
  2. En la configuración del proyecto, activa Cookieless server hash mode. Sin él, PostHog descarta los eventos de los visitantes que no aceptaron las cookies.
  3. Opcional, para stack traces legibles: una clave de API personal con permiso de escritura sobre el seguimiento de errores en POSTHOG_API_KEY, y el ID del proyecto en POSTHOG_PROJECT_ID.

Sin la clave, la analítica queda apagada y nada se rompe.

Antes del lanzamiento

  • Cookieless server hash mode está activado.
  • POSTHOG_API_KEY y POSTHOG_PROJECT_ID están definidas en producción.
  • Una visita de prueba aparece en PostHog, a través de /ingest.
  • La política de privacidad nombra a PostHog.

Dejarlo fuera o agregarlo después

Deja analytics fuera de --modules para empezar sin analítica. Con el Banner de consentimiento también activado, PostHog sigue la elección de cada visitante. Para agregar Analítica a un proyecto existente, pide a tu agente que use el skill add-module.

Ejecuta un comando. La CLI pregunta lo demás, y tu agente sigue desde ahí.

pnpm create turbinekit my-app
Ver el prompt

Pégalo en un agente que pueda ejecutar comandos, como Claude Code, Codex o Cursor. El prompt está en inglés.

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

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.

Sin registro, sin claves de API. Necesita Node.js 24 y pnpm 10.