[Vue] No first-run onboarding wizard #60

New issue

Closed

opened 2026-04-02 17:31:09 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-04-02 17:31:09 -07:00

Owner

Problem

The Streamlit UI has a full 6-step onboarding wizard (app/pages/0_Setup.py) that gates the app until initial configuration is complete. The Vue SPA has no equivalent — a new user landing on the Vue SPA with no user.yaml will see empty data everywhere with no guidance.

Required wizard steps

Hardware detection (GPU auto-detect, profile selection)
Tier selection (links to license page or free confirmation)
Resume upload (PDF/DOCX/ODT parser + diagnostics + LinkedIn import tab)
Identity (name, email, phone, LinkedIn, career summary)
Inference & API keys (backend connection test)
Job search preferences (titles, locations, boards)
Integrations (optional — Notion, calendars)

Acceptance criteria

Wizard appears when user.yaml is missing or wizard_complete: false
Progress bar + step indicators
Crash recovery (state saved per step)
Skippable where appropriate (especially integrations)
Redirects to Home on completion

Notes

This is a prerequisite for Vue being the primary surface for new users. Until this exists, Streamlit must remain as the onboarding path.

## Problem The Streamlit UI has a full 6-step onboarding wizard (`app/pages/0_Setup.py`) that gates the app until initial configuration is complete. The Vue SPA has no equivalent — a new user landing on the Vue SPA with no `user.yaml` will see empty data everywhere with no guidance. ## Required wizard steps 1. Hardware detection (GPU auto-detect, profile selection) 2. Tier selection (links to license page or free confirmation) 3. Resume upload (PDF/DOCX/ODT parser + diagnostics + LinkedIn import tab) 4. Identity (name, email, phone, LinkedIn, career summary) 5. Inference & API keys (backend connection test) 6. Job search preferences (titles, locations, boards) 7. Integrations (optional — Notion, calendars) ## Acceptance criteria - Wizard appears when `user.yaml` is missing or `wizard_complete: false` - Progress bar + step indicators - Crash recovery (state saved per step) - Skippable where appropriate (especially integrations) - Redirects to Home on completion ## Notes This is a prerequisite for Vue being the primary surface for new users. Until this exists, Streamlit must remain as the onboarding path.