axiom-swiftui-debugging

Diagnose SwiftUI view update, preview crash, and layout issues.

Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-swiftui-debugging-tuliopc23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-swiftui-debugging
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-swiftui-debugging
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-swiftui-debugging-tuliopc23

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

SwiftUI development can be frustrating when views don't update, previews crash, or layouts are misbehaving, leading to wasted time and pressure. This Skill provides a systematic approach to diagnose and fix these common issues quickly.

Core Features & Use Cases

  • View Update Diagnosis: Decision trees to pinpoint why a view isn't updating (struct mutation, binding issues, recreation, observer patterns).
  • Preview Crash Resolution: Guides to fix common preview errors like missing dependencies or state initialization failures.
  • Layout Issue Quick Reference: Patterns for overlapping views, GeometryReader quirks, SafeArea complications, and modifier order.
  • Use Case: Your app's list isn't updating after a data change. This Skill guides you through checking for struct mutation vs. lost binding identity vs. accidental view recreation, helping you find the root cause in minutes.

Quick Start

Use the axiom-swiftui-debugging skill to diagnose why a SwiftUI view is not updating.

Frequently Asked Questions about axiom-swiftui-debugging

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

FAQPage Schema
Why is my SwiftUI view not updating after a state change?

SwiftUI view update failures usually stem from struct mutation issues, lost binding identity, or accidental view recreation. This Skill provides decision trees to systematically pinpoint whether your state management or observer patterns are causing the unexpected behavior.

How do I fix SwiftUI preview canvas crashes?

Fixing SwiftUI preview crashes requires checking for missing dependencies or state initialization failures. This Skill guides you through resolving common preview canvas errors by systematically verifying your view's rendering lifecycle and initialization setup.

What is the best way to debug incorrect element positioning in SwiftUI?

Debugging incorrect SwiftUI element positioning involves checking modifier order, GeometryReader quirks, and SafeArea complications. This Skill offers a quick reference pattern to resolve overlapping views and correct layout misbehaviors efficiently.

How does SwiftUI view identity affect rendering and state updates?

SwiftUI view identity directly impacts state management and the rendering lifecycle, causing unexpected view refreshes if configured incorrectly. This Skill helps you understand and diagnose these state management conflicts using systematic reference patterns.

Can I use this to diagnose overlapping views and GeometryReader issues in iOS development?

Yes, this Skill serves iOS development by diagnosing layout issues like overlapping views and GeometryReader quirks. It provides quick reference patterns to resolve SafeArea complications and modifier order problems for correct element positioning.

SwiftUI layout issues not working, what are the common limitations to check?

When SwiftUI layouts are not working, common limitations include incorrect modifier order, SafeArea complications, and GeometryReader quirks. This Skill helps you check these constraints and resolve overlapping views through systematic debugging decision trees.