Auth first-user setup — guided registration on fresh Hero OS #43

New issue

Closed

opened 2026-03-18 22:58:44 +00:00 by mik-tf · 0 comments

mik-tf commented

2026-03-18 22:58:44 +00:00

Owner

Problem

When a fresh Hero OS instance starts, there is no guided first-user registration flow. The first admin user must be created manually.

Expected

On first launch (no users in the system), Hero OS should:

Detect that no users exist
Redirect to a setup wizard
Guide creation of the first admin user (name, email, password/key)
Set up initial OSIS context
Redirect to the main dashboard

Notes

This was previously tracked as part of #31 (Self-Documenting Platform) but that issue was broader and has been closed
The auth system (hero_auth) already supports user creation — this is about the UX flow for first-time setup
Needs design input on whether to use password-based or key-based auth for the first user

## Problem When a fresh Hero OS instance starts, there is no guided first-user registration flow. The first admin user must be created manually. ## Expected On first launch (no users in the system), Hero OS should: 1. Detect that no users exist 2. Redirect to a setup wizard 3. Guide creation of the first admin user (name, email, password/key) 4. Set up initial OSIS context 5. Redirect to the main dashboard ## Notes - This was previously tracked as part of #31 (Self-Documenting Platform) but that issue was broader and has been closed - The auth system (hero_auth) already supports user creation — this is about the UX flow for first-time setup - Needs design input on whether to use password-based or key-based auth for the first user