---
epic: 15
story: 15.4
title: "Onboarding Tutorial"
status: draft
---

## Epic 15 — Monetization & Onboarding
**Goal:** Establish sustainable revenue with a generous free tier and frictionless onboarding.

### Story 15.4: Onboarding Tutorial

As a first-time CalcPad user,
I want an interactive walkthrough that teaches me the key features,
So that I can quickly become productive without reading documentation.

**Acceptance Criteria:**

**Given** a user launches CalcPad for the first time
**When** the application finishes loading
**Then** an interactive onboarding tutorial begins with a welcome step (Step 1 of 5)
**And** the tutorial highlights the relevant UI area for each step

**Given** the onboarding tutorial is active
**When** the user progresses through the 5 steps
**Then** Step 1 covers basic math: typing expressions and seeing instant results
**And** Step 2 covers unit conversions: demonstrates converting between units (e.g., `5 kg to lb`)
**And** Step 3 covers variables: assigning and referencing values across lines
**And** Step 4 covers currency conversion: using live currency rates (e.g., `100 USD to EUR`)
**And** Step 5 covers sharing and export: how to share a sheet or export results

**Given** the onboarding tutorial is displayed
**When** the user clicks "Skip" at any step
**Then** the tutorial is dismissed immediately
**And** a "Replay Tutorial" option is available in the Help menu

**Given** a user who previously skipped or completed the tutorial
**When** they select Help > Replay Tutorial
**Then** the full 5-step tutorial restarts from Step 1

**Given** the onboarding tutorial is active on any step
**When** the user completes the prompted action (e.g., types an expression and sees a result)
**Then** the tutorial automatically advances to the next step
**And** a subtle animation or highlight confirms the successful action
