AddThisFeature

First-Run Onboarding

Guide new users to the action that makes your app click.

moderate Onboarding

What it adds

A first-run experience that gets a brand-new user to their first meaningful outcome.

What your agent is told to do

4
  1. 1

    Identify the single action that makes this product valuable — the moment a user 'gets it'. Everything in onboarding serves that one moment.

  2. 2

    Build a short checklist of the steps leading there. Three to five items, no more.

  3. 3

    Track completion per user, server-side, so it survives a device change.

  4. 4

    Make it dismissible and restartable from settings. Never trap a user inside onboarding.

Edge cases it handles

4
  • A returning user with existing data must never see first-run onboarding — check their actual state, not just a flag.
  • A step completed elsewhere in the app must tick automatically.
  • An invited teammate joining an established workspace needs different onboarding to a founder starting from zero.
  • Onboarding must not block the app. The user can always skip.

Definition of done

7
  • A new user is guided to the core action.
  • Steps complete automatically when done anywhere in the app.
  • Progress persists across devices and sessions.
  • It is dismissible and restartable.
  • Users with existing data never see first-run onboarding.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.