🛠 iosgen — iOS Project Generator CLI

A Swift-based command-line tool to quickly scaffold iOS Xcode projects and modules using templates. Built with ArgumentParser and installable globally.

---

✨ Features

• Generate full SwiftUI-based Xcode projects with a single command
• Add new feature modules using templates (planned)
• Replace placeholders in files (e.g. __PROJECT_NAME__)
• CLI-based, installable globally on any macOS machine
• Static template path (/usr/local/share/iosgen/Templates)
• Supports Tuist, SwiftLint, and SwiftFormat in generated projects

---

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/mrardyan/iosgen.git
cd iosgen

2. Install the CLI Globally

This script will:

• Build the CLI with Swift
• Copy the binary to /usr/local/bin
• Copy templates to /usr/local/share/iosgen/Templates

chmod +x Scripts/install.sh
./Scripts/install.sh

---

🧪 Usage

Once installed, use the iosgen command globally from any folder.

Generate a New Project

iosgen init MyApp

Creates a new iOS project using the BaseProject-SwiftUI template with Tuist, SwiftLint, and SwiftFormat.

Add a Module (Upcoming)

iosgen add-module Home

Note: This feature is planned — contribute if you'd like to help!

---

📁 Template Location

Templates should be placed inside:

/usr/local/share/iosgen/Templates/

Example structure:

Templates/
└── BaseProject-SwiftUI/
    ├── Project.swift
    ├── App/
    │   ├── AppDelegate.swift
    │   ├── ContentView.swift
    │   └── Info.plist
    ├── Tests/
    │   └── AppTests.swift
    ├── .swiftlint.yml
    └── .swiftformat

Use placeholders like __PROJECT_NAME__ in template files. They will be replaced automatically during generation.

---

🔧 Development

To build locally:

swift build -c release

To test without installing:

.build/release/iosgen init MyApp

---

📦 Distribute via Homebrew (optional)

To distribute via Homebrew:

1. Create a new tap repository: homebrew-iosgen
2. Add a formula referencing your latest GitHub release

Users can install via:

brew install mrardyan/iosgen/iosgen

---

🙌 Contribution

Feel free to open PRs or issues. Ideas for future:

• Add add-module command
• Support MVVM or Clean Architecture templates
• Interactive mode

---

📚 License

MIT License

---

Need help? Feel free to open an issue!