Agent Skills: tauri-app-deep-linking

When to use this skill

ALWAYS use this skill when the user mentions:

• Deep links or custom URL schemes (e.g., myapp://)
• Routing external URLs into the app
• Secure handling of external link payloads

Trigger phrases include:

• "deep link", "url scheme", "custom protocol", "app link", "myapp://"

How to use this skill

1. Install the deep-linking plugin:

   cargo add tauri-plugin-deep-link
   

2. Register the plugin and define your scheme in tauri.conf.json:

   { "plugins": { "deep-link": { "desktop": { "schemes": ["myapp"] } } } }
   

3. Listen for deep link events on the frontend:

   import { onOpenUrl } from '@tauri-apps/plugin-deep-link';
   await onOpenUrl((urls) => {
     console.log('Deep link received:', urls);
     // Route to appropriate view based on URL path
   });
   

4. Sanitize all external input before using deep link parameters in your app logic
5. Combine with single-instance plugin to forward deep links to the existing running instance
6. Register the scheme with the OS (automatic on install for macOS/Windows, manual for Linux)

Outputs

• Deep link scheme registration in tauri.conf.json
• Frontend event handler for incoming URLs
• Input validation and sanitization pattern

References

• https://v2.tauri.app/plugin/deep-linking/

Keywords

tauri deep linking, url scheme, custom protocol, routing, security