# IOS Stack

> Stack decisions for iOS apps (SwiftUI, offline-first, push notifications). Reference before scaffolding or architecture work. Use when this capability is needed.

- Skill: `tomevault-io/ios-stack` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ios-stack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ios-stack/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ios-stack

---


## Locked decisions

| Layer         | Decision                                                  |
| ------------- | --------------------------------------------------------- |
| Distribution  | App Store (starting without developer program membership) |
| UI            | SwiftUI                                                   |
| Architecture  | MVVM with lightweight service layer                       |
| Concurrency   | Swift async/await                                         |
| Persistence   | SwiftData (offline-first)                                 |
| Networking    | URLSession (scaffolded for future use)                    |
| Push          | Stubbed until signing available                           |
| Dependencies  | Minimal; Swift Package Manager only if needed             |
| Environments  | local → non-prod → prod                                   |
| Quality gates | Strict (tests required, SwiftLint enforced)               |

## Project layout

```
MyApp/
  Features/               # Feature modules (View + ViewModel)
  UIComponents/           # Shared UI primitives
  Services/
    Persistence/          # PersistenceStore protocol + SwiftDataStore
    Notifications/        # Push handling (stubbed)
    Network/              # API client (scaffolded)
    Config/               # Environment configuration
  Infrastructure/         # Router, composition root
  Models/                 # SwiftData models
  Resources/              # Assets, strings
```

## Key patterns

### Environment switching

- `Environment.swift` with `.local`, `.nonProd`, `.prod` cases
- Resolved at build time via scheme + build configuration
- API base URLs, feature flags per environment

### Persistence boundary

- `PersistenceStore` protocol defines all data operations
- `SwiftDataStore` is the concrete implementation
- ViewModels never touch SwiftData directly

### Push notification stubbing

- `NotificationService` exists with full interface
- Permission requests return simulated success in local/non-prod
- Token registration logs locally until signing available
- Swap to real implementation when developer membership active

## Reference

For versions, Xcode setup, and implementation patterns, see `reference/ios-stack-reference.md`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/edfenton) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->