# juanpe/skeletonview architecture

> Architecture diagram of the GitHub repository juanpe/skeletonview, 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/juanpe/skeletonview
- Repository: https://github.com/juanpe/skeletonview

## Overview

SkeletonView is a UIKit library for displaying configurable loading placeholders. The main workflow starts when an app marks views as skeletonable and calls a show method; the library configures and recursively lays out skeletons, then supports updates, animation, and hiding. Separate capabilities cover text-line rendering and table/collection-view skeleton data sources. The graph follows documented behavior and shown source references; several runtime internals are represented at subsystem level because their implementations were not excerpted.

Main entry points: [`SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+SkeletonView.swift`](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView%2BSkeletonView.swift) (View skeleton runtime), [`SkeletonViewCore/Sources/API/SkeletonView.swift`](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/SkeletonView.swift) (Show and update API), [`SkeletonViewCore/Sources/Internal/Models/SkeletonLayer.swift`](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/Models/SkeletonLayer.swift) (Skeleton layer state), [`SkeletonViewCore/Sources/Internal/UIKitExtensions/UICollectionView+CollectionSkeleton.swift`](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UICollectionView%2BCollectionSkeleton.swift) (Collection skeleton support)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public API"]
  node_api["Show and update API<br/>[SkeletonView.swift]"]
  node_appearance["Appearance settings"]
  node_animation["Animation builder"]
  node_type["Skeleton types<br/>[SkeletonType.swift]"]
end

subgraph group_runtime["Skeleton Runtime"]
  node_config["Skeleton configuration"]
  node_viewruntime["View skeleton runtime"]
  node_traversal["View traversal and layout"]
  node_flow["Lifecycle flow handler"]
  node_recovery["View state recovery<br/>[Recoverable.swift]"]
end

subgraph group_render["Layer Rendering"]
  node_layer["Skeleton layer state"]
  node_text["Text line modeling"]
  node_multiline["Multiline layer builder"]
  node_calayer["Layer drawing and animation"]
end

subgraph group_collections["Collections"]
  node_tableapi["Table skeleton protocol"]
  node_collectionapi["Collection skeleton protocol"]
  node_collectiondata["Collection data source"]
  node_collectiondelegate["Collection delegate"]
  node_collectionruntime["Collection skeleton support"]
  node_table_runtime["Table skeleton support"]
end

node_app(("App developer"))
node_views["Skeletonable views"]

node_app -->|"marks skeletonable"| node_views
node_app -->|"calls show"| node_api
node_api -->|"builds config"| node_config
node_api -->|"dispatches runtime"| node_viewruntime
node_viewruntime -->|"uses config"| node_config
node_viewruntime -->|"notifies flow"| node_flow
node_viewruntime -->|"lays out views"| node_traversal
node_traversal -->|"builds layers"| node_layer
node_viewruntime -.->|"restores state"| node_recovery
node_flow -->|"posts lifecycle events"| node_views
node_layer -->|"reads text metrics"| node_text
node_calayer -->|"builds line layers"| node_multiline
node_layer -->|"updates layer"| node_calayer
node_type -->|"creates default animation"| node_animation
node_api -->|"uses defaults"| node_appearance
node_app -->|"adopts protocol"| node_tableapi
node_app -->|"adopts protocol"| node_collectionapi
node_table_runtime -.->|"uses data source"| node_collectiondata
node_collectionruntime -.->|"uses data source"| node_collectiondata
node_collectionruntime -.->|"uses delegate"| node_collectiondelegate

