:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
title: Project structure sidebar: Docs showTitle: true
Note: This page refers to our main product repository, not our website.
Directory tree
.
├── bin # Shell scripts wrapped by hogli, the unified developer CLI
├── common # Shared code: PostHog SQL parser, HogVM, shared UI packages
├── tools # Developer/CI tooling (hogli framework, hogli-commands, openapi-codegen, ...)
├── ee # Enterprise platform package features (separate license)
├── frontend # React/TypeScript frontend application
│ └── src
│ └── layout # App layout components (navigation, sidebars)
│ └── lib # Reusable components and utilities
│ └── scenes # Page-specific components
│ └── queries # Query builder components
│ └── toolbar # PostHog Toolbar code
├── livestream # Golang service for live events API
├── playwright # End-to-end tests using Playwright
├── nodejs # Node.js service for event ingestion and plugins
├── posthog # Django backend application
│ └── api # REST API endpoints
│ └── clickhouse # ClickHouse database interactions
│ └── hogql # HogQL query language implementation
│ └── models # Django ORM models
│ └── tasks # Celery background tasks
├── products # Product-specific code (vertical slices)
└── rust # High-performance Rust services
*Selected subdirectories only
Key directories
frontend
The PostHog web application, built with React and TypeScript. Uses Kea for state management.
src/lib– Reusable components and utilitiessrc/scenes– Page-specific components organized by featuresrc/queries– Query builder and data visualization componentssrc/toolbar– Code for the PostHog Toolbar
posthog
The Django backend application. Key subdirectories:
api– REST API endpoints and serializersclickhouse– ClickHouse schema definitions and migrationshogql– PostHog SQL query language compiler and executormodels– Django ORM models (PostgreSQL)tasks– Celery background tasks
products
Product-specific code organized as vertical slices. Each product folder contains its own backend (Django app), frontend (React), and optionally shared code. This structure allows features to evolve independently.
See the products README for detailed conventions.
nodejs
Node.js service responsible for:
- Event ingestion and processing
- Running plugins and data pipelines
- Webhook delivery
rust
High-performance Rust services including:
capture– Event capture endpointfeature-flags– Feature flag evaluationcymbal– Error tracking symbolication- Various workers and utilities
common
Shared code used across the codebase:
hogql_parser– PostHog SQL parser (C++)hogvm– Hog virtual machinetailwind– Shared Tailwind configuration
tools
Developer and CI tooling, not imported by runtime code:
hogli– Developer CLI framework (PyPI-publishable)hogli-commands– PostHog-specific hogli commandsopenapi-codegen– OpenAPI client/spec generation- (and others — see
tools/)
ee
Enterprise edition licensed features. This directory has a separate license - not MIT. For 100% FOSS code, see PostHog/posthog-foss.
playwright
End-to-end tests using Playwright. Tests live in the e2e/ subdirectory.
livestream
Golang service powering the live events feed in the Activity tab.