Onboarding Technical Reference
This page describes the onboarding flow sequence presented during the first execution of the application, including persistence state flags and quick skip triggers.
Codebase Map
| Layer | Path | Purpose |
|---|---|---|
| Flow Coordinator | qml/TSApp.qml | Detects onboarding status and renders overlay |
| Onboarding UI | qml/features/settings/Onboarding.qml | Carousel slider, guides, and initial config form |
| State Storage | models/database.js | Database initialization setting verification |
Onboarding Execution Flow
Settings Schema Flag
The onboarding state persists in app_settings:
SELECT value FROM app_settings WHERE key = 'first_launch_done';
- If
valueis not1, the application locks general navigation and redirects the active viewport to the onboarding carousel. - Completing the onboarding screens automatically updates this key to
1so subsequent launches bypass the sequence. - Users can manually reset this setting via the System Settings page to re-trigger onboarding.