Skip to content
Skills Library
Programming · Tool integration

installing-posthog-in-a-codebase

/installing-posthog-in-a-codebase

Install and configure a PostHog SDK in a repository you can read and edit, following PostHog's docs for the framework. Use when a user working in their codebase asks to add, install, or set up PostHog, product analytics, session replay, or a PostHog SDK. Covers finding the right docs page, installing the latest package, getting the project token and ingestion host from project-get, keeping them in the env file, server-side setup, identifying users, and verifying the change. If you can't access the user's code, as is common in ChatGPT on the web or Claude on the web, use installing-posthog-from

Repository
skills ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
28
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Install and configure a PostHog SDK in a repository you can read and edit, following PostHog's docs for the framework. Use when a user working in their codebase asks to add, install, or set up PostHog, product analytics, session replay, or a PostHog SDK. Covers finding the right docs page, installing the latest package, getting the project token and ingestion host from project-get, keeping them in the env file, server-side setup, identifying users, and verifying the change. If you can't access the user's code, as is common in ChatGPT on the web or Claude on the web, use installing-posthog-from

Triggers from the description

t access the user
Original author description

Install and configure a PostHog SDK in a repository you can read and edit, following PostHog's docs for the framework. Use when a user working in their codebase asks to add, install, or set up PostHog, product analytics, session replay, or a PostHog SDK. Covers finding the right docs page, installing the latest package, getting the project token and ingestion host from project-get, keeping them in the env file, server-side setup, identifying users, and verifying the change. If you can't access the user's code, as is common in ChatGPT on the web or Claude on the web, use installing-posthog-from

How it works

  1. 1. Find the framework and read its docs
  2. 2. Install the latest SDK
  3. 3. Get the token and host
  4. 4. Initialize as the docs show
  5. 5. Identify users
  6. 6. Verify
Original SKILL.md headings · 84 lines, 739 words
SKILL.md preview
---
name: installing-posthog-in-a-codebase
description: >-
  Install and configure a PostHog SDK in a repository you can read and edit, following PostHog's docs for
  the framework. Use when a user working in their codebase asks to add, install, or set up PostHog, product
  analytics, session replay, or a PostHog SDK. Covers finding the right docs page, installing the latest
  package, getting the project token and ingestion host from project-get, keeping them in the env file,
  server-side setup, identifying users, and verifying the change. If you can't access the user's code, as is
  common in ChatGPT on the web or Claude on the web, use installing-posthog-from-chat instead.
---

# Installing PostHog in a codebase

Use this skill when you can read and edit the user's code.
If you can't access their code, as is common in ChatGPT on the web or Claude on the web, use `installing-posthog-from-chat`.

PostHog's docs are the source of truth for each SDK's setup.
Init options, file locations and recommended settings change between SDK releases, so read the docs page for the framework before you write code, and follow it rather than what you remember.

## 1. Find the framework and read its docs

Detect the framework from the manifest files (`package.json`, `pyproject.toml`, `requirements.txt`, `Gemfile`, `composer.json`, `go.mod`, and so on) and the app's entry points.
A web app with its own backend usually needs a client SDK and a server SDK, so read both pages.

| Framework                      | Docs page                                            |
| ------------------------------ | ---------------------------------------------------- |
| JavaScript web (any framework) | https://posthog.com/docs/libraries/js.md             |
| React, including Vite apps     | https://posthog.com/docs/libraries/react.md          |
| Next.js                        | https://posthog.com/docs/libraries/next-js.md        |
| Vue.js                         | https://posthog.com/docs/libraries/vue-js.md         |
| Nuxt                           | https://posthog.com/docs/libraries/nuxt-js.md        |
| Svelte and SvelteKit           | https://posthog.com/docs/libraries/svelte.md         |
| Angular                        | https://posthog.com/docs/libraries/angular.md        |
| Astro                          | https://posthog.com/docs/libraries/astro.md          |
| Remix                          | https://posthog.com/docs/libraries/remix.md          |
| React Router                   | https://posthog.com/docs/libraries/react-router.md   |
| TanStack Start                 | https://posthog.com/docs/libraries/tanstack-start.md |
| Node.js, including Express     | https://posthog.com/docs/libraries/node.md           |
| Python, including FastAPI      | https://posthog.com/docs/libraries/python.md         |
| Django                         | https://posthog.com/docs/libraries/django.md         |
| Flask                          | https://posthog.com/docs/libraries/flask.md          |
| Ruby                           | https://posthog.com/docs/libraries/ruby.md           |
| Ruby on Rails                  | https://posthog.com/docs/libraries/ruby-on-rails.md  |
| PHP                            | https://posthog.com/docs/libraries/php.md            |
| Laravel                        | https://posthog.com/docs/libraries/laravel.md        |
| Go                             | https://posthog.com/docs/libraries/go.md             |
| Java                           | https://posthog.com/docs/libraries/java.md           |
| .NET                           | https://posthog.com/docs/libraries/dotnet.md         |
| Elixir                         | https://posthog.com/docs/libraries/elixir.md         |
| Rust                           | https://posthog.com/docs/libraries/rust.md           |
| React Native                   | https://posthog.com/docs/libraries/react-native.md   |
| Flutter                        | https://posthog.com/docs/libraries/flutter.md        |
| iOS                            | https://posthog.com/docs/libraries/ios.md            |
| Android                        | https://posthog.com/docs/libraries/android.md        |

