deep-linking

Integrate React Navigation deep linking with URL parsing and cold start handling.

3|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/guicheffer/devorch-cli --skill deep-linking-guicheffer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-linking
Source: https://github.com/guicheffer/devorch-cli/tree/main/templates/skills/navigation/deep-linking
Command: npx skills add https://github.com/guicheffer/devorch-cli --skill deep-linking-guicheffer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines navigation by enabling direct access to specific app screens and content through universal links and custom URL schemes, ensuring a smooth user experience even during app cold starts.

Core Features & Use Cases

  • URL-to-Screen Mapping: Configure how URLs map to specific screens within your navigation stacks.
  • Cold Start Handling: Manages deep links that arrive when the app is not running, preventing race conditions and ensuring data is loaded before navigation.
  • Parameter Parsing: Extracts and utilizes data from URL query parameters to dynamically route users and pre-fill information.
  • Use Case: A user clicks a link in an email like yourapp://store/product/123?promo=SUMMER. This Skill ensures the app opens directly to the product details screen for product ID 123, applying any relevant promotions.

Quick Start

Configure your app's deep linking by defining URL-to-screen mappings in SKILL.md and using the createModuleLinking utility.

Frequently Asked Questions about deep-linking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle deep linking cold starts in React Native without causing race conditions?

React Native deep linking cold starts require a queueing mechanism to manage navigation. This ensures necessary data loads before the app navigates to the target screen, preventing race conditions when processing universal links from a closed state.

How do I map universal links to specific screens using React Navigation?

Mapping universal links to screens involves configuring URL-to-screen mappings within your React Navigation setup. You define how specific URLs route to corresponding navigation stacks to seamlessly direct users to specific app content.

Can I dynamically route users in React Native using URL query parameters?

Yes, you can dynamically route users by extracting and utilizing data from URL query parameters. This allows you to pre-fill information and apply brand-specific routing logic based on the parsed query data.

What is the best way to configure custom URL schemes for mobile navigation?

Configuring custom URL schemes for mobile navigation requires defining how specific URLs map to app screens and managing cold start arrivals. Using a dedicated utility to create module linking ensures reliable URL parsing and navigation.

Why does my React Navigation deep link fail when the app is completely closed?

Deep links fail on cold starts if the app attempts navigation before required data is loaded. Implementing a queueing mechanism ensures the deep link waits for data readiness before triggering the screen navigation.