Pular para o conteúdo
Começar um projetoComeçar

Analytics

Saiba o que as pessoas fazem no seu produto, e o que quebra. PostHog com eventos tipados, erros e feature flags, sem cookies por padrão.

O que ele adiciona

  • packages/analytics, construído com o PostHog. Os eventos são tipados em packages/analytics/src/events.ts, então um evento com erro de digitação faz o typecheck falhar.
  • Visualizações de página, eventos do servidor e feature flags.
  • Rastreamento de erros com stack traces legíveis: os builds fazem upload dos próprios source maps.
  • O proxy /ingest, para que os eventos passem pelo seu próprio domínio.
  • Contagem sem cookies: os visitantes que não aceitaram cookies são contados sem eles.

Como configurar

  1. Crie um projeto PostHog no US Cloud ou no EU Cloud. Defina NEXT_PUBLIC_POSTHOG_KEY com o token do projeto (phc_…) e NEXT_PUBLIC_POSTHOG_HOST com https://us.i.posthog.com ou https://eu.i.posthog.com.
  2. Nas configurações do projeto, ative o Cookieless server hash mode. Sem ele, o PostHog descarta os eventos dos visitantes que não aceitaram cookies.
  3. Opcional, para stack traces legíveis: uma chave de API pessoal com acesso de escrita ao rastreamento de erros em POSTHOG_API_KEY, e o ID do projeto em POSTHOG_PROJECT_ID.

Sem a chave, o analytics fica desligado e nada quebra.

Antes de entrar no ar

  • O Cookieless server hash mode está ativado.
  • POSTHOG_API_KEY e POSTHOG_PROJECT_ID estão definidos em produção.
  • Uma visita de teste aparece no PostHog, via /ingest.
  • A política de privacidade cita o PostHog.

Deixar de fora ou adicionar depois

Deixe analytics fora de --modules para começar sem ele. Se o Banner de consentimento também estiver ativado, o PostHog segue a escolha de cada visitante. Para adicionar o Analytics a um projeto existente, peça ao seu agente para usar o skill add-module.

Rode um comando. A CLI pergunta o resto, e o seu agente continua daí.

pnpm create turbinekit my-app
Ver o prompt

Cole em um agente que possa rodar comandos, como Claude Code, Codex ou Cursor. O prompt está em inglês.

Create a new TurbineKit project with me.
Talk to me in Brazilian Portuguese.

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.

Sem cadastro, sem chaves de API. Precisa de Node.js 24 e pnpm 10.