First-boot welcome flow that guides users through initial setup of the Samaris desktop environment.
- Welcome — Greeting and OS introduction with language selection
- Theme Selection — Light or dark mode preference with live preview
- WiFi Setup — Scan and connect to a wireless network
- Tour — Quick overview of desktop, AirBar, Finder, Peregrine, and Orbit AI
- Complete — Transition to the desktop with
onboardingCompleteflag
OnboardingFlow (React)
├── OnboardingStep (step container with slide transitions)
├── WelcomeStep
│ └── LanguageSelector
├── ThemeStep
│ └── ThemePreview (live light/dark toggle)
├── WiFiStep
│ └── NetworkScanner
├── TourStep
│ └── TooltipOverlay (highlights UI elements)
└── CompleteStep
└── LaunchButton
Steps persist progress to osStore so the user can navigate forward/backward without losing input. On completion, osStore.onboardingComplete is set to true, which prevents the flow from showing on subsequent boots. The onboarding state is stored in /User/.config/samaris/onboarding.json.