KasyKasy

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 → Home

Atualizado em 03/11/2026