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.