About this project

This repository powers the entire PostHog website, treated as a product. It includes all written content (product features, manuals, docs, blogs, case studies, tutorials, and the company handbook), plus interactive features such as a Q&A system (Squeak!), job listings (via Ashby), a pricing calculator, roadmap, API docs, and more. The codebase contains all components, templates, logic, and styling. ## Quick Start 1. **Pre-installation**: Install Node (version 22) and pnpm (via `corepack use pnpm@latest-10`). 2. **Start developing**: Clone the repo, install dependencies with `pnpm install`, and run `pnpm start`. The site runs at `http://localhost:8001`. For Apple Silicon Macs, additional steps include removing `node_modules` and installing `vips` via Homebrew. 3. **Edit and preview**: Use the Gatsby GraphQL tool at `http://localhost:8001/___graphql` for data queries. ## Advanced Setup - **Debugging errors**: Pull latest changes, clean cache, and ensure no conflicting flox environments. - **API docs**: Override the API schema URL with `POSTHOG_OPEN_API_SPEC_URL` to use a local PostHog instance. - **Ashby job listings and GitHub contributors**: Requires private environment variables. - **Posts section**: Visit `/posts` directly to see local version. - **Cloudflare PR previews**: Built with `GATSBY_MINIMAL=true`; listing pages may not be generated. - **Merch store**: Requires Shopify environment variables (`SHOPIFY_APP_PASSWORD`, `GATSBY_MYSHOPIFY_URL`, `GATSBY_SHOPIFY_STOREFRONT_TOKEN`). - **Dynamic open graph images**: Build with `ASHBY_API_KEY` and `GITHUB_API_KEY`, and temporarily comment out a line in `gatsby/onPostBuild.ts` to generate images locally. ## Contributing Contributions are welcome. Priority order: ask questions in the community, submit bug reports/feedback, vote on features, open PRs, or open issues/content ideas. Detailed instructions are available in the handbook and the `AGENTS.md` file.