iOS-from-web-guide

MANDATORY for API client and Services work. Use before writing APIClient, any file under Services/, or any networking code.

MANDATORY when adding or updating icons in AppIcon.appiconset/. Enforces 1024x1024 sizing and the per-variant alpha rules (primary opaque, dark transparent, tinted opaque grayscale).

MANDATORY for auth token storage. Use before writing any code that stores, reads, or deletes authentication credentials.

MANDATORY when the user asks to add or scaffold a new feature or screen. Chains Model + ViewModel + View + APIClient extension + test stub in one pass.

MANDATORY for Info.plist work. Use before adding imports that require user permission (PhotosUI, AVFoundation camera, CoreLocation, ATT, HealthKit, Contacts, EventKit).

MANDATORY for iOS project initialization and project.yml work. Use before creating or editing project.yml, Package.swift, or the top-level directory layout.

MANDATORY for any AsyncImage rendering a URL from a JSON response. Use before writing AsyncImage(url:) anywhere in the View layer.

MANDATORY for model structs used in SwiftUI views (files under Models/), especially with NavigationLink(value:) or @Observable arrays. Use before writing custom Equatable or Hashable conformances.

MANDATORY for any view combining ScrollView, VStack, AsyncImage, or a custom Layout. Use before writing a ScrollView-based screen under Views/.

MANDATORY for any screen with navigation. Use before writing a NavigationStack, NavigationLink, or navigationDestination — typically files under Views/.

MANDATORY for creating any ViewModel. Use before writing any file under ViewModels/ or any class whose name ends in ViewModel.

MANDATORY for any like, bookmark, follow, favorite, or similar toggle. Use before writing a mutation method on a ViewModel.