> For the complete documentation index, see [llms.txt](https://boltuix.gitbook.io/material-uix-kotlin-material-design-ver-1.1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://boltuix.gitbook.io/material-uix-kotlin-material-design-ver-1.1/integrations/splash-screen.md).
# Splash Screen
Step-by-Step Integration Guide
**Add the dependency in your build.gradle file:**
AndroidX Core Library: The primary requirement is to include the AndroidX Core library, which contains the SplashScreen API.
```groovy
dependencies {
// π± Include the AndroidX Core library with SplashScreen API support
implementation "androidx.core:core-splashscreen:1.0.0"
// π οΈ Add other dependencies as needed for your project
// implementation "androidx.appcompat:appcompat:1.3.1"
// implementation "com.google.android.material:material:1.4.0"
}
```
**Step 1:** π¨Setting Up Your Splash Screen Theme
* π¨ Define a custom theme in your res/values/styles.xml.
* π¨ Set the background color to match your appβs branding.
* π¨ Specify the animated icon to be displayed during the splash screen.
* β±οΈ Set the animation duration to control how long the splash screen stays visible.
* π¨ Post-splash screen theme: Define the theme your app will use after the splash screen is dismissed.
*res/values/splash.xml* (light mode)*res/values-night/splash.xml* (dark mode)
```xml
```
..\
**Step 2:** π» Implementing the Main Activity
* π§ Install the splash screen using *installSplashScreen()* in *onCreate()*.
* π± Enable edge-to-edge display for a modern, immersive UI.
* π οΈ Set the content view to your main activity layout.
* π― Handle window insets to properly adjust UI components based on system bars.
*java/com/shopping/cart/MainActivity.kt*
```kotlin
package com.shopping.cart
import android.os.Bundle
import androidx.activity.enableEdgeToEdge
import androidx.appcompat.app.AppCompatActivity
import androidx.core.view.ViewCompat
import androidx.core.view.WindowInsetsCompat
import androidx.core.splashscreen.SplashScreen.Companion.installSplashScreen
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
// π Install the splash screen and set the condition to keep it on screen
installSplashScreen().setKeepOnScreenCondition { false }
super.onCreate(savedInstanceState)
// π Enable edge-to-edge display for a modern UI look
enableEdgeToEdge()
// πΌοΈ Set the content view to the main activity layout
setContentView(R.layout.activity_main)
// π±οΈ Apply window insets to adjust for system bars (like status and navigation bars)
ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.main)) { v, insets ->
val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
insets
}
}
}
```
**..Step 3:** πΌοΈ Designing the Logo
* ποΈ Create a vector drawable for your logo to ensure scalability and performance.
* π Ensure the icon size is set to 192dp for optimal display on the splash screen.
* π Follow guidelines for adaptive icons if you're using a background with the icon.
*res/drawable/logo.xml*
```xml