ios-architecture

Defines a canonical SwiftUI directory layout with MVVM and Clean Architecture boundaries.

Updated Jan 6, 2026
One-click install
npx skills add https://github.com/nguyennamkkb/ios-spec-driven --skill ios-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-architecture
Source: https://github.com/nguyennamkkb/ios-spec-driven/tree/main/src/ios_spec_driven_installer/templates/.claude/skills/ios-architecture
Command: npx skills add https://github.com/nguyennamkkb/ios-spec-driven --skill ios-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a standardized SwiftUI project structure to speed up new projects, ensure consistency, and reduce onboarding time by defining a clear directory layout and naming conventions.

Core Features & Use Cases

  • Standard project skeleton with folders for App, Core, Features, Resources, and Tests.
  • Clear MVVM and Clean Architecture guidance, including directory responsibilities and file naming conventions.
  • Use Case: Start a new SwiftUI app and immediately scaffold feature modules with Views, ViewModels, Models, and Services, ready for implementation.

Quick Start

Tell the AI to generate a SwiftUI project structure following ios-architecture guidelines for a new app named MyApp, including the typical folders and sample file names.

Frequently Asked Questions about ios-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a SwiftUI app for scalability?

To structure a scalable SwiftUI app, organize directories into App, Core, Features, Resources, and Tests. This canonical layout separates architectural boundaries, ensuring maintainable code and smooth team collaboration.

What is the best way to organize files in a SwiftUI MVVM project?

The best way to organize files in a SwiftUI MVVM project is by grouping feature modules into Views, ViewModels, Models, and Services. This enforces Clean Architecture boundaries and standardizes naming conventions across teams.

How do I scaffold a new feature module in SwiftUI?

To scaffold a new feature module in SwiftUI, create folders for Views, ViewModels, Models, and Services within the Features directory. This immediately provides a standardized structure ready for implementation.

Does Clean Architecture work well with SwiftUI directory layouts?

Clean Architecture works with SwiftUI directory layouts by assigning specific responsibilities to App, Core, and Features folders. This separation enforces strict architectural boundaries and reduces onboarding time for new projects.

What naming conventions should I use for iOS project structure?

For iOS project structure, you should use canonical file naming conventions that clearly reflect MVVM and Clean Architecture components. Consistent naming across App, Core, Features, and Tests ensures maintainable code and smooth collaboration.

Why does my SwiftUI project structure become hard to maintain?

Your SwiftUI project structure becomes hard to maintain when it lacks a canonical directory layout and clear architectural boundaries. Establishing standardized folders for App, Core, Features, and Tests solves this by ensuring consistent organization.