# lukezgd/legacy-ios-kit architecture

> Architecture diagram of the GitHub repository lukezgd/legacy-ios-kit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lukezgd/legacy-ios-kit
- Repository: https://github.com/lukezgd/legacy-ios-kit

## Overview

Legacy iOS Kit is a command-line toolkit for maintaining legacy iOS devices. Its documented workflows include restoring or downgrading firmware, managing SHSH blobs, jailbreaking, booting SSH ramdisks, and device/app/data utilities. The tree supplied contains bundled tools and resource payloads but no application entry-point source, and no source excerpts were available; consequently, the graph maps documented capabilities to supported resource paths and shows only clearly documented device and service interactions, not an inferred execution pipeline.

Main entry points: [`bin`](https://github.com/lukezgd/legacy-ios-kit/tree/main/bin) (Device Activation), [`resources/firmware`](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/firmware) (Firmware Resources), [`resources/patch`](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/patch) (Restore Patches), [`resources/jailbreak`](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/jailbreak) (Jailbreak Payloads)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_restore["Restore and Downgrade"]
  node_restore_flow["Restore / Downgrade"]
  node_firmware["Firmware Resources"]
  node_patches["Restore Patches"]
  node_restore_tools["Restore Tools"]
end

subgraph group_device["Device Operations"]
  node_blob_flow["SHSH Management"]
  node_blob_payloads["Firmware Targets"]
end

subgraph group_jailbreak["Jailbreak and Boot"]
  node_jailbreak_flow["Jailbreaking"]
  node_jb_payloads["Jailbreak Payloads"]
  node_ramdisk_flow["SSH Ramdisk"]
  node_ramdisk_payloads["Ramdisk Resources"]
  node_firmware_targets["Device Firmware Data"]
end

subgraph group_management["App and Data"]
  node_app_flow["App Management"]
  node_app_payloads["App Dump Resources"]
  node_data_flow["Data Management"]
  node_activation["Device Activation"]
end

node_user(("User"))
node_device_hw["iOS Device"]
node_cydia["Cydia Servers"]

node_user -->|"requests restore"| node_restore_flow
node_restore_flow -->|"uses firmware"| node_firmware
node_restore_flow -->|"uses patches"| node_patches
node_restore_flow -->|"uses tools"| node_restore_tools
node_restore_flow -->|"restores device"| node_device_hw
node_user -->|"requests blobs"| node_blob_flow
node_blob_flow -->|"saves onboard"| node_device_hw
node_blob_flow -.->|"fetches blobs"| node_cydia
node_blob_flow -->|"targets firmware"| node_blob_payloads
node_user -->|"requests jailbreak"| node_jailbreak_flow
node_jailbreak_flow -->|"uses payloads"| node_jb_payloads
node_jailbreak_flow -->|"jailbreaks device"| node_device_hw
node_user -->|"requests ramdisk"| node_ramdisk_flow
node_ramdisk_flow -->|"uses resources"| node_ramdisk_payloads
node_ramdisk_flow -->|"targets device"| node_firmware_targets
node_ramdisk_flow -->|"boots device"| node_device_hw
node_user -->|"manages apps"| node_app_flow
node_app_flow -->|"uses resources"| node_app_payloads
node_app_flow -->|"manages apps"| node_device_hw
node_user -->|"manages data"| node_data_flow
node_data_flow -->|"backs up or restores"| node_device_hw
node_user -->|"requests activation"| node_activation
node_activation -->|"activates device"| node_device_hw

click node_firmware "https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/firmware"
click node_patches "https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/patch"
click node_restore_tools "https://github.com/lukezgd/legacy-ios-kit/tree/main/bin"
click node_blob_payloads "https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/firmware"
click node_jb_payloads "https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/jailbreak"
click node_ramdisk_payloads "https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/sshrd"
click node_firmware_targets "https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/firmware/src/target"
click node_app_payloads "https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/appdump"
click node_activation "https://github.com/lukezgd/legacy-ios-kit/tree/main/bin"

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_restore_flow,node_firmware,node_patches,node_restore_tools,node_user toneBlue
class node_blob_flow,node_blob_payloads toneAmber
class node_jailbreak_flow,node_jb_payloads,node_ramdisk_flow,node_ramdisk_payloads,node_firmware_targets,node_cydia toneMint
class node_app_flow,node_app_payloads,node_data_flow,node_activation toneRose
class node_device_hw toneIndigo
```

## Components

### Restore and Downgrade

- **Restore / Downgrade**
- [Firmware Resources](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/firmware): `resources/firmware`
- [Restore Patches](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/patch): `resources/patch`
- [Restore Tools](https://github.com/lukezgd/legacy-ios-kit/tree/main/bin): `bin`

### Device Operations

- **SHSH Management**
- [Firmware Targets](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/firmware): `resources/firmware`

### Jailbreak and Boot

- **Jailbreaking**
- [Jailbreak Payloads](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/jailbreak): `resources/jailbreak`
- **SSH Ramdisk**
- [Ramdisk Resources](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/sshrd): `resources/sshrd`
- [Device Firmware Data](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/firmware/src/target): `resources/firmware/src/target`

### App and Data

- **App Management**
- [App Dump Resources](https://github.com/lukezgd/legacy-ios-kit/tree/main/resources/appdump): `resources/appdump`
- **Data Management**
- [Device Activation](https://github.com/lukezgd/legacy-ios-kit/tree/main/bin): `bin`

### Other components

- **User**
- **iOS Device**
- **Cydia Servers**

## Connections

- User → Restore / Downgrade: requests restore
- Restore / Downgrade → Firmware Resources: uses firmware
- Restore / Downgrade → Restore Patches: uses patches
- Restore / Downgrade → Restore Tools: uses tools
- Restore / Downgrade → iOS Device: restores device
- User → SHSH Management: requests blobs
- SHSH Management → iOS Device: saves onboard
- SHSH Management → Cydia Servers: fetches blobs
- SHSH Management → Firmware Targets: targets firmware
- User → Jailbreaking: requests jailbreak
- Jailbreaking → Jailbreak Payloads: uses payloads
- Jailbreaking → iOS Device: jailbreaks device
- User → SSH Ramdisk: requests ramdisk
- SSH Ramdisk → Ramdisk Resources: uses resources
- SSH Ramdisk → Device Firmware Data: targets device
- SSH Ramdisk → iOS Device: boots device
- User → App Management: manages apps
- App Management → App Dump Resources: uses resources
- App Management → iOS Device: manages apps
- User → Data Management: manages data
- Data Management → iOS Device: backs up or restores
- User → Device Activation: requests activation
- Device Activation → iOS Device: activates device