# rudrankriyam/app-store-connect-cli architecture

> Architecture diagram of the GitHub repository rudrankriyam/app-store-connect-cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rudrankriyam/app-store-connect-cli
- Repository: https://github.com/rudrankriyam/app-store-connect-cli

## Overview

This is a Go command-line client for App Store Connect, with Apple Ads and StoreKit integrations. The principal workflow is a user invoking a command, the CLI dispatching to a domain command, that command using authenticated API clients to read or change Apple-managed resources, and results being rendered for terminal or scripted use. Major command families cover apps, builds and TestFlight, metadata and review, analytics, signing, and release operations. Source excerpts confirm selected calls; README statements support the broader command-to-API workflow, while unsampled subsystem links are omitted.

Main entry points: [`cmd/run.go`](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/cmd/run.go) (Command dispatcher), [`main.go`](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/main.go) (Process entry), [`internal/cli/apps/apps.go`](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/apps/apps.go) (Apps), [`internal/asc/client_http.go`](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/asc/client_http.go) (App Store Connect client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry"]
  node_main["Process entry<br/>[main.go]"]
  node_dispatcher["Command dispatcher<br/>[run.go]"]
  node_output["Command output<br/>[output_core.go]"]
end

subgraph group_domains["Command domains"]
  node_apps["Apps<br/>[apps.go]"]
  node_builds["Builds and TestFlight"]
  node_metadata["Metadata and review"]
  node_analytics["Analytics"]
  node_release["Release workflows"]
  node_signing["Signing operations"]
end

subgraph group_services["API and services"]
  node_auth["Credential management<br/>[keychain.go]"]
  node_asc["App Store Connect client<br/>[client_http.go]"]
  node_ads["Apple Ads<br/>[client.go]"]
  node_storekit["StoreKit<br/>[client.go]"]
  node_telemetry["Usage telemetry<br/>[client.go]"]
end

subgraph group_local["Local workflows"]
  node_sync["Signing sync"]
  node_objectstore["Object storage<br/>[objectstorage.go]"]
  node_screenshots["Screenshot review<br/>[review.go]"]
end

node_user(("CLI user"))
node_apple(("Apple services"))

node_user -->|"invokes"| node_main
node_main -->|"runs"| node_dispatcher
node_dispatcher -.->|"dispatches"| node_apps
node_dispatcher -.->|"dispatches"| node_builds
node_dispatcher -.->|"dispatches"| node_metadata
node_dispatcher -.->|"dispatches"| node_analytics
node_dispatcher -.->|"dispatches"| node_release
node_dispatcher -.->|"dispatches"| node_signing
node_apps -->|"gets client"| node_asc
node_release -->|"uses client"| node_asc
node_apps -.->|"prints results"| node_output
node_asc -.->|"API requests"| node_apple
node_ads -.->|"API requests"| node_apple
node_storekit -.->|"API requests"| node_apple
node_sync -->|"creates store"| node_objectstore
node_main -->|"checks worker"| node_telemetry

click node_main "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/main.go"
click node_dispatcher "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/cmd/run.go"
click node_apps "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/apps/apps.go"
click node_builds "https://github.com/rudrankriyam/app-store-connect-cli/tree/main/internal/cli/builds"
click node_metadata "https://github.com/rudrankriyam/app-store-connect-cli/tree/main/internal/cli/app_events"
click node_analytics "https://github.com/rudrankriyam/app-store-connect-cli/tree/main/internal/cli/analytics"
click node_release "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/release/routing_coverage.go"
click node_signing "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/signing/signing_resign_pipeline.go"
click node_auth "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/auth/keychain.go"
click node_asc "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/asc/client_http.go"
click node_ads "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/appleads/client.go"
click node_storekit "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/storekit/client.go"
click node_output "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/asc/output_core.go"
click node_sync "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/signing/signing_sync_storage.go"
click node_objectstore "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/signing/objectstorage.go"
click node_screenshots "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/screenshots/review.go"
click node_telemetry "https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/telemetry/client.go"

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_main,node_dispatcher,node_output,node_user toneBlue
class node_apps,node_builds,node_metadata,node_analytics,node_release,node_signing toneAmber
class node_auth,node_asc,node_ads,node_storekit,node_telemetry toneMint
class node_sync,node_objectstore,node_screenshots toneRose
class node_apple toneIndigo
```

## Components

### CLI entry

- [Process entry](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/main.go): `main.go`
- [Command dispatcher](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/cmd/run.go): `cmd/run.go`
- [Command output](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/asc/output_core.go): `internal/asc/output_core.go`

### Command domains

- [Apps](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/apps/apps.go): `internal/cli/apps/apps.go`
- [Builds and TestFlight](https://github.com/rudrankriyam/app-store-connect-cli/tree/main/internal/cli/builds): `internal/cli/builds`
- [Metadata and review](https://github.com/rudrankriyam/app-store-connect-cli/tree/main/internal/cli/app_events): `internal/cli/app_events`
- [Analytics](https://github.com/rudrankriyam/app-store-connect-cli/tree/main/internal/cli/analytics): `internal/cli/analytics`
- [Release workflows](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/release/routing_coverage.go): `internal/cli/release/routing_coverage.go`
- [Signing operations](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/signing/signing_resign_pipeline.go): `internal/cli/signing/signing_resign_pipeline.go`

### API and services

- [Credential management](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/auth/keychain.go): `internal/auth/keychain.go`
- [App Store Connect client](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/asc/client_http.go): `internal/asc/client_http.go`
- [Apple Ads](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/appleads/client.go): `internal/appleads/client.go`
- [StoreKit](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/storekit/client.go): `internal/storekit/client.go`
- [Usage telemetry](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/telemetry/client.go): `internal/telemetry/client.go`

### Local workflows

- [Signing sync](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/cli/signing/signing_sync_storage.go): `internal/cli/signing/signing_sync_storage.go`
- [Object storage](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/signing/objectstorage.go): `internal/signing/objectstorage.go`
- [Screenshot review](https://github.com/rudrankriyam/app-store-connect-cli/blob/main/internal/screenshots/review.go): `internal/screenshots/review.go`

### Other components

- **CLI user**
- **Apple services**

## Connections

- CLI user → Process entry: invokes (evidence: `README.md`)
- Process entry → Command dispatcher: runs (evidence: `main.go`)
- Command dispatcher → Apps: dispatches
- Command dispatcher → Builds and TestFlight: dispatches
- Command dispatcher → Metadata and review: dispatches
- Command dispatcher → Analytics: dispatches
- Command dispatcher → Release workflows: dispatches
- Command dispatcher → Signing operations: dispatches
- Apps → App Store Connect client: gets client (evidence: `internal/cli/apps/apps.go`)
- Release workflows → App Store Connect client: uses client (evidence: `internal/cli/release/routing_coverage.go`)
- Apps → Command output: prints results
- App Store Connect client → Apple services: API requests (evidence: `README.md`)
- Apple Ads → Apple services: API requests (evidence: `internal/appleads/client.go`)
- StoreKit → Apple services: API requests (evidence: `internal/storekit/client.go`)
- Signing sync → Object storage: creates store (evidence: `internal/cli/signing/signing_sync_storage.go`)
- Process entry → Usage telemetry: checks worker (evidence: `main.go`)
