Skip to content

A scalable iOS application structure showcasing modularization by features using Tuist, following Clean Architecture principles. Designed to demonstrate how to build maintainable, testable, and well-structured apps using modern modular approaches.

Notifications You must be signed in to change notification settings

narlei/SmartShop

Repository files navigation

SmartShop - Modular iOS Architecture with Tuist

A modular iOS application demonstrating clean architecture principles using Tuist for project generation and dependency management.

If you like this approach and plan to use it in your project, feel free to reach out: LinkedIn

Important: Works with Xcode 26!

🔨 Quick Start

make dev

This single command will install Tuist, generate the project, and open it in Xcode.

📖 Documentation

For detailed documentation, visit our Wiki

This project implements a modular architecture using uFeatures with Interface/Implementation separation.

Topic Description
uFeature Concept Understanding the uFeature pattern and its benefits
Modular Architecture How we implement modular architecture with Tuist
Project Setup Getting started with this specific project
Continuous Integration CI/CD setup and best practices
Makefile Automation Development workflow automation

🏗️ Project Overview

This project showcases:

  • 📦 uFeature Modules: Self-contained feature modules with clear boundaries
  • 🔗 Interface/Implementation Separation: Clean contracts between modules
  • ⚡ Tuist Integration: Automated project generation and dependency management
  • 🧪 Comprehensive Testing: Module-level testing with isolation
  • 🔄 CI/CD Pipeline: Automated testing and deployment

📁 Structure

SmartShop/
├── Modules/                     # Feature modules
│   ├── App/                     # Main application
│   ├── uHome/                   # Home feature (task list)
│   └── uNetworking/             # Networking layer
├── docs/                        # Documentation wiki
├── Makefile                     # Development automation
└── Workspace.swift              # Tuist workspace configuration

The uHome implementation was generated by AI as boilerplate to use the provided architeture.


About

A scalable iOS application structure showcasing modularization by features using Tuist, following Clean Architecture principles. Designed to demonstrate how to build maintainable, testable, and well-structured apps using modern modular approaches.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published