Customize launch appearance

Flutex has a native launch screen and a Flutter startup screen. They appear at different points during launch and should use matching branding.

Native launch screen

In pubspec.yaml, edit the flutter_native_splash configuration. The inspected project uses assets/images/splash_logo.png and the background color #2e5aa5.

Update both the general settings and the android_12 settings where applicable, then run:

dart run flutter_native_splash:create

Rebuild the app to include the generated native resources.

Flutter startup screen

The Flutter screen is located at:

lib/features/splash/presentation/screens/splash_screen.dart

Change presentation elements there and in its referenced assets. Keep startup decisions in the startup controller: loading configuration, checking onboarding, and restoring authentication should not be replaced by a fixed navigation timer.

Verify startup states

Test a fresh install, a returning authenticated session, and a failed network request. Confirm that the logo is not cropped and the background does not flash to an unrelated color between native and Flutter screens.

If the splash remains visible indefinitely, investigate Firebase initialization, configuration requests, and startup errors. Increasing a splash duration does not fix a failed initialization step.

Write Your Comment