# detour-onboarding

Step-by-step guide for integrating Detour deferred deep linking. Helps configure the dashboard, Universal Links, App Links, and mobile SDKs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 763 installs · ★ 296
- Author: software-mansion-labs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/software-mansion-labs/skills/tree/HEAD/skills/detour/detour-onboarding/SKILL.md
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/skills/detour-onboarding

## What it does

The assistant guides the integration of Software Mansion's open-source Detour SDK. This mechanism preserves link context across App Store or Google Play downloads. On first launch, the SDK matches the install via device fingerprinting and routes straight to the target screen. When the app is already installed, direct Universal Links and App Links take over immediately.

The guide covers React Native, native Swift on iOS, Android in Kotlin/Java, and Flutter. The agent first checks the target environment and dashboard status, then walks through setting up an organization at `app.godetour.dev`, acquiring the App ID, and saving the publishable key. Detour automatically hosts verification files, and the dashboard provides the ready-to-use Android `intent-filter` snippet.

Always call `clearLink()` or consume the intent after navigation to prevent duplicate route changes when resuming the app. The skill advises checking generated code directly against the installed package exports because reference docs might lag behind SDK updates.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add software-mansion-labs/skills --skill detour-onboarding -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/detour-onboarding/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/detour-onboarding/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add software-mansion-labs/skills --skill detour-onboarding -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/detour-onboarding/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add software-mansion-labs/skills --skill detour-onboarding -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/detour-onboarding/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install software-mansion-labs/skills detour-onboarding
```

2. **Manually: put the files in place**
- File: `.github/skills/detour-onboarding/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add software-mansion-labs/skills --skill detour-onboarding -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/software-mansion-labs/skills --path skills/detour/detour-onboarding
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/detour-onboarding/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add software-mansion-labs/skills --skill detour-onboarding -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/software-mansion-labs/skills/tree/HEAD/skills/detour/detour-onboarding/SKILL.md

## When to use it
- handle deferred deep linking across store installations
- configure Universal Links on iOS and App Links on Android
- integrate the Detour SDK into React Native, Flutter, iOS, or Android
- route users to specific screens from inbound link parameters

## Example prompts
- Help me set up Detour from scratch in a React Native Expo project
- How do I configure Universal Links and App Links using the Detour dashboard?
- Integrate the Detour SDK into our Flutter app and handle incoming routes

## Similar
- [mobile-design](https://affpapa.org/en/nevibecode/skills/mobile-design.md) — skill · 3700 installs
- [revenuecat-customer-center](https://affpapa.org/en/nevibecode/skills/revenuecat-customer-center.md) — skill · 715 installs
- [senior-mobile](https://affpapa.org/en/nevibecode/skills/senior-mobile.md) — skill · 310 installs
- [frontend-mobile-development-mobile-developer](https://affpapa.org/en/nevibecode/agents/frontend-mobile-development-mobile-developer.md) — subagent · ★ 41729
- [android-emulator](https://affpapa.org/en/nevibecode/skills/android-emulator.md) — skill · 4600 installs
- [flutter-setup-declarative-routing](https://affpapa.org/en/nevibecode/skills/flutter-setup-declarative-routing.md) — skill · 37800 installs

From the same set: [software-mansion-labs/skills](https://affpapa.org/en/nevibecode/by/software-mansion-labs/skills.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md