Skip to content

feat: improve onboarding#351

Merged
avitorio merged 3 commits intocanaryfrom
feat/improve-onboarding
Jan 30, 2026
Merged

feat: improve onboarding#351
avitorio merged 3 commits intocanaryfrom
feat/improve-onboarding

Conversation

@avitorio
Copy link
Owner

@avitorio avitorio commented Jan 30, 2026

Summary

  • Fixes confusing onboarding UX where "Confirm your Branch" was shown alongside existing singletons content
  • Separates branch confirmation from content type selection by creating a new ContentOnboarding component
  • Simplifies CollectionOnboarding to be a focused, reusable card component

Problem

When a user had singletons but no collections, the dashboard showed:

  1. "Confirm your Branch" UI from CollectionOnboarding
  2. SingletonsTable with existing content

This was confusing because if singletons already exist, the user has implicitly confirmed their branch by creating content.

Solution

Refactored the onboarding flow with clear separation of concerns:

Component Responsibility
ContentOnboarding (new) Branch confirmation + shows both collection and singleton options
CollectionOnboarding (simplified) Just the "Create a Collection" card
SingletonOnboarding (unchanged) Just the "Create a Singleton" card

Dashboard behavior:

  • Fresh start (no content): Shows ContentOnboarding with branch confirmation, then collection + singleton options
  • Has singletons, no collections: Shows simplified CollectionOnboarding card (no branch confirmation)
  • Has collections: Shows collections grid

Test plan

  • Added tests for ContentOnboarding component (9 tests)
  • Added tests for simplified CollectionOnboarding component (9 tests)
  • Updated existing collections.test.tsx to reflect new behavior
  • All 139 tests passing

@changeset-bot
Copy link

changeset-bot bot commented Jan 30, 2026

🦋 Changeset detected

Latest commit: 5a245f3

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
outstatic Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
Copy link
Contributor

vercel bot commented Jan 30, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
outstatic-dev-blog Ready Ready Preview Jan 30, 2026 11:15pm
outstatic-docs Ready Ready Preview Jan 30, 2026 11:15pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
outstatic-advanced-blog Ignored Ignored Preview Jan 30, 2026 11:15pm

@avitorio avitorio merged commit 1d8c62c into canary Jan 30, 2026
4 checks passed
@avitorio avitorio deleted the feat/improve-onboarding branch January 30, 2026 23:15
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