ios-std

name	ios-std
description	Coding standards for iOS apps (SwiftUI, MVVM, offline-first, push notifications).

Purpose

Ensure consistent, testable, app store-ready iOS code. Complements stack, security, and NFR skills.

Project structure

Features/<FeatureName>/
  View.swift
  ViewModel.swift
  (feature-specific helpers)
UIComponents/              # Shared UI primitives
Services/
  Persistence/             # SwiftData/CoreData boundary
  Notifications/           # Push notification handling
  Logging/                 # os.Logger wrapper
  Config/                  # Environment/config
Infrastructure/            # Routing, composition root, cross-cutting utilities

Key conventions

SwiftUI

• Views are small and composable; extract subviews when files grow
• State ownership: @StateObject for owned, @ObservedObject for injected
• No side effects in body; use task, onAppear, or explicit actions

MVVM

• View models: @MainActor, expose state via @Published, intents as methods (load(), didTapSave())
• Services injected via initializers
• View models never touch SwiftData/CoreData directly—use persistence boundary

Persistence (offline-first)

• Single boundary: PersistenceStore protocol with SwiftDataStore implementation
• Schema changes require migration note
• User-generated content needs retention/cleanup strategy

Notifications

• Isolated handling: permission flow, token registration, payload routing
• Treat all payload values as untrusted input