Skip to content

Luminoid/Monolith

BranchesTags

Repository files navigation

Monolith

Swift CLI tool that scaffolds iOS apps, Swift Packages, and Swift CLIs — encoding patterns proven across Plantfolio and LumiKit.

Table of Contents

  1. Requirements
  2. Installation
  3. Quick Start
  4. Usage
  5. Shared Flags
  6. Presets
  7. App Features (15)
  8. Package Features
  9. CLI Features
  10. Architecture
  11. Build & Test
  12. Dependencies
  13. TODO
  14. License
  15. Changelog

Requirements

  • Swift 6.2+
  • macOS 14+

Installation

git clone https://github.com/Luminoid/Monolith.git
cd Monolith
swift build -c release
cp .build/release/monolith /usr/local/bin/

Quick Start

# Interactive wizard — guided prompts with step progress, back navigation, and confirmation
monolith new app

# Non-interactive — all options via flags (great for CI/scripting)
monolith new app --name MyApp --preset standard --no-interactive

# Save config for reuse
monolith new app --name MyApp --preset standard --save-config myapp.json --no-interactive
monolith new app --load-config myapp.json

Usage

Every command supports interactive (full-page wizard with step progress, back navigation, and confirmation) and non-interactive (all options via flags) modes.

Git author name is read from git config user.name for LICENSE and README generation.

Create an iOS App

monolith new app \
  --name MyApp \
  --bundle-id com.company.myapp \
  --deployment-target 18.0 \
  --platforms iPhone,iPad \
  --project-system spm \
  --primary-color "#4CAF7D" \
  --features swiftData,darkMode,combine,devTooling \
  --tabs "Home:house.fill,Settings:gear" \
  --git \
  --no-interactive
Option Default Description
--name (required) App name (letter start, alphanumeric/hyphens/underscores, max 50 chars)
--bundle-id com.example.<name> Bundle identifier in reverse-DNS format
--deployment-target 18.0 Minimum iOS version (major.minor, >= 18.0)
--platforms iPhone Comma-separated: iPhone, iPad, macCatalyst
--project-system spm spm or xcodegen
--primary-color #007AFF Hex color (#RRGGBB) — derives a 22-color theme palette
--features (none) Comma-separated feature flags (see App Features)
--tabs (none) Tab definitions as Name:sf.symbol pairs, comma-separated
--git / --no-git (prompted) Initialize git repository with initial commit

Plus all shared flags.

Auto-derived features: tabs auto-enables when --tabs is provided. macCatalyst auto-enables when --platforms includes macCatalyst. darkMode auto-enables when lumiKit is selected.

Generated app structure 
MyApp/
  Package.swift                           # or project.yml (XcodeGen)
  ExportOptions.plist
  MyApp/
    Info.plist
    App/
      AppDelegate.swift
      SceneDelegate.swift
      MainTabBarController.swift          # if --tabs
    Core/
      AppConstants.swift
      Models/SampleItem.swift             # if swiftData
      Services/DataPublisher.swift        # if combine
      Services/AsyncService.swift         # if combine
      L10n.swift                          # if localization
    Features/
      Home/HomeViewController.swift       # one per tab
      Settings/SettingsViewController.swift
    Shared/
      Design/DesignSystem.swift
      Design/MyAppTheme.swift             # if lumiKit (or AppTheme.swift if darkMode)
      Components/LottieHelper.swift       # if lottie
    MacCatalyst/MacWindowConfig.swift     # if macCatalyst
    Resources/
      Assets.xcassets/
      Localizable.xcstrings               # if localization
  MyAppTests/
    MyAppTests.swift
    Helpers/TestContext.swift              # if swiftData
    Helpers/TestDataFactory.swift          # if swiftData
  .gitignore
  README.md
  .swiftlint.yml                          # if devTooling
  .swiftformat                            # if devTooling
  Makefile                                # if devTooling
  Brewfile                                # if devTooling
  Scripts/git-hooks/pre-commit            # if gitHooks
  .claude/CLAUDE.md                       # if claudeMD
  LICENSE                                 # if licenseChangelog
  CHANGELOG.md                            # if licenseChangelog
  fastlane/Appfile                        # if fastlane
  fastlane/Fastfile                       # if fastlane
  Gemfile                                 # if fastlane
  Mintfile                                # if rSwift

