Skip to content

Lead onboarding step 3 with built-in integration cards - #1349

Merged
kody-bot merged 1 commit into
mainfrom
cursor/onboarding-builtins-first-c0a2
Aug 9, 2026
Merged

kody-bot merged 1 commit into
mainfrom
cursor/onboarding-builtins-first-c0a2

Conversation

@kentcdodds

@kentcdodds kentcdodds commented Aug 9, 2026 •

Copy link
Copy Markdown
Owner

What

Swaps the emphasis in onboarding step 3 so the path of least resistance reads first:

  • Built-in integrations are now the primary card grid β€” the top six enabled platform apps by use (up from three), each card with the provider logo in a rounded well (falling back to the built-in ProviderIcon set), the label, and a "Connect" pill linking to /connect/oauth?provider={slug}. The "Bring your own OAuth app" line sits under the grid.
  • Starter packages demote to a compact list under a small-caps "Starter packages" label with an "Advanced" badge: OnboardingStarterCard and OnboardingDiyCard gain a row variant (icon + text left, Install/Copy action right, status wrapping beneath) that reuses all the existing install/copy logic and test ids.
  • The step retitles from "Install a starter package" to "Connect your tools" (stepper + panel title; hash unchanged so deep links keep working).
  • Deployments with no enabled built-ins keep the original layout β€” package cards as the grid under the original lede.

Testing

  • npm run validate green (also fixed a docs temporal-language check hit: the built-ins doc line from Make agent-action liability abundantly clearΒ #1348 said "no longer use", which the checker reads as rollout language; reworded to "unused ones").
  • Verified in the browser against six seeded local providers: card grid renders GitHub/Google/Notion/Slack/Discord/Spotify with icons, the GitHub card lands on the built-in connect page, and the advanced section shows the compact list treatment with the DIY row.

Step 3 leading with six provider cards

Advanced starter packages list below the cards

onboarding_builtins_first_redesign_demo.mp4

Open in WebΒ Open in CursorΒ 

Summary by CodeRabbit

  • New Features

    • Redesigned onboarding step 3 as β€œConnect your tools.”
    • Added prominent built-in integration cards with logos, status indicators, and direct OAuth connections.
    • Added an Advanced section with compact starter-package rows.
    • Increased the number of built-in integrations shown from three to six.
  • Documentation

    • Updated host-approval guidance to recommend revoking unused connections.

Swap the emphasis: built-in integrations are the path of least
resistance, so they now render as the step's primary card grid (top
six by use, up from three) with provider logos, while starter packages
demote to a compact list under a 'Starter packages / Advanced' label.
The step retitles from 'Install a starter package' to 'Connect your
tools'. Deployments with no enabled built-ins keep the original
package-card layout.

Also rewords the built-ins doc line that tripped the docs
temporal-language check ('no longer use' reads as rollout language to
the checker).

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>
@coderabbitai

coderabbitai Bot commented Aug 9, 2026 •

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. πŸŽ‰

ℹ️ Recent review info
βš™οΈ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 653c0f57-d814-42e4-aa2c-eefb5a5828b6

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between ec50bcc and 379060e.

πŸ“’ Files selected for processing (5)
  • docs/use/secrets-and-values.md
  • packages/worker/client/routes/onboarding-diy-card.tsx
  • packages/worker/client/routes/onboarding-starter-card.tsx
  • packages/worker/client/routes/onboarding.tsx
  • packages/worker/src/app/handlers/onboarding.ts

πŸ“ Walkthrough

Walkthrough

The onboarding wizard now focuses step 3 on connecting tools. It displays built-in integrations first, supports up to six providers, and moves starter packages into compact Advanced rows when integrations are available.

Changes

Onboarding tool connections

Layer / File(s) Summary
Card and row variants
packages/worker/client/routes/onboarding-diy-card.tsx, packages/worker/client/routes/onboarding-starter-card.tsx
Both onboarding cards support card and compact row layouts. Variant-specific styles preserve copy, install, status, and error behavior.
Connect your tools step
packages/worker/client/routes/onboarding.tsx, packages/worker/src/app/handlers/onboarding.ts, docs/use/secrets-and-values.md
Step 3 renders built-in provider cards with OAuth links and fallback icons. Starter packages use an Advanced compact list when providers exist. The provider limit is six, and connection guidance now recommends revoking unused connections.

Estimated code review effort: 3 (Moderate) | ~25 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Onboarding
  participant onboarding handler
  participant OAuth route
  Onboarding->>onboarding handler: load up to six built-in providers
  onboarding handler-->>Onboarding: return provider configurations
  Onboarding->>OAuth route: open provider connection route
  OAuth route-->>Onboarding: return OAuth connection flow
  Onboarding->>Onboarding: render starter packages in Advanced rows
Loading

Possibly related PRs

πŸš₯ Pre-merge checks | βœ… 5
βœ… Passed checks (5 passed)
Check name Status Explanation
Title check βœ… Passed The title clearly summarizes the main change: prioritizing built-in integration cards in onboarding step 3.
Description check βœ… Passed The description explains the intent, summarizes the changes, and documents testing; the optional System changes section is not required.
Docstring Coverage βœ… Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check βœ… Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check βœ… Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
πŸ“ Generate docstrings
  • Create stacked PR
  • Commit on current branch
πŸ§ͺ Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cursor/onboarding-builtins-first-c0a2

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❀️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

πŸ”Ž Preview deployed: https://kody-pr-1349.kody-a99.workers.dev

Worker: kody-pr-1349
D1: kody-pr-1349-db
KV: kody-pr-1349-oauth-kv

Mocks:

@kody-bot
kody-bot merged commit 9faafa0 into main Aug 9, 2026
10 checks passed
@kody-bot
kody-bot deleted the cursor/onboarding-builtins-first-c0a2 branch August 9, 2026 21:27
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.

3 participants