For a framework that isn't listed, call `docs-search` with the framework name.

## 2. Install the latest SDK

Add each package with the project's own package manager and no version, for example `npm install posthog-js`, `pnpm add posthog-node`, `uv add posthog` or `bundle add posthog-ruby`.
That resolves the newest release.
Don't type a version into the manifest from memory, because that pins an old release.

In a monorepo, install into the package that runs the app, not the workspace root.

## 3. Get the token and host

Call `project-get` without an ID.
Use `api_token` as the project token and `api_host` as the SDK's host option.

- Read both from environment variables in code, using the names the docs page uses (for example `NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN` and `NEXT_PUBLIC_POSTHOG_HOST`).
- Write the real values to the env file the framework loads, such as `.env.local` or `.env`. If the project has an example env file, add the variable names there with empty values.
- Never hard-code the token or the host in source files, and never use them as fallback defaults in code.

## 4. Initialize as the docs show

- Initialize the SDK once, in the place the docs page names. Don't add a second initialization elsewhere.
- For `posthog-js`, set `defaults` to the date the docs page shows. It selects the newest set of recommended settings, so don't take a date from memory.
- For a backend SDK in a long-running server, create one client for the process, reuse it, and shut it down when the process exits. Don't create a client per request.
- In serverless or edge handlers (for example Next.js route handlers on Vercel, or AWS Lambda), the runtime can freeze as soon as the response is sent, so queued events are lost. Flush before the handler returns: await `flush()` on a reused client, or use the platform's `waitUntil`, as the docs page describes.
- For a server-rendered app (Django, Rails, Laravel and similar), add the server SDK as well as the browser snippet.

## 5. Identify users

If the app has login, call `identify` after login with a stable user ID from the auth system, such as the database ID, not an email address or display name.
Call `reset()` on logout.
Send server-side events with the same distinct ID, so client and server events land on the same person.

## 6. Verify

Run the project's build, type check or tests, and fix anything your change broke.
If you can run the app, load a page and check that events arrive with `read-data-schema` or `execute-sql`.
Tell the user which environment variables to add in their hosting provider before they deploy.

Versions

RepositoryScoreLicence
This page · PostHog/skills100MIT
posthog/posthog100MIT

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 9aa7fe1420e8 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100posthog-install-auth
    Install an official PostHog SDK and configure the correct project token, regional host, and server-only credentials. Use when bootstrapping or repairing SDK authentication. Trigger with "install PostHog", "configure PostHog", or "PostHog API key".
  • 100posthog-install-auth
    Install and configure PostHog SDK/CLI authentication. Use when setting up a new PostHog integration, configuring API keys, or initializing PostHog in your project. Trigger with phrases like "install posthog", "setup posthog", "posthog auth", "configure posthog API key".
  • 91migrate-posthog
    Migrate feature flags from PostHog to Confidence SDK. Use when the user says /migrate-posthog, asks to migrate PostHog flags, or transform SDK code to Confidence.
  • 100posthog-common-errors
    Diagnose PostHog ingestion, identity, feature-flag, SDK, and private-API failures from concrete evidence. Use when events are missing, flags return unexpected values, or PostHog requests fail. Trigger with "debug PostHog", "PostHog events missing", or "PostHog 401".
  • 100posthog-sdk-patterns
    Apply production-ready PostHog SDK patterns for TypeScript and Python. Use when implementing PostHog integrations, refactoring SDK usage, or establishing team coding standards for PostHog. Trigger with phrases like "posthog SDK patterns", "posthog best practices", "posthog code…
  • 100instrument-integration
    Add PostHog SDK integration to your application. Use when setting up PostHog for the first time or reviewing PRs that need PostHog initialization. Covers SDK installation, provider setup, and basic configuration for any framework.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.