initial commit

_bmad-output/implementation-artifacts/15-4-onboarding-tutorial.md

@@ -0,0 +1,44 @@
+---
+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