Skip to content

docs: update sign up instructions#3

Merged
robert-moore merged 3 commits into
mainfrom
rob/sdk-readme-intent-cta
May 8, 2026
Merged

docs: update sign up instructions#3
robert-moore merged 3 commits into
mainfrom
rob/sdk-readme-intent-cta

Conversation

@robert-moore
Copy link
Copy Markdown
Contributor

@robert-moore robert-moore commented May 8, 2026

Summary

Improve sign up instruction for free Churnkey analytics account

The web app's /register page silently captures `?intent=sdk` from the
URL and routes the user to /install/sdk after signup, skipping the
payment-provider step they don't need. Until now the SDK READMEs
linked to churnkey.co (the marketing site) which sends signups
through the default flow.

- Top-level README: add a "Sign up free" line in the resources list
  with the intent param. Keeps the marketing-site link for general
  context.
- packages/react/README.md "Add analytics": link directly to the
  intent=sdk register page. Make the free-tier framing explicit
  ("Analytics is included on every plan and works without a billing
  provider connection") so SDK users know they don't need to set up
  Stripe to get analytics.
- packages/mcp/README.md Setup: same intent link for the
  "Don't have an account?" path. Also fix a stale URL — Data API
  Keys live at /settings/organization, not /settings/data-api.

packages/node/README.md is intentionally untouched: the audience
is server-side dev in token mode (paid features), already invested
in a Churnkey account, and a CTA at the top would be noise.

Companion to monorepo PR #179 (rob/sdk) which adds the intent
handling to the register page and the /install/sdk landing flow.
Same fix as churnkey-docs PR #101 review note. The bundled section
pointed at claude_desktop_config.json for both clients, but that file
is Claude Desktop only — Claude Code uses `claude mcp add`,
`.mcp.json`, or `~/.claude.json` (single file, not directory).

Two subsections now: Claude Desktop with the JSON config (macOS +
Windows paths), Claude Code with the `claude mcp add` CLI as the
recommended path and the file-based alternatives noted.
@robert-moore robert-moore changed the title docs: route SDK signup CTAs through ?intent=sdk docs: update sign up instructions May 8, 2026
Review feedback — the React "Add analytics" line read as ad copy
rather than docs prose. Strip the "Analytics is included on every
plan and works without a billing provider connection" sentence and
the parallel qualifiers in the other two READMEs (top-level and
MCP). Stripe-style: tell developers what to do, skip the upsell.

Result: clean imperative sentences with the link, no qualifications.
@robert-moore robert-moore merged commit 3e69dfa into main May 8, 2026
1 check passed
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.

1 participant