Pattern 25 · Onboarding

Empty state & first run

New users open an AI product to nothing — no data, no examples, no idea what good looks like.

By Aleksey StepikinUpdated October 20263 min readLive demo
Live demo · try it

An interactive mock built in plain HTML, CSS and JavaScript. Data is fictional; no model is called.

FitWhen to use it — and when not

Use it when

  • First session of any AI product
  • New workspaces, projects, agents
  • Features that need data before they are useful

Skip it when

  • Returning users — get out of their way

AnatomyThe parts of the pattern

  1. Honest headlineWhat this space will become.
  2. Starter templates2–3 concrete jobs with setup time.
  3. Sample runPreview on clearly labelled sample data.
  4. Primary actionConnect real data or start from a template.
  5. Escape hatchStart blank for experts.

GuidelinesDo & don’t

Do

  • Lead with the gentlest, highest-value first task.
  • Label sample data as sample.
  • Show what success looks like before asking for setup.

Don’t

  • Fake activity or metrics to look busy.
  • Open on a blank chat box with "How can I help?" only.
  • Ask for five integrations before the first result.

In productionHow it looks in a shipped product

AI product empty state: an honest first-run screen with one clear first action and a suggested first agent
In production — Atlas first run: no fake metrics or pretend activity; one clear first action and a suggested gentlest first agent. See the Atlas case

In the wildReal-world examples

GammaLovablev0Notion AI

Products named for reference only — no affiliation, and the demo above is an original illustration, not a copy of their UI.

For engineersImplementation notes

  • Ship templates as data with pre-baked sample inputs and cached sample outputs — instant and free to show.
  • Instrument time-to-first-good-result as the activation metric.
  • Seed sample data in a separate, clearly flagged namespace that is easy to delete.

OnboardingRelated patterns

All 26 LLM UX patterns

Building an AI product?

I design and ship AI products end to end — LLM interfaces, agents, RAG, billing — from concept to a live product in weeks, not quarters. Tell me what you are building and get a fixed estimate.

Get an estimateBook a call

Create bold.
Deliver better.

See our workGet in touch