
ios-architecture
iOS開発ベストプラクティス - Clean Architecture、SwiftUI、Swift Package Manager マルチモジュール構成
- version
- 1.0.0
- GitHub stars
- 5
Install
/plugin install ios-architecture@no-problem-pluginsRun it inside Claude Code after adding the marketplace with /plugin marketplace add no-problem-dev/claude-code-plugins.
Contents
Discovered from sourceSkills 1
iOS Clean Architecture
iOSアプリのクリーンアーキテクチャに基づくパッケージ構成と設計原則。
パッケージ依存図
┌─────────────────┐
│ Presentation │ SwiftUI Views, Components
└────────┬────────┘
│
┌───────────┬────────────┼────────────┬───────────┐
▼ ▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐
│ State │ │UseCases│ │Repository│ │ Services │ │ External │
│ │ │ │ │ │ │ │ │ SPM (4) │
└────┬───┘ └────┬───┘ └────┬─────┘ └────┬─────┘ └──────────────┘
│ │ ↘ │ ↙ │
│ └─────┬────┴──────┬─────┘
│ ▼ │
│ ┌──────────────┐ │
└──────►│ Domain │◄────┘
└──────────────┘
注: UseCasesはRepository・Servicesの両方に依存可能。ServicesはDomainのみに依存。
ローカルパッケージ(6つ)
| パッケージ | 責務 | 依存先 |
|---|---|---|
| Domain | ドメインモデル・値オブジェクト・列挙型 | なし |
| Services | 再利用可能なアプリケーションサービス(外部SDK連携等) | Domain のみ |
| Repository | API通信・データ永続化 | Domain, APIClient |
| State | @Observable状態管理 | Domain, Authentication |
| UseCases | ビジネスロジック(Protocol定義) | Domain, Repository, Services |
| Presentation | SwiftUI View・コンポーネント | 全て |
Services層の原則
- Domainのみに依存: Repositoryや他のパッケージへの依存は禁止
- 再利用可能: 複数のUseCaseから利用される共通機能を提供
- 外部SDK連携: HealthKit, CoreLocation, Analytics等のラッパー
no problem製外部SPM(4つ)
| パッケージ | モジュール名 | 用途 | 使用レイヤー |
|---|---|---|---|
swift-design-system | DesignSystem | テーマ・色・スペーシング・UIコンポーネント | Presentation |
swift-authentication | Authentication | Firebase Auth統合(Google/Apple Sign-In) | State, Presentation |
swift-ui-routing | UIRouting | 型安全ナビゲーション(Router, TabPresenter) | Presentation |
swift-api-client | APIClient | HTTP通信クライアント | Repository |
依存ルール(厳守)
許可される依存
// ✅ Presentation → 全て(最上層)
import Domain
import State
import UseCases
import Repository
import DesignSystem
import UIRouting
import Authentication
// ✅ UseCases → Domain + Repository + Services
import Domain
import Repository
import Services
// ✅ State → Domain + Authentication
import Domain
import Authentication
// ✅ Repository → Domain + APIClient
import Domain
import APIClient
// ✅ Services → Domain(外部サービス連携)
import Domain
// ✅ Domain → なし(最下層)
// 外部依存ゼロ(Foundationのみ許可)
禁止される依存
// ❌ Domain層での外部import
import Foundation // ✅ OK(標準ライブラリ)
import UIKit // ❌ 禁止
import SwiftUI // ❌ 禁止
import DesignSystem // ❌ 禁止
// ❌ 下位レイヤーから上位への参照
import Presentation // ❌ 循環依存
// ❌ UseCases → State
import State // ❌ 状態管理は上位レイヤーの責務
// ❌ Services → Repository(Servicesは独立性を保つ)
import Repository // ❌ ServicesはDomainのみに依存
設計違反チェックリスト
実装前に確認:
- Domain層にUI依存を追加していないか?
- Repositoryから直接Viewを参照していないか?
- UseCaseがStateを直接操作していないか?
- ServicesがRepositoryに依存していないか?
- 外部SPMを適切なレイヤーでのみ使用しているか?
詳細は REFERENCE.md を参照。
Sponsors
Details
- Marketplace
- no-problem-dev/claude-code-plugins
- Source
- plugins/ios-architecture
- Category
- Development