Onboarding

Fluxo de primeiro uso, em passos sequenciais, que já aplica a filosofia de opt-in explícito do produto (ver 01 - Filosofia do Produto): nada é ligado silenciosamente, e cada passo deixa claro que a escolha pode ser revista depois em Configurações.

Sequência de passos

  1. Boas-vindas — tagline do app ("Sua biblioteca, do seu jeito") e reforço de que o uso local (pasta no aparelho) não exige conta nem cadastro.
  2. Destaques — três cartões resumindo leitor imersivo, suporte a vários formatos, e favoritos/progresso; reforça de novo o funcionamento local por padrão.
  3. Modo de navegação — escolha entre abrir o app na Tela Inicial (padrão) ou ir direto para a Biblioteca.
  4. Aparência — escolha entre tema claro ou escuro (a cor de destaque, entre 8 opções, fica para depois, em Configurações).
  5. Recursos — três opt-ins apresentados lado a lado: Notificações, Estatísticas e Histórico, cada um com descrição curta do que ativa.
  6. Pasta raiz — abre o mesmo diálogo unificado "Adicionar pasta" usado em Configurações (ver Fontes Remotas): pasta local (acessada diretamente no aparelho, sem copiar ou enviar nada pra fora dele) ou, opcionalmente, conectar um servidor Komga/Kavita já aqui no primeiro uso. É possível pular esse passo e adicionar uma fonte depois.

Navegação dentro do fluxo

Cada passo pode ser pulado sem perder o restante do progresso já preenchido, e é possível voltar a um passo anterior. A ação de avançar muda de rótulo dependendo da posição: "Começar" no primeiro passo, "Próximo" nos intermediários, "Selecionar pasta" no último.

Reabertura

O onboarding não reaparece depois de concluído ou pulado — a flag que marca "já visto" fica fora do banco Room principal, para sobreviver a limpezas internas do app.