Onboarding de primeiro lançamento

Diagrama de steps

Usuário toca o ícone do app
Usuário
Primeira abertura após instalação. Sem preferência salva, sem usuário logado.
Splash + bootstrap de tema
App
App lê prefers-color-scheme síncrono antes do primeiro paint pra evitar flash de tema errado.
specs/themes/light-dark.kmd
Auto-detect de locale
App
App resolve o locale do device e cai pra en-US se nenhum recurso casar.
specs/i18n/contract.kmd
Sign-in (opcional)
Usuário
Usuário toca KoderSignInButton ou pula pra sessão guest se o app suportar.
specs/koder-app/behaviors.kmd
Cai no home
App
Preferências persistidas e objeto user agora em escopo. Back daqui sai do app.

Hardcodar ThemeMode.dark antes da preferência salva carregar — causa flash de tema errado em todo cold start.
Mostrar a home antes do locale resolver — primeiro paint exibe chaves ICU cruas.