Skip to content

feat(web): update PostHog connection guide#62

Merged
siisee11 merged 4 commits intomainfrom
feat/posthog-connection-guide
Apr 10, 2026
Merged

feat(web): update PostHog connection guide#62
siisee11 merged 4 commits intomainfrom
feat/posthog-connection-guide

Conversation

@siisee11
Copy link
Copy Markdown
Contributor

@siisee11 siisee11 commented Apr 9, 2026

One-Line Summary

Refresh the PostHog connection guide so users can find the right project settings, host URL, and personal API key fields without guessing.

User-Facing Changes

  • The PostHog guide in the data source connection dialog now walks through Settings -> Project -> General before asking for credentials.
  • The guide now explains that the Host URL should be the PostHog app origin like https://us.posthog.com or https://eu.posthog.com, not the SDK api_host collection endpoint.
  • The guide now includes screenshot-backed steps for opening Personal API keys and creating a read-scoped key.

Why This Changed

The previous PostHog guide described the required values at a high level, but it did not map them to the current PostHog UI. That left users to infer where Project ID, Host URL, and Personal API key values actually live, and it made it easy to paste the wrong host from the SDK snippet.

How It Changed

  • Updated the localized PostHog guide content in apps/web/src/features/data-sources/data-source-connection-guide-dialog.tsx to match the current PostHog settings flow.
  • Split the old generic key step into separate steps for opening Personal API keys and creating a read-scoped key.
  • Added three new PostHog screenshots under apps/web/public/images/posthog/ so the new steps render with visual references.

Verification

  • bun run format
  • bun lint --format json apps/web/src/features/data-sources/data-source-connection-guide-dialog.tsx

Video / Screenshot (Optional)

  • N/A

@siisee11 siisee11 requested a review from lentil32 as a code owner April 9, 2026 02:02
@siisee11 siisee11 enabled auto-merge (squash) April 9, 2026 02:11
@siisee11 siisee11 disabled auto-merge April 9, 2026 02:18
@siisee11 siisee11 enabled auto-merge (squash) April 9, 2026 02:21
@siisee11 siisee11 merged commit 7a0dd04 into main Apr 10, 2026
6 checks passed
@siisee11 siisee11 deleted the feat/posthog-connection-guide branch April 10, 2026 04:56
lentil32 added a commit that referenced this pull request Apr 10, 2026
You can install any of these versions: `npm install -g @onequery/cli@<version>`
## [0.1.22] - 2026-04-10
### 🚀 Features

- *(web)* Update PostHog connection guide (#62)
- Prepare landing deployment on cloudflare pages (#66)
- Readme self host priority (#67)
- *(cli)* Cut over use to source API (#65)
<!-- generated - do not edit -->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants