Splash Screen

The splash screen shows your logo while the app loads. The files live in assets/branding/.

Implementation

1. Run it with both versions (light and dark):

   kasy splash --light path/light-mode-logo.png --dark path/dark-mode-logo.png

   • --light: logo for the light background (usually a dark or colored logo)
   • --dark: logo for the dark background (usually a white or light logo)

   If you don't want a different dark version, use the same image for both flags.

   Size: ≥768 × 768 px (1024+ ideal), PNG with a transparent background.

   The command copies to assets/branding/splash-logo-light.png and splash-logo-dark.png, syncs the in-app wordmark (logo-light.png / logo-dark.png) used on the login screen and the sidebar, generates Android 12+ variants, and runs flutter_native_splash:create.

   Manual alternative:

   1. Replace the PNGs in assets/branding/
   2. dart run flutter_native_splash:create
   3. kasy run

2. If you need to change the background color, edit pubspec.yaml and run the command again. The colors should match KasyColors.background so there's no flash in the splash → app transition:

   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

Information

Splash on the web

The PWA's background lives in web/manifest.json (background_color, theme_color).

Can I use animation?

Not in the native splash. It's shown by the operating system before Flutter loads: it only accepts a static PNG. If you want animation, implement it as the first Flutter screen after the splash closes.

Last updated on 08/02/2026