Zum Inhalt springen
Projekt startenStarten

Analytics

Erfahre, was Nutzer in deinem Produkt tun und was kaputtgeht. PostHog mit typisierten Events, Fehlern und Feature Flags, ohne Cookies als Standard.

Was es hinzufügt

  • packages/analytics, basierend auf PostHog. Events sind in packages/analytics/src/events.ts typisiert, also lässt ein falsch geschriebenes Event den Typecheck scheitern.
  • Seitenaufrufe, Events vom Server und Feature Flags.
  • Error-Tracking mit lesbaren Stack-Traces: Builds laden ihre Source Maps hoch.
  • Der Proxy /ingest, damit Events über deine eigene Domain laufen.
  • Zählung ohne Cookies: Besucher, die keine Cookies akzeptiert haben, werden ohne sie gezählt.

Einrichten

  1. Lege ein PostHog-Projekt in der US- oder EU-Cloud an. Setze NEXT_PUBLIC_POSTHOG_KEY auf das Projekt-Token (phc_…) und NEXT_PUBLIC_POSTHOG_HOST auf https://us.i.posthog.com oder https://eu.i.posthog.com.
  2. Schalte in den Projekteinstellungen Cookieless server hash mode ein. Ohne diese Einstellung verwirft PostHog die Events von Besuchern, die keine Cookies akzeptiert haben.
  3. Optional, für lesbare Stack-Traces: ein persönlicher API-Key mit Schreibrecht für Error-Tracking in POSTHOG_API_KEY und die Projekt-ID in POSTHOG_PROJECT_ID.

Ohne den Key ist Analytics aus, und nichts geht kaputt.

Vor dem Livegang

  • Cookieless server hash mode ist an.
  • POSTHOG_API_KEY und POSTHOG_PROJECT_ID sind in Produktion gesetzt.
  • Ein Testbesuch erscheint in PostHog, über /ingest.
  • Die Datenschutzerklärung nennt PostHog.

Weglassen oder später hinzufügen

Lass analytics in --modules weg, um ohne Analytics zu starten. Ist auch das Consent-Banner an, folgt PostHog der Wahl jedes Besuchers. Um Analytics zu einem bestehenden Projekt hinzuzufügen, bitte deinen Agent, den Skill add-module zu nutzen.

Starte einen Befehl. Die CLI fragt den Rest, und dein Agent macht von dort aus weiter.

pnpm create turbinekit my-app
Prompt ansehen

Füge ihn in einen Agent ein, der Befehle ausführen kann, etwa Claude Code, Codex oder Cursor. Der Prompt ist auf Englisch.

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

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.

Keine Anmeldung, keine API-Keys. Braucht Node.js 24 und pnpm 10.