How does it handle app termination and state restoration?

The skill provides patterns for using SceneStorage and state validation to restore the user's exact context even if the system kills the app process in the background.

Why should logic be removed from the @main entry point?

Keeping @main as a thin shell makes your app architecture more testable and allows you to inject different state controllers for previews, unit tests, or UI testing.

How does this skill prevent screen flickering during app launch?

It implements animation coordination and synchronous state switching patterns that ensure the next view is ready before the transition occurs, eliminating flashes of incorrect content.

What is the AppStateController pattern?

It is a centralized, observable class that manages high-level app states—such as loading, unauthenticated, and authenticated—using enums to ensure your UI always reflects a single, valid state.

Is this compatible with visionOS and macOS?

Yes, it specifically includes patterns for macOS Tahoe+, visionOS 26+, and multi-window coordination required for spatial computing and desktop environments.

Axiom App Composition

Name: Axiom App Composition
Author: CharlesWiltgen

byCharlesWiltgen

•

233

Mobile Development

Architects robust iOS and xOS app entry points using state-driven composition and scene lifecycle management.

概要

Axiom App Composition provides a standardized framework for structuring the foundation of modern Apple platform applications (iOS, iPadOS, macOS, watchOS, and visionOS). It focuses on moving logic out of the @main entry point into a centralized AppStateController, implementing explicit state machines to manage authentication flows, onboarding, and error states. By leveraging state-as-bridge patterns and scenePhase integration, it ensures flicker-free root view transitions, reliable state restoration after termination, and provides a clear roadmap for when and how to modularize complex feature sets.

主な機能

Scene lifecycle integration for handling backgrounding and state restoration
233 GitHub stars
Explicit AppStateController pattern for centralized, enum-based state management
Standardized @main entry point architecture to improve testability and separation of concerns
Modularization decision trees for scaling codebases and managing feature boundaries
Flicker-prevention techniques for seamless transitions between app states

ユースケース

Refactoring scattered 'boolean soup' logic into a type-safe app-level state machine
Implementing complex authentication-to-onboarding flows with validated transitions
Coordinating multi-window state and scene restoration for iPadOS and visionOS

概要

主な機能

Scene lifecycle integration for handling backgrounding and state restoration
233 GitHub stars
Explicit AppStateController pattern for centralized, enum-based state management
Standardized @main entry point architecture to improve testability and separation of concerns
Modularization decision trees for scaling codebases and managing feature boundaries
Flicker-prevention techniques for seamless transitions between app states

ユースケース

Refactoring scattered 'boolean soup' logic into a type-safe app-level state machine
Implementing complex authentication-to-onboarding flows with validated transitions
Coordinating multi-window state and scene restoration for iPadOS and visionOS