click node_api "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/SkeletonView.swift"
click node_appearance "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Appearance/SkeletonAppearance.swift"
click node_animation "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/AnimationBuilder/SkeletonAnimationBuilder.swift"
click node_type "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Models/SkeletonType.swift"
click node_config "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonConfigs/SkeletonConfig.swift"
click node_viewruntime "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView%2BSkeletonView.swift"
click node_traversal "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView%2BExtensions.swift"
click node_flow "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonFlowHandler.swift"
click node_recovery "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonExtensions/Recoverable.swift"
click node_layer "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/Models/SkeletonLayer.swift"
click node_text "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonExtensions/SkeletonTextNode.swift"
click node_multiline "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonLayerBuilders/SkeletonMultilineLayerBuilder.swift"
click node_calayer "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/CALayer%2BExtensions.swift"
click node_tableapi "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Collections/TableViews/SkeletonTableViewProtocols.swift"
click node_collectionapi "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Collections/CollectionViews/SkeletonCollectionViewProtocols.swift"
click node_collectiondata "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/Collections/SkeletonCollectionDataSource.swift"
click node_collectiondelegate "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/Collections/SkeletonCollectionDelegate.swift"
click node_collectionruntime "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UICollectionView%2BCollectionSkeleton.swift"
click node_table_runtime "https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UITableView%2BCollectionSkeleton.swift"

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_api,node_appearance,node_animation,node_type,node_views toneBlue
class node_config,node_viewruntime,node_traversal,node_flow,node_recovery toneAmber
class node_layer,node_text,node_multiline,node_calayer toneMint
class node_tableapi,node_collectionapi,node_collectiondata,node_collectiondelegate,node_collectionruntime,node_table_runtime toneRose
class node_app toneIndigo
```

## Components

### Public API

- [Show and update API](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/SkeletonView.swift): `SkeletonViewCore/Sources/API/SkeletonView.swift`
- [Appearance settings](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Appearance/SkeletonAppearance.swift): `SkeletonViewCore/Sources/API/Appearance/SkeletonAppearance.swift`
- [Animation builder](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/AnimationBuilder/SkeletonAnimationBuilder.swift): `SkeletonViewCore/Sources/API/AnimationBuilder/SkeletonAnimationBuilder.swift`
- [Skeleton types](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Models/SkeletonType.swift): `SkeletonViewCore/Sources/API/Models/SkeletonType.swift`

### Skeleton Runtime

- [Skeleton configuration](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonConfigs/SkeletonConfig.swift): `SkeletonViewCore/Sources/Internal/SkeletonConfigs/SkeletonConfig.swift`
- [View skeleton runtime](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView%2BSkeletonView.swift): `SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+SkeletonView.swift`
- [View traversal and layout](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView%2BExtensions.swift): `SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+Extensions.swift`
- [Lifecycle flow handler](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonFlowHandler.swift): `SkeletonViewCore/Sources/Internal/SkeletonFlowHandler.swift`
- [View state recovery](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonExtensions/Recoverable.swift): `SkeletonViewCore/Sources/Internal/SkeletonExtensions/Recoverable.swift`

### Layer Rendering

- [Skeleton layer state](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/Models/SkeletonLayer.swift): `SkeletonViewCore/Sources/Internal/Models/SkeletonLayer.swift`
- [Text line modeling](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonExtensions/SkeletonTextNode.swift): `SkeletonViewCore/Sources/Internal/SkeletonExtensions/SkeletonTextNode.swift`
- [Multiline layer builder](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/SkeletonLayerBuilders/SkeletonMultilineLayerBuilder.swift): `SkeletonViewCore/Sources/Internal/SkeletonLayerBuilders/SkeletonMultilineLayerBuilder.swift`
- [Layer drawing and animation](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/CALayer%2BExtensions.swift): `SkeletonViewCore/Sources/Internal/UIKitExtensions/CALayer+Extensions.swift`

### Collections

- [Table skeleton protocol](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Collections/TableViews/SkeletonTableViewProtocols.swift): `SkeletonViewCore/Sources/API/Collections/TableViews/SkeletonTableViewProtocols.swift`
- [Collection skeleton protocol](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/API/Collections/CollectionViews/SkeletonCollectionViewProtocols.swift): `SkeletonViewCore/Sources/API/Collections/CollectionViews/SkeletonCollectionViewProtocols.swift`
- [Collection data source](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/Collections/SkeletonCollectionDataSource.swift): `SkeletonViewCore/Sources/Internal/Collections/SkeletonCollectionDataSource.swift`
- [Collection delegate](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/Collections/SkeletonCollectionDelegate.swift): `SkeletonViewCore/Sources/Internal/Collections/SkeletonCollectionDelegate.swift`
- [Collection skeleton support](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UICollectionView%2BCollectionSkeleton.swift): `SkeletonViewCore/Sources/Internal/UIKitExtensions/UICollectionView+CollectionSkeleton.swift`
- [Table skeleton support](https://github.com/juanpe/skeletonview/blob/main/SkeletonViewCore/Sources/Internal/UIKitExtensions/UITableView%2BCollectionSkeleton.swift): `SkeletonViewCore/Sources/Internal/UIKitExtensions/UITableView+CollectionSkeleton.swift`

### Other components

- **App developer**
- **Skeletonable views**

## Connections

- App developer → Skeletonable views: marks skeletonable (evidence: `README.md`)
- App developer → Show and update API: calls show (evidence: `README.md`)
- Show and update API → Skeleton configuration: builds config (evidence: `SkeletonViewCore/Sources/API/SkeletonView.swift`)
- Show and update API → View skeleton runtime: dispatches runtime (evidence: `SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+SkeletonView.swift`)
- View skeleton runtime → Skeleton configuration: uses config (evidence: `SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+SkeletonView.swift`)
- View skeleton runtime → Lifecycle flow handler: notifies flow (evidence: `SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+SkeletonView.swift`)
- View skeleton runtime → View traversal and layout: lays out views (evidence: `SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+Extensions.swift`)
- View traversal and layout → Skeleton layer state: builds layers (evidence: `SkeletonViewCore/Sources/Internal/UIKitExtensions/UIView+Extensions.swift`)
- View skeleton runtime → View state recovery: restores state
- Lifecycle flow handler → Skeletonable views: posts lifecycle events (evidence: `SkeletonViewCore/Sources/Internal/SkeletonFlowHandler.swift`)
- Skeleton layer state → Text line modeling: reads text metrics (evidence: `SkeletonViewCore/Sources/Internal/Models/SkeletonLayer.swift`)
- Layer drawing and animation → Multiline layer builder: builds line layers (evidence: `SkeletonViewCore/Sources/Internal/UIKitExtensions/CALayer+Extensions.swift`)
- Skeleton layer state → Layer drawing and animation: updates layer (evidence: `SkeletonViewCore/Sources/Internal/Models/SkeletonLayer.swift`)
- Skeleton types → Animation builder: creates default animation (evidence: `SkeletonViewCore/Sources/API/Models/SkeletonType.swift`)
- Show and update API → Appearance settings: uses defaults (evidence: `SkeletonViewCore/Sources/API/SkeletonView.swift`)
- App developer → Table skeleton protocol: adopts protocol (evidence: `README.md`)
- App developer → Collection skeleton protocol: adopts protocol (evidence: `README.md`)
- Table skeleton support → Collection data source: uses data source
- Collection skeleton support → Collection data source: uses data source
- Collection skeleton support → Collection delegate: uses delegate
