KasyKasy

Splash Screen

Trocar o logo na abertura do app. Modo claro, modo escuro e web.

A splash screen exibe seu logo enquanto o app carrega. Os arquivos ficam em assets/branding/.

Implementação

Pelo MCP (recomendado): peça ao assistente "troca a splash pra [logo claro] e [logo escuro]". Ele roda set_splash por você. Veja MCP do Kasy.

  1. Rode com as duas versões (claro e escuro):

    kasy splash --light caminho/logo-modo-claro.png --dark caminho/logo-modo-escuro.png
    • --light: logo para o fundo claro (normalmente logo escuro ou colorido)
    • --dark: logo para o fundo escuro (normalmente logo branco ou claro)

    Se não quiser versão escura diferente, use a mesma imagem nos dois flags.

    Tamanho: ≥768 × 768 px (ideal 1024+), PNG com fundo transparente.

    O comando copia para assets/branding/splash-logo-light.png e splash-logo-dark.png, sincroniza o wordmark in-app (logo-light.png / logo-dark.png) usado no login e na sidebar, gera variantes Android 12+ e roda flutter_native_splash:create.

    Alternativa manual:

    1. Substitua os PNGs em assets/branding/
    2. dart run flutter_native_splash:create
    3. kasy run
  2. Se precisar trocar a cor de fundo, edite pubspec.yaml e rode o comando novamente. As cores devem casar com KasyColors.background para não haver flash na transição splash → app:

    flutter_native_splash:
      color: "#FAFAFA"
      color_dark: "#0A0A0C"
      image: assets/branding/splash-logo-light.png
      image_dark: assets/branding/splash-logo-dark.png
      android_12:
        color: "#FAFAFA"
        color_dark: "#0A0A0C"
        image: assets/branding/splash-logo-light-android12.png
        image_dark: assets/branding/splash-logo-dark-android12.png
    dart run flutter_native_splash:create

Informações

Splash na web

O fundo da PWA fica em web/manifest.json (background_color, theme_color).

Posso usar animação?

Não na splash nativa. Ela é exibida pelo sistema operacional antes do Flutter carregar: só aceita PNG estático. Se quiser animação, implemente como a primeira tela do Flutter após a splash fechar.

Atualizado em 03/11/2026