axiom-swiftui-debugging

Diagnose SwiftUI view update, preview, and layout issues via structured decision trees.

3|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/harivansh-afk/claude-code-vertical --skill axiom-swiftui-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-swiftui-debugging
Source: https://github.com/harivansh-afk/claude-code-vertical/tree/main/skill-index/skills/axiom-swiftui-debugging
Command: npx skills add https://github.com/harivansh-afk/claude-code-vertical --skill axiom-swiftui-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers diagnose and fix SwiftUI view update, preview, and layout issues by following structured decision trees.

Core Features & Use Cases

  • Guided decision trees for diagnosing common SwiftUI issues, including view not updating, preview crashes, and layout misalignments.
  • Instructions on using Self._printChanges(), @Observable, and @Bindable for automatic dependency tracking and fewer boilerplate.
  • Practical workflows and real-world examples to accelerate debugging in real projects.

Quick Start

Ask the skill to diagnose a SwiftUI update issue by providing a minimal reproducible example, then follow the guided steps to identify the root cause.

Frequently Asked Questions about axiom-swiftui-debugging

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

FAQPage Schema
Why does my SwiftUI view not update when the state changes?

SwiftUI view not updating issues often stem from struct mutation, binding identity loss, or missing observer patterns. You can diagnose these by checking your @State implementation and using Self._printChanges() to trace what triggered the re-render.

How do I debug SwiftUI preview crashes in Xcode?

Debugging SwiftUI preview crashes involves isolating accidental view recreation and missing observer patterns. Provide a minimal reproducible example to trace the crash, then follow guided decision trees to identify the failing @State or Binding connection.

Does this SwiftUI debugging approach work with iOS 17 @Observable and @Bindable?

This debugging approach explicitly covers iOS 17+ features like @Observable and @Bindable. It guides you through automatic dependency tracking to reduce boilerplate and resolve view update issues specific to these modern state management macros.

What is the best way to diagnose SwiftUI layout issues and misalignments?

The best way to diagnose SwiftUI layout issues is using structured decision trees that evaluate view hierarchy and state dependencies. This method isolates the root cause of misalignments by analyzing how views update and interact across iOS versions.

How do I use Self._printChanges() to find accidental SwiftUI view recreations?

Use Self._printChanges() inside your view body to log what triggered the re-render and spot accidental recreations. The Skill provides practical workflows to interpret these logs and fix binding identity or missing observer pattern issues.

When should I not use @State for SwiftUI state management?

You should reconsider using @State for complex data models or shared state across multiple views, as it can cause binding identity issues. The Skill's decision trees help identify when switching to @Observable or @Bindable is necessary to prevent view update failures.