deep-link-debugging

Implement debug-only deep links for iOS SwiftUI simulator navigation.

1.1k|81|Updated Nov 30, 2025
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill deep-link-debugging
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deep-link-debugging
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/.claude-plugin/plugins/axiom/skills/deep-link-debugging
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill deep-link-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you implement and test debug-only deep links for simulator navigation and automated testing, enabling closed-loop debugging without production deep link changes.

Core Features & Use Cases

  • Debug URL schemes: Add test-only deep links to reach specific screens.
  • Navigation integration: Connect debug URLs with in-app navigation paths.
  • Automation ready: Works with simulator testers and screenshot workflows.

Quick Start

Propose a set of debug URLs to navigate to key app states for automated testing.

Frequently Asked Questions about deep-link-debugging

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

FAQPage Schema
How do I test deep links in iOS simulator without modifying production code?▼

Deep-link debugging lets you create debug-only URL schemes that navigate simulators to specific screens during testing. Using #if DEBUG guards, you isolate test URLs from production logic, enabling closed-loop navigation testing without production deep link changes.

Can I automate navigation to specific app states for testing workflows?▼

Yes. Debug deep links work with simulator testers and automated screenshot workflows by routing URLs through query item parsing and event-driven navigation (NotificationCenter or NavigationPath), letting you reach dedicated screens and validate flows via simulator commands.

What's the best way to set up debug URLs for SwiftUI navigation during development?▼

Implement a debug URL scheme with host-based routing and query item parsing in your SwiftUI app. Connect parsed URLs to NavigationPath or NotificationCenter events to drive navigation to key screens, keeping all test logic behind #if DEBUG compiler directives.

Does deep-link debugging work with existing navigation patterns in SwiftUI apps?▼

Yes. Debug deep links integrate with SwiftUI's NavigationPath and notification-based navigation systems. They work alongside production deep link logic by operating in a separate debug code section, so you can test navigation flows without altering your app's standard routing.

How do I validate app flows and screen states using debug URLs?▼

Define debug URLs that target specific screens and app states, then invoke them via simulator commands or test scripts. Query parameters set state values, and event-driven navigation delivers you to the target screen, enabling end-to-end flow validation in automated testing.

What happens to debug deep links when I build for production?▼

Debug deep links are stripped at compile time using #if DEBUG guards, so they never reach production builds. Only simulator and debug builds include the test URL scheme and routing logic, keeping production code clean and secure.