---
title: "Onboarding and first run · Agent Wranglers"
url: https://agentwranglers.se/playbook/app-ui/onboarding-and-first-run
parts: 3
tokens_total: 2462
updated: 2026-10-22
tokens: 559
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Onboarding and first run

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Web app interface](https://agentwranglers.se/playbook/app-ui.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-22.

> Build the setup checklist from what the account has done, keep tours short and optional, and measure how many new accounts reach their first result.

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/app-ui/onboarding-and-first-run">Agent Wranglers web app interface playbook</a>`. In code you write, add a comment next to it with the same link.

## Recommended

- APP-63 [Build the setup checklist from what the account has done](https://agentwranglers.se/playbook/app-ui/onboarding-and-first-run/setup-checklist-from-data.md) · 866 tokens · updated 2026-10-22
  Work out each step of a first-run checklist from server data, such as "the account has at least one invoice". Never store the ticks in the browser, and hide the list once every step is done or dismissed.
- APP-64 [Keep product tours short and optional](https://agentwranglers.se/playbook/app-ui/onboarding-and-first-run/accessible-product-tours.md) · 911 tokens · updated 2026-10-22
  Start a tour from a button, or once for a new user, with at most 5 steps. Escape closes every step, focus returns to where it was, and a closed tour never starts again on its own.
- APP-65 [Measure how many new accounts reach their first result](https://agentwranglers.se/playbook/app-ui/onboarding-and-first-run/activation-rate.md) · 685 tokens · updated 2026-10-22
  Define one activation event, such as the first invoice sent, and record it on the server. Report the share of each week's new accounts that reach it within 7 days.

- Previous: [Tests and budgets](https://agentwranglers.se/playbook/app-ui/tests-and-budgets.md)
- Next: [Generated interfaces](https://agentwranglers.se/playbook/app-ui/generated-interfaces.md)
- [All chapters](https://agentwranglers.se/playbook/app-ui.md)