# joshuaswarren/omarchy-apple-dev architecture

> Architecture diagram of the GitHub repository joshuaswarren/omarchy-apple-dev, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/joshuaswarren/omarchy-apple-dev
- Repository: https://github.com/joshuaswarren/omarchy-apple-dev

## Overview

This repository provides a Linux-based workflow for preparing an Apple-platform toolchain, adapting/building app projects, installing apps on a USB-connected iPhone, and packaging or uploading releases. The principal path is install and register the SDK, build with xtool and Linux replacements for selected Xcode tools, then deploy or ship the resulting app. It also includes project conversion and compatibility support for assets, strings, Core Data, App Intents, and interface archives. README claims establish several workflow links; sampled source confirms actool and nib-tool internals, but many script and compatibility-tool relationships are documented rather than excerpted.

Main entry points: [`tools/darwin-tools/Sources/actool/main.swift`](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/actool/main.swift) (Asset Compiler), [`tools/ibmac.py`](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/ibmac.py) (Interface Compilers), [`install-toolchain.sh`](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/install-toolchain.sh) (Toolchain Installer), [`tools/xcodeproj2xtool.py`](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/xcodeproj2xtool.py) (Xcode Project Adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Toolchain Setup"]
  node_install["Toolchain Installer"]
  node_xtool["xtool Build"]
end

subgraph group_build["Linux Build Support"]
  node_project_adapter["Xcode Project Adapter<br/>[xcodeproj2xtool.py]"]
  node_asset_compiler["Asset Compiler<br/>[main.swift]"]
  node_asset_symbols["Asset Symbols<br/>[AssetSymbols.swift]"]
  node_catalog_merge["Catalog Merge<br/>[CatalogMerge.swift]"]
  node_icon_conversion["Icon Conversion"]
  node_intent_metadata["Intent Metadata<br/>[appintentsmeta.py]"]
  node_interface_compiler["Interface Compilers<br/>[ibmac.py]"]
  node_key_order["Archive Key Ordering<br/>[keyorder.py]"]
  node_nib_archive["Nib Archive<br/>[nibarchive.py]"]
  node_strings_tools["Strings Support"]
  node_coredata_tool["Core Data Support"]
end

subgraph group_device["Device Workflow"]
  node_device_runner["USB Device Runner<br/>[device-run.sh]"]
end

subgraph group_release["Release Workflow"]
  node_shipper["Release Packager<br/>[ship.sh]"]
  node_asc["App Store Connect<br/>[asc.py]"]
end

node_developer(("App Developer"))
node_xcode_dist["Xcode Download"]
node_iphone(("iPhone"))
node_apple_services["Apple Services"]

node_developer -->|"installs"| node_install
node_xcode_dist -->|"provides SDK"| node_install
node_install -->|"registers SDK"| node_xtool
node_developer -->|"converts project"| node_project_adapter
node_project_adapter -.->|"generates adapter"| node_xtool
node_xtool -->|"compiles assets"| node_asset_compiler
node_asset_compiler -->|"prepares catalogs"| node_catalog_merge
node_asset_compiler -->|"generates symbols"| node_asset_symbols
node_catalog_merge -.->|"prepares icons"| node_icon_conversion
node_xtool -->|"generates metadata"| node_intent_metadata
node_xtool -.->|"compiles interfaces"| node_interface_compiler
node_interface_compiler -->|"orders keys"| node_key_order
node_interface_compiler -->|"writes archives"| node_nib_archive
node_xtool -->|"supports strings"| node_strings_tools
node_xtool -->|"supports Core Data"| node_coredata_tool
node_developer -->|"runs deployment"| node_device_runner
node_device_runner -->|"installs app"| node_iphone
node_developer -->|"starts release"| node_shipper
node_shipper -->|"uploads build"| node_asc
node_asc -->|"uses API"| node_apple_services

click node_install "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/install-toolchain.sh"
click node_project_adapter "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/xcodeproj2xtool.py"
click node_asset_compiler "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/actool/main.swift"
click node_asset_symbols "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/actool/AssetSymbols.swift"
click node_catalog_merge "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/DarwinAssets/CatalogMerge.swift"
click node_icon_conversion "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/DarwinAssets/SingleSizeIcon.swift"
click node_intent_metadata "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/appintentsmeta.py"
click node_interface_compiler "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/ibmac.py"
click node_key_order "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/keyorder.py"
click node_nib_archive "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/nibarchive.py"
click node_strings_tools "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/xcstrings_symbols.py"
click node_coredata_tool "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/momc"
click node_device_runner "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/device-run.sh"
click node_shipper "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/ship.sh"
click node_asc "https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/asc.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_install,node_xtool toneBlue
class node_project_adapter,node_asset_compiler,node_asset_symbols,node_catalog_merge,node_icon_conversion,node_intent_metadata,node_interface_compiler,node_key_order,node_nib_archive,node_strings_tools,node_coredata_tool toneAmber
class node_device_runner toneMint
class node_shipper,node_asc toneRose
class node_developer,node_xcode_dist,node_iphone,node_apple_services toneIndigo
```

## Components

### Toolchain Setup

- [Toolchain Installer](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/install-toolchain.sh): `install-toolchain.sh`
- **xtool Build**

### Linux Build Support

- [Xcode Project Adapter](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/xcodeproj2xtool.py): `tools/xcodeproj2xtool.py`
- [Asset Compiler](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/actool/main.swift): `tools/darwin-tools/Sources/actool/main.swift`
- [Asset Symbols](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/actool/AssetSymbols.swift): `tools/darwin-tools/Sources/actool/AssetSymbols.swift`
- [Catalog Merge](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/DarwinAssets/CatalogMerge.swift): `tools/darwin-tools/Sources/DarwinAssets/CatalogMerge.swift`
- [Icon Conversion](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/darwin-tools/Sources/DarwinAssets/SingleSizeIcon.swift): `tools/darwin-tools/Sources/DarwinAssets/SingleSizeIcon.swift`
- [Intent Metadata](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/appintentsmeta.py): `tools/appintentsmeta.py`
- [Interface Compilers](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/ibmac.py): `tools/ibmac.py`
- [Archive Key Ordering](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/keyorder.py): `tools/keyorder.py`
- [Nib Archive](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/nibarchive.py): `tools/nibarchive.py`
- [Strings Support](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/xcstrings_symbols.py): `tools/xcstrings_symbols.py`
- [Core Data Support](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/momc): `tools/momc`

### Device Workflow

- [USB Device Runner](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/device-run.sh): `device-run.sh`

### Release Workflow

- [Release Packager](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/ship.sh): `ship.sh`
- [App Store Connect](https://github.com/joshuaswarren/omarchy-apple-dev/blob/main/tools/asc.py): `tools/asc.py`

### Other components

- **App Developer**
- **Xcode Download**
- **iPhone**
- **Apple Services**

## Connections

- App Developer → Toolchain Installer: installs (evidence: `README.md`)
- Xcode Download → Toolchain Installer: provides SDK (evidence: `README.md`)
- Toolchain Installer → xtool Build: registers SDK (evidence: `README.md`)
- App Developer → Xcode Project Adapter: converts project (evidence: `README.md`)
- Xcode Project Adapter → xtool Build: generates adapter
- xtool Build → Asset Compiler: compiles assets
- Asset Compiler → Catalog Merge: prepares catalogs (evidence: `tools/darwin-tools/Sources/actool/main.swift`)
- Asset Compiler → Asset Symbols: generates symbols (evidence: `tools/darwin-tools/Sources/actool/main.swift`)
- Catalog Merge → Icon Conversion: prepares icons
- xtool Build → Intent Metadata: generates metadata (evidence: `README.md`)
- xtool Build → Interface Compilers: compiles interfaces
- Interface Compilers → Archive Key Ordering: orders keys (evidence: `tools/ibmac.py`)
- Interface Compilers → Nib Archive: writes archives (evidence: `tools/ibmac.py`)
- xtool Build → Strings Support: supports strings (evidence: `README.md`)
- xtool Build → Core Data Support: supports Core Data (evidence: `README.md`)
- App Developer → USB Device Runner: runs deployment (evidence: `README.md`)
- USB Device Runner → iPhone: installs app (evidence: `README.md`)
- App Developer → Release Packager: starts release (evidence: `README.md`)
- Release Packager → App Store Connect: uploads build (evidence: `tools/asc.py`)
- App Store Connect → Apple Services: uses API (evidence: `tools/asc.py`)
