axiom-app-composition

Structure iOS app entry points with state machines and SceneStorage.

61|3|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/joelhooks/joelclaw --skill axiom-app-composition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-app-composition
Source: https://github.com/joelhooks/joelclaw/tree/main/.agents/skills/axiom-app-composition
Command: npx skills add https://github.com/joelhooks/joelclaw --skill axiom-app-composition

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the complexities of structuring application entry points, managing authentication, handling view transitions, and coordinating scene lifecycles in iOS applications, ensuring a robust and flicker-free user experience.

Core Features & Use Cases

  • App State Management: Implement explicit, validated state machines to manage app states like loading, authentication, and error handling, avoiding the "boolean soup" anti-pattern.
  • Root View Switching: Define a clean @main entry point that delegates all logic to a central AppStateController, enabling smooth, animated transitions between different app flows (e.g., login to main dashboard).
  • Scene Lifecycle Integration: Gracefully handle scenePhase changes for session validation, state saving, and resource management.
  • State Restoration: Utilize SceneStorage for reliable restoration of navigation and UI state across app launches and scene reconfigurations.
  • Modularization Strategy: Provides guidance on when and how to modularize features for better code organization, build times, and team collaboration.

Quick Start

Use the axiom-app-composition skill to structure your iOS app's authentication flow and root view switching.

Frequently Asked Questions about axiom-app-composition

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

FAQPage Schema
How do I manage app state and authentication flows in SwiftUI without boolean soup?

Manage app state in SwiftUI by implementing explicit, validated state machines using enums to handle loading, authentication, and error states. This avoids the boolean soup anti-pattern by defining clear, validated state transitions within a central controller.

What is the best way to structure iOS app entry points and handle root view switching?

The best way to structure iOS app entry points is defining a clean @main entry that delegates logic to a central AppStateController, enabling smooth, animated transitions between different app flows like login and the main dashboard.

Can I use SceneStorage for state restoration across app launches in iOS 26+?

Yes, you can use SceneStorage for reliable state restoration in iOS 26+, capturing navigation and UI state to restore user sessions across app launches and scene reconfigurations smoothly.

When should I modularize features in my iOS app architecture?

You should modularize features in iOS app architecture to improve code organization, reduce build times, and enhance team collaboration, applying specific strategies to determine exactly when and how to separate features.

Why does my SwiftUI root view flicker during authentication state transitions?

SwiftUI root views flicker during authentication transitions when logic isn't centralized; delegating all state management to an AppStateController enables smooth, animated transitions and prevents UI flicker.

How do I handle scene lifecycle events and scenePhase changes in SwiftUI?

Handle scene lifecycle events in SwiftUI by monitoring scenePhase changes for session validation, state saving, and resource management, ensuring a robust and flicker-free user experience across scene reconfigurations.