simple_splash_view 0.1.1 
simple_splash_view: ^0.1.1 copied to clipboard
Native splash generator (Android/iOS) with Kotlin/Swift using config from pubspec.yaml.
simple_splash_view #
A native splash screen generator for Flutter.
The package modifies the Android and iOS project files directly to display:
- Lottie animation or static logo image
- Optional startup sound
- Light / Dark theme support
- Optional loading indicator and text label
Re-running the generator updates configurations safely (no duplicate patches).
Quick Start #
Add the configuration block under the root of your app's pubspec.yaml:
simple_splash_view:
lottie: assets/splash.json
lottie_dark: assets/splash_splash.json
image: assets/logo_light.png
image_dark: assets/logo_dark.png
sound: assets/intro.mp3
text: "by Yousef"
background_color: "#FFFFFF"
background_color_dark: "#000000"
text_color: "#000000"
text_color_dark: "#FFFFFF"
indicator_color: "#000000"
indicator_color_dark: "#FFFFFF"
duration: 3000
indicator: true
indicator_position: auto
text_position: auto
theme:
mode: system
Run the generator:
flutter pub run simple_splash_view
Configuration Reference #
| Key | Description | Type | Default |
|---|---|---|---|
lottie |
Lottie animation file | asset path | fallback → lottie |
lottie_dark |
Lottie for dark mode | asset path | fallback → lottie |
image |
Logo image (light mode) | asset path | fallback → image |
image_dark |
Logo image (dark mode) | asset path | fallback → image |
sound |
Startup sound | .mp3 / .wav |
null |
text |
Text displayed below visual | String | fallback → text |
duration |
Duration in ms | int | 2500 |
Colors #
| Key | Mode | Default | Fallback |
|---|---|---|---|
background_color |
Light | #FFFFFF |
— |
background_color_dark |
Dark | #000000 |
background_color |
text_color |
Light | #000000 |
— |
text_color_dark |
Dark | #FFFFFF |
text_color |
indicator_color |
Light | text_color |
— |
indicator_color_dark |
Dark | indicator_color |
indicator_color |
Loading Indicator #
| Key | Description | Default |
|---|---|---|
indicator |
Show circular loader | false |
indicator_position
| Value | Description |
|---|---|
auto |
Default (automatic placement) |
belowVisual |
Indicator under image/Lottie |
aboveText |
Indicator above the text label |
indicator: true
indicator_position: belowVisual
Text Position #
| Value | Description |
|---|---|
auto |
Default placement |
belowVisual |
Text under visual |
bottom |
Text pinned to screen bottom |
text_position: bottom
Theme Mode #
| Value | Behavior |
|---|---|
system |
Follow device brightness |
light |
Always show light splash |
dark |
Always show dark splash |
Native Integration #
Android #
- Generates
SplashActivity.kt - Sets splash as launcher in
AndroidManifest.xml - Updates
activity_splash.xml - Places assets in
res/folders - Supports dark theme variants
iOS #
- Generates
SplashViewController.swift - Integrates into
AppDelegate.swift - Adds
lottie-iospod if needed - Handles light/dark switching automatically
Troubleshooting #
| Issue | Fix |
|---|---|
| Visual not showing | Verify asset paths and flutter: assets: list |
| iOS pod errors | Run sudo gem install cocoapods && cd ios && pod install |
| App skips splash | Remove manual launcher edits and re-run generator |
| No sound on iOS | Ensure device is not in silent mode |
Re-run After Any Change #
flutter pub run simple_splash_view
License #
MIT License
Metadata
3
likes
0
points
42
downloads
Publisher
unverified uploader
Weekly Downloads
Metadata
Native splash generator (Android/iOS) with Kotlin/Swift using config from pubspec.yaml.
Repository (GitHub)
View/report issues
License
unknown (license)
Dependencies
collection, path, xml, yaml