Create a Swift Package

monolith new package \
  --name MyLib \
  --targets Core,UI \
  --target-deps "UI:Core" \
  --platforms "iOS 18.0,macOS 15.0" \
  --features strictConcurrency,devTooling \
  --main-actor-targets UI \
  --git \
  --no-interactive
Option Default Description
--name (required) Package name
--targets <name> Comma-separated target names
--target-deps (none) Dependencies: "TargetB:TargetA;TargetC:TargetA,Other" (semicolon-separated entries, colon separates target from its deps)
--platforms iOS 18.0 Comma-separated: "iOS 18.0,macOS 15.0"
--features (none) Comma-separated feature flags (see Package Features)
--main-actor-targets (none) Targets with defaultIsolation: MainActor (requires defaultIsolation feature)
--git / --no-git (prompted) Initialize git repository

Plus all shared flags.

Generated package structure 
MyLib/
  Package.swift
  Sources/
    Core/Core.swift
    UI/UI.swift
  Tests/
    CoreTests/CoreTests.swift
    UITests/UITests.swift
  .gitignore
  README.md
  .swiftlint.yml                          # if devTooling
  .swiftformat                            # if devTooling
  Makefile                                # if devTooling
  Brewfile                                # if devTooling
  Scripts/git-hooks/pre-commit            # if gitHooks
  .claude/CLAUDE.md                       # if claudeMD
  LICENSE                                 # if licenseChangelog
  CHANGELOG.md                            # if licenseChangelog

Create a Swift CLI

monolith new cli \
  --name mytool \
  --features argumentParser,devTooling,claudeMD \
  --git \
  --no-interactive
Option Default Description
--name (required) CLI name
--features (none) Comma-separated feature flags (see CLI Features)
--git / --no-git (prompted) Initialize git repository

Plus all shared flags.

Generated CLI structure 
mytool/
  Package.swift
  Sources/
    mytool/mytool.swift
  Tests/
    mytoolTests/mytoolTests.swift
  .gitignore
  README.md
  .swiftlint.yml                          # if devTooling
  .swiftformat                            # if devTooling
  Makefile                                # if devTooling
  Brewfile                                # if devTooling
  Scripts/git-hooks/pre-commit            # if gitHooks
  .claude/CLAUDE.md                       # if claudeMD
  LICENSE                                 # if licenseChangelog
  CHANGELOG.md                            # if licenseChangelog

Other Commands

# List features (all or filtered by type)
monolith list features
monolith list features --type app

# Add feature to existing project
monolith add devTooling
monolith add claudeMD --path ~/Projects/MyApp
monolith add gitHooks --dry-run

# Check tool availability
monolith doctor

# Shell completions
monolith completions zsh > ~/.zfunc/_monolith

# Version
monolith version

Additive features for add: devTooling, gitHooks, claudeMD, licenseChangelog.

doctor checks: swift (required), git, swiftlint, swiftformat, xcodegen, mint, fastlane.

Shared Flags

These flags are available on all new commands (new app, new package, new cli):

Flag Default Description
--preset (none) minimal, standard, or full — pre-selects features
--force false Overwrite existing project directory without prompting
--open false Open project in Xcode after generation
--resolve false Run swift package resolve after generation (SPM only)
--save-config (none) Save configuration to JSON file for reuse
--load-config (none) Load configuration from JSON file
--output current directory Output directory for generated project
--dry-run false Preview generated files without writing
--no-interactive false Skip prompts (--name becomes required)

Presets

Preset Features
minimal No features
standard devTooling, gitHooks, claudeMD
full All features (SPM apps exclude rSwift, fastlane)

App Features (15)

