📱 iOS Playground App - MVVM Architecture Reference

This is a simple task-management app with intentionally over-ingeneered logic in some areas. It serves as a base project for future experiments, which I will add in separate branches (for example, for learning and practicing Clean Architecture). I created this app as a playground where I can experiment with new features, technologies and architectural patterns that I plan to use in my future projects.

⚡ Key Features

• MVVM Architecture with clear separation of concerns
• Dependency Injection Container for service management
• Keychain integration for secure authentication
• Mock data implementation
• Reusable SwiftUI components
• Native components with minimal customization
• Navigation management with Coroutine pattern

🎯 Project Overview

🔐 Authentication User login with Keychain storage	📋 Task List View all tasks with status	✏️ Task Details Edit or complete tasks

📁 Project Structure

iOS Playground App (Project Root)
├── Application/
│   ├── DIContainer.swift
│   └── iOS_Playground_AppApp.swift
│   
├── Common/
│   ├── Modifiers/
│   │   └── (Custom view modifiers)
│   │
│   └── Views/
│        └── (Shared reusable views)
│   
├── Core/
│   ├── AuthenticationManager/
│   |   └── (Authentication logic)
│   |
│   ├── Constants/
│   |   └── (App-wide constants)
│   |
│   ├── Coordinator/
│   |   └── (Navigation coordination)
│   |
│   ├── Errors/
│   |    └── (Error definitions)
│   |
│   ├── Network/
│   |   └── (Network layer & API calls)
|   |
│   └── Storage/
│        └── (Data persistence)
│   
├── Model/
│   ├── DTOs/
│   |  └── (Data Transfer Objects)
│   |
│   ├──Entity/
│   |  └── (Core data entities)
│   |
│   └── Types/
│       └── (Custom types & enums)
│   
├── Repositories/
│   ├── Protocols/
│   |   └── (Repository interfaces)
│   |
│   ├── AuthenticationRepositoryImpl.swift
│   ├── TasksRepositoryImpl.swift
│   └── UserRepositoryImpl.swift
│   
├── Resources/
│   └── Assets/
│        └── (Images, colors, assets)
│   
├── Services/
│   ├── Data/
│   |    └── (Data layer services)
│   |
│   ├── Protocols/
│   |   └── (Service interfaces)
│   |
│   ├── AuthenticationServiceImpl.swift
│   ├── TasksServiceImpl.swift
│   └── UserServiceImpl.swift
│   
├── Utilities/
│   ├── Extensions/
│   |   └── (Swift extensions)
│   |
│   ├── Helpers/
│   |   └── Logger.swift
│   └── (Other utilities)
│   
├── ViewModels/
│   ├──Authentication/
│   |   └── (Auth-related ViewModels)
│   |
│   ├── UserProfile/
│   |   └── (User profile ViewModels)
│   |
│   └── UserTasks/
│       └── (Task-related ViewModels)
│   
└── Views/
     ├── Authentication/
     |   └── (Login, signup, auth flows)
     |    
     ├── UserProfile/
     |   └── (Profile screens)
     |   
     ├── UserTasks/
     |    └── (Task list, detail screens)
     |   
     ├── MainNavigationView.swift
     └── RootView.swift

📂 Folder Organization

📐 Architecture Layers

Layer	Purpose
Views	SwiftUI screens & UI components
ViewModels	State management & presentation logic
Services	Business logic & orchestration
Repositories	Data access & abstraction
Model	Data structures & domain models
Core	Infrastructure (Network, Storage, Constants)
Common	Reusable components & modifiers
Utilities	Extensions & helper functions
Resources	Static assets (images, colors, strings)
Application	App entry point & dependency injection

👮🏻‍♂️ Folder Responsibilities

#	Folder	Responsibilities
1️⃣	Application/	• Initialize the app • Setup dependency injection • Configure root view • Manage environment objects
2️⃣	Common/	• Provide reusable modifiers • Create shared UI components • Ensure UI consistency • Enable component reusability
3️⃣	Core/	• Handle network requests • Manage data storage • Define error types • Store app constants • Coordinate navigation • Manage authentication
4️⃣	Model/	• Define domain entities • Create network DTOs • Define custom types • Provide data structures
5️⃣	Repositories/	• Define data access interfaces • Implement data fetching • Transform DTOs to entities • Abstract data sources • Handle data persistence
6️⃣	Resources/	• Provide images • Store color definitions • Manage fonts • Handle localization
7️⃣	Services/	• Implement business logic • Orchestrate repositories • Process data • Enforce business rules
8️⃣	Utilities/	• Extend Swift types • Provide helper functions • Create reusable utilities • Enable code reuse
9️⃣	ViewModels/	• Manage screen state • Handle user interactions • Call services • Update @Published properties
🔟	Views/	• Display user interface • Handle user input • Bind to ViewModels • Manage navigation