[POC] Modular architecture using Tuist TMA

[markgravity]

Chores

• [chore/modular-poc] POC: Modular architecture using Tuist TMA (The Modular Architecture)

Summary

This PR introduces a proof-of-concept for a modular architecture approach inside the sample/ folder using Tuist TMA.

What's included

Workspace structure

• Workspace.swift — root workspace tying all module projects together
• Per-module Project.swift manifests (Domain, Data, Home, Auth)

Modules

• Modules/Domain — pure Swift entities, interfaces, use cases
• Modules/Data — networking (Alamofire), repository implementations
• Modules/Home — Home feature with HomeScreen, example app, tests
• Modules/Auth — Auth feature with Sign In / Sign Up / Sign Out (UserDefaults), example app, tests

Folder conventions (matching JFC reference project)

• Sources/Presentations/Modules/<ScreenName>/ for screens and view models
• Sources/Helpers/, Sources/Models/ for supporting types
• Tests/<ModuleName>Tests/Specs|Mocks/Managers|Repositories|UseCases|Dummy|Supports/
• Mocks co-located with tests (@testable import) — no separate Testing target

Tuist features used

• buildableFolders (Tuist 4.31+) — blue folder references in Xcode; new files are picked up automatically without re-running tuist generate
• tuist scaffold module template at Tuist/Templates/module/ — scaffold a full module in one command:

  mise exec -- tuist scaffold module --name Payment --bundle-id-suffix payment

How to run

cd sample
mise install
mise exec -- tuist generate

Then open Sample.xcworkspace.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 67861b51-c7ed-4ae4-9f80-7d2772d10987

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/modular-poc

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}