Agent Skills: tauri-app-splashscreen

When to use this skill

ALWAYS use this skill when the user mentions:

• Splashscreen or loading screen at app startup
• Avoiding white screen flash during initialization
• Controlling when to hide the splashscreen

Trigger phrases include:

• "splashscreen", "splash screen", "loading screen", "white screen", "startup screen"

How to use this skill

1. Configure splashscreen window in tauri.conf.json:

   {
     "app": {
       "windows": [
         { "label": "splashscreen", "url": "splashscreen.html", "width": 400, "height": 300, "decorations": false, "center": true },
         { "label": "main", "url": "/", "visible": false }
       ]
     }
   }
   

2. Create a splashscreen HTML file (e.g., splashscreen.html) with your loading animation or logo
3. Close the splashscreen and show main window from Rust when the app is ready:

   #[tauri::command]
   async fn close_splashscreen(app: tauri::AppHandle) {
       if let Some(splash) = app.get_webview_window("splashscreen") { splash.close().unwrap(); }
       if let Some(main) = app.get_webview_window("main") { main.show().unwrap(); }
   }
   

4. Trigger from the frontend when initialization is complete:

   import { invoke } from '@tauri-apps/api/core';
   await invoke('close_splashscreen');
   

5. Handle slow frontend loads by keeping the splashscreen visible until the frontend signals readiness
6. Set a timeout to close the splashscreen even if initialization hangs, to prevent stuck screens

Outputs

• Splashscreen window configuration in tauri.conf.json
• Rust command to transition from splash to main window
• Timeout fallback for hung initialization

References

• https://v2.tauri.app/learn/splashscreen/

Keywords

tauri splashscreen, loading screen, white screen, startup, splash window