Onboarding
Fluxo padrão, botão Pular e como customizar telas.
O onboarding é só para primeira instalação no fluxo nativo (iOS, Android, ou device preview nessas abas). Quem já tem sessão não volta para /onboarding no caminho normal.
Regras de redirect, preview do admin e teste no browser: Guia Web → Rota /onboarding.
Implementação
Pelo MCP: peça ao assistente "adiciona onboarding no meu projeto". Ele roda add_feature por você. Veja MCP do Kasy.
Customizar textos e imagens
Edite em lib/features/onboarding/. Rotas internas ficam em onboarding_page.dart.
Desativar o botão Pular
Na primeira tela, Pular leva direto à Home (sem paywall). Padrão de apps como Duolingo e Calm.
Para desabilitar, remova onSkip em onboarding_page.dart:
OnboardingFeatureOne(
nextRoute: 'feature_2',
// sem onSkip = sem botão Pular
)Reordenar ou remover uma tela
O onboarding é uma fila de telas conectadas por nextRoute: cada tela recebe o nome da próxima, dentro de onboarding_page.dart. Não existe uma lista central pra reordenar, você muda pra onde cada tela aponta.
Exemplo: seu app não precisa perguntar a idade do usuário. Ache a tela gender_question e troque o nextRoute dela de 'age_question' para 'notifications'. A etapa de idade deixa de ser visitada (não precisa apagar o case dela, só parar de apontar pra lá):
'gender_question' => OnboardingRouteTransition(
builder: (context) => const UserGenderOnboardingQuestion(
nextRoute: 'notifications', // pulou 'age_question'
),
settings: settings,
),Prompt pronto pra pedir à IA:
Leia lib/features/onboarding/ui/onboarding_page.dart.
Quero remover a etapa "age_question" do onboarding, mantendo o resto do fluxo.
Ajuste o nextRoute de quem aponta pra ela.Pra testar o resultado sem repetir o app inteiro, use o modo preview: Console Admin → Ferramentas → Testar onboarding. Ele roda o fluxo completo sem efeitos reais (não conta como analytics, não pede permissão de verdade) e volta pro Admin no final.
Informações
Fluxo padrão
feature_1 → feature_2 → feature_3
→ gênero → idade → push → ATT (iOS)
→ loader → paywall → HomeAtualizado em 03/11/2026