Feature Flag Description
SwiftData swiftData Sample @Model, ModelContainer setup, test helpers
LumiKit lumiKit LumiKit dependency with 22-color theme generation from primary color
SnapKit snapKit SnapKit dependency for programmatic Auto Layout
Lottie lottie Lottie animation dependency, optional LumiKitLottie integration
Dark Mode darkMode Standalone AppTheme with adaptive UIColor patterns
Combine combine Publisher/subscriber boilerplate, async Task patterns
Localization localization String Catalog + L10n helper with String(localized:)
Dev Tooling devTooling SwiftLint, SwiftFormat, Makefile, Brewfile
Git Hooks gitHooks Pre-commit hook (lint + format check on staged files)
R.swift rSwift R.swift code generation + Mintfile (XcodeGen only, inactive development — Xcode has native type-safe resources)
Fastlane fastlane Gemfile, Appfile, Fastfile (XcodeGen only — prefer Makefile or Xcode Cloud)
CLAUDE.md claudeMD Project-specific Claude Code guide
License + Changelog licenseChangelog MIT license and Keep a Changelog template
Tabs auto Tab bar controller — auto-enabled when --tabs is provided
Mac Catalyst auto Window config, menu bar — auto-enabled when --platforms includes macCatalyst

Package Features

Feature Flag Description
Strict Concurrency strictConcurrency Swift 6 strict concurrency settings
Default Isolation defaultIsolation defaultIsolation: MainActor on selected targets
Dev Tooling devTooling SwiftLint, SwiftFormat, Makefile, Brewfile
Git Hooks gitHooks Pre-commit hook (lint + format check on staged files)
CLAUDE.md claudeMD Project-specific Claude Code guide
License + Changelog licenseChangelog MIT license and Keep a Changelog template

CLI Features

Feature Flag Description
ArgumentParser argumentParser Swift ArgumentParser dependency
Strict Concurrency strictConcurrency Swift 6 strict concurrency settings
Dev Tooling devTooling SwiftLint, SwiftFormat, Makefile, Brewfile
Git Hooks gitHooks Pre-commit hook (lint + format check on staged files)
CLAUDE.md claudeMD Project-specific Claude Code guide
License + Changelog licenseChangelog MIT license and Keep a Changelog template

Architecture

All source code lives in a MonolithLib library target. A thin monolith executable calls Monolith.main(). This enables @testable import MonolithLib in tests.

Monolith/
  Package.swift
  Sources/
    CEditLine/                    # System library module for macOS editline (arrow key support)
    MonolithLib/
      Monolith.swift              # @main ParsableCommand
      Commands/                   # New{App,Package,CLI}, List, Add, Doctor, Completions, Version
      Config/                     # AppConfig, PackageConfig, CLIConfig, Feature, Preset, ConfigFile, AddableFeature
      Prompts/                    # PromptEngine (readline), WizardEngine, WizardStep, Validators
      Generators/
        App/                      # 21 generators
        Package/                  # 3 generators
        CLI/                      # 3 generators
        Shared/                   # 10 generators (SwiftLint, SwiftFormat, Makefile, etc.)
      Utilities/                  # FileWriter, ColorDeriver, ToolChecker, OverwriteProtection,
                                  # ProjectDetector, ProjectOpener, PackageResolver
    monolith/
      main.swift
  Tests/MonolithTests/            # 378 tests, 52 suites

69 source files, 378 tests (Swift Testing), all passing.

Key Patterns

  • Pure function generators — each generator is (Config) -> String with no side effects
  • Feature flags drive generation — resolvedFeatures auto-derives tabs, macCatalyst, darkMode
  • ColorDeriver — HSB manipulation from 1 hex color to 22 LMKTheme colors
  • Synchronous ParsableCommand — no async; all readline, FileManager, string ops

Build & Test

swift build              # Build
swift test               # Run all 378 tests
swift run monolith version   # Smoke test

Dependencies

Library Version Purpose
ArgumentParser 1.7.0+ Command-line argument parsing
CEditLine (system) macOS built-in Terminal line editing with arrow key support (via libedit)

TODO

Infrastructure

  • Set up GitHub Actions CI (test on push/PR)
  • Add DocC API reference documentation
  • Create CONTRIBUTING.md

Features

  • monolith update — update generated files in existing projects
  • Plugin system for custom generators

License

Monolith is released under the MIT License. See LICENSE for details.

Changelog

See CHANGELOG.md for a detailed history of changes.

About

Swift CLI that scaffolds iOS apps, Swift Packages, and Swift CLIs — 15 optional features, interactive wizard, theme generation from a single hex color.

Resources

Readme

License

MIT license
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases 1

0.1.0 Latest
Mar 4, 2026

Packages

 
 
 

Contributors

Languages