First-run Onboarding
The first time you load the dashboard on a fresh PromptGate install, a Welcome to PromptGate banner appears at the top with a 5-step checklist. Each step ticks itself off automatically as you complete it — there’s no imperative tracking, just five binary “does this row exist?” checks against the database.
The five steps
Section titled “The five steps”| # | Step | Done when |
|---|---|---|
| 1 | Create your first project | A row exists in projects |
| 2 | Add a provider credential | A row exists in credentials |
| 3 | Create your first endpoint | A row exists in endpoints |
| 4 | Issue an API token | An active row exists in api_tokens |
| 5 | Send your first request | Any row exists in gateway_logs |
The banner hides itself once all five are done OR you click the × to dismiss it. Dismiss is persisted as onboarding.dismissed=true in the app_settings k/v store.
Why no “click here” tracking?
Section titled “Why no “click here” tracking?”Two reasons:
- It’s idempotent. If you delete the seed project the wizard re-appears, because step #1 is genuinely undone again. That’s the right behaviour for a re-run.
- It works after restore. If you import a backup with projects + credentials + endpoints, the wizard sees they’re all there and goes silent — no “you haven’t clicked the button yet” false alarms.
Resetting
Section titled “Resetting”Set onboarding.dismissed=false in app_settings to bring the banner back at any time. There’s no UI button for this — admins who want it back are usually debugging, and php artisan tinker is one line away.
\App\Services\Settings\AppSettings::set('onboarding.dismissed', false);© Akyros Labs LLC. All rights reserved.