# IOS Add Feature

> Scaffold a new feature with View, ViewModel, and tests following ios-std conventions. Use when this capability is needed.

- Skill: `tomevault-io/ios-add-feature` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ios-add-feature`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ios-add-feature/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-add-feature

---


## Purpose
Add a complete feature module to an existing iOS project with View, ViewModel, and tests.

## Arguments
- `feature-name` — Feature name in PascalCase (e.g., `Settings`, `UserProfile`)
- `--with-detail` — Include detail view for drill-down
- `--with-form` — Include form/edit view
- `--no-tests` — Skip test file generation

## What gets created

### Default
```
Features/<Feature>/
├── <Feature>View.swift           # Main view
├── <Feature>ViewModel.swift      # ViewModel with state + intents
└── <Feature>Row.swift            # List row component (if list-based)

Tests/UnitTests/
└── <Feature>ViewModelTests.swift # ViewModel tests
```

### With `--with-detail`
```
Features/<Feature>/
├── <Feature>View.swift
├── <Feature>ViewModel.swift
├── <Feature>DetailView.swift     # Detail view
└── <Feature>DetailViewModel.swift
```

### With `--with-form`
```
Features/<Feature>/
├── <Feature>View.swift
├── <Feature>ViewModel.swift
├── <Feature>FormView.swift       # Create/edit form
└── <Feature>FormViewModel.swift
```

## Conventions

### File naming
- Views: `<Feature>View.swift`
- ViewModels: `<Feature>ViewModel.swift`
- Rows/cells: `<Feature>Row.swift`
- Tests: `<Feature>ViewModelTests.swift`

### ViewModel pattern
- `@MainActor final class`
- `@Published private(set)` for state
- Public methods for intents
- Dependencies injected via init
- Uses `PersistenceStore` protocol (not SwiftData directly)

### View pattern
- `@StateObject` for owned ViewModel
- `@EnvironmentObject` for shared services
- No business logic in views
- Accessibility labels on controls

### Test pattern (Swift Testing)
- `struct` (not `XCTestCase` class)
- `init()` for setup (not `setUp()`)
- `@Test func methodName()` (no `test_` prefix)
- `#expect(condition)` for assertions
- `@Test(arguments:)` for parameterized tests

## Workflow
1. Create feature folder under `Features/`
2. Create View with basic layout
3. Create ViewModel with state and intents
4. Wire up to DependencyContainer
5. Create tests for ViewModel
6. Run `./scripts/lint.sh` and tests to verify

## Output
Summarize: files created, how to access the feature, test coverage.

## Reference
For templates and patterns, see `reference/ios-add-feature-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 -->