# esotericsoftware/spine-runtimes architecture

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

## Overview

Spine Runtimes are libraries and toolkit integrations for using Spine 2D skeletal-animation data in applications. The broad workflow is author/export data, load it into a runtime, advance animation state and update the skeleton pose, then render through a platform integration. The repository supports multiple languages and engines rather than one application entry point. The graph emphasizes indexed core modules and sampled Android integration; other runtime branches are represented at directory level because their implementation details were not sampled.

Main entry points: [`spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java`](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java) (Skeleton pose), [`spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidSkeletonDrawable.java`](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidSkeletonDrawable.java) (Skeleton drawable), [`spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java`](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java) (Spine view), [`spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationState.java`](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationState.java) (Animation state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_data["Spine Data"]
  node_animdata["Animation data"]
end

subgraph group_core["Animation Core"]
  node_skeletondata["Skeleton data<br/>[SkeletonData.java]"]
  node_skeleton["Skeleton pose<br/>[Skeleton.java]"]
  node_bone["Bone data and pose<br/>[BoneData.java]"]
  node_slot["Slots and attachments<br/>[Slot.java]"]
  node_skin["Skin configuration<br/>[Skin.java]"]
  node_animation["Animation timelines<br/>[Animation.java]"]
  node_statedata["Animation mixing"]
  node_state["Animation state"]
end

subgraph group_android["Android Runtime"]
  node_androidview["Spine view<br/>[SpineView.java]"]
  node_androidcontroller["View controller"]
  node_drawable["Skeleton drawable"]
  node_atlas["Texture atlas"]
  node_renderer["Canvas renderer"]
end

subgraph group_platforms["Other Runtimes"]
  node_gdx["LibGDX runtime"]
  node_cpp["C++ runtime"]
  node_csharp["C&#35; runtime"]
  node_typescript["TypeScript runtimes"]
  node_ios["iOS integration"]
  node_godot["Godot integration"]
end

node_author(("Spine authoring"))

node_author -->|"exports"| node_animdata
node_animdata -.->|"loads as"| node_skeletondata
node_skeletondata -->|"builds pose"| node_skeleton
node_skeleton -->|"contains pose"| node_bone
node_skeleton -->|"contains slots"| node_slot
node_state -->|"applies timelines"| node_animation
node_state -->|"uses mixing"| node_statedata
node_androidview -->|"uses controller"| node_androidcontroller
node_androidview -->|"loads drawable"| node_drawable
node_androidcontroller -->|"exposes drawable"| node_drawable
node_drawable -->|"creates pose"| node_skeleton
node_drawable -->|"uses textures"| node_atlas
node_androidview -->|"renders with"| node_renderer
node_animdata -->|"runtime support"| node_gdx
node_animdata -->|"runtime support"| node_cpp
node_animdata -->|"runtime support"| node_csharp
node_animdata -->|"runtime support"| node_typescript
node_animdata -->|"runtime support"| node_ios
node_animdata -->|"runtime support"| node_godot

click node_skeletondata "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/SkeletonData.java"
click node_skeleton "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java"
click node_bone "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/BoneData.java"
click node_slot "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Slot.java"
click node_skin "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skin.java"
click node_animation "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Animation.java"
click node_statedata "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationStateData.java"
click node_state "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationState.java"
click node_androidview "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java"
click node_androidcontroller "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineController.java"
click node_drawable "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidSkeletonDrawable.java"
click node_atlas "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidTextureAtlas.java"
click node_renderer "https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SkeletonRenderer.java"
click node_gdx "https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine"
click node_cpp "https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-cpp/src/spine"
click node_csharp "https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-csharp/src"
click node_typescript "https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-ts"
click node_ios "https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-ios/Sources/SpineiOS"
click node_godot "https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-godot/spine_godot"

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_animdata toneBlue
class node_skeletondata,node_skeleton,node_bone,node_slot,node_skin,node_animation,node_statedata,node_state toneAmber
class node_androidview,node_androidcontroller,node_drawable,node_atlas,node_renderer toneMint
class node_gdx,node_cpp,node_csharp,node_typescript,node_ios,node_godot toneRose
class node_author toneIndigo
```

## Components

### Spine Data

- **Animation data**

### Animation Core

- [Skeleton data](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/SkeletonData.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/SkeletonData.java`
- [Skeleton pose](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java`
- [Bone data and pose](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/BoneData.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/BoneData.java`
- [Slots and attachments](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Slot.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Slot.java`
- [Skin configuration](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skin.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skin.java`
- [Animation timelines](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Animation.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Animation.java`
- [Animation mixing](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationStateData.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationStateData.java`
- [Animation state](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationState.java): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationState.java`

### Android Runtime

- [Spine view](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java): `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java`
- [View controller](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineController.java): `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineController.java`
- [Skeleton drawable](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidSkeletonDrawable.java): `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidSkeletonDrawable.java`
- [Texture atlas](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidTextureAtlas.java): `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidTextureAtlas.java`
- [Canvas renderer](https://github.com/esotericsoftware/spine-runtimes/blob/4.3/spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SkeletonRenderer.java): `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SkeletonRenderer.java`

### Other Runtimes

- [LibGDX runtime](https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine): `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine`
- [C++ runtime](https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-cpp/src/spine): `spine-cpp/src/spine`
- [C# runtime](https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-csharp/src): `spine-csharp/src`
- [TypeScript runtimes](https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-ts): `spine-ts`
- [iOS integration](https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-ios/Sources/SpineiOS): `spine-ios/Sources/SpineiOS`
- [Godot integration](https://github.com/esotericsoftware/spine-runtimes/tree/4.3/spine-godot/spine_godot): `spine-godot/spine_godot`

### Other components

- **Spine authoring**

## Connections

- Spine authoring → Animation data: exports (evidence: `README.md`)
- Animation data → Skeleton data: loads as
- Skeleton data → Skeleton pose: builds pose (evidence: `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java`)
- Skeleton pose → Bone data and pose: contains pose (evidence: `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java`)
- Skeleton pose → Slots and attachments: contains slots (evidence: `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/Skeleton.java`)
- Animation state → Animation timelines: applies timelines (evidence: `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationState.java`)
- Animation state → Animation mixing: uses mixing (evidence: `spine-libgdx/spine-libgdx/src/com/esotericsoftware/spine/AnimationState.java`)
- Spine view → View controller: uses controller (evidence: `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java`)
- Spine view → Skeleton drawable: loads drawable (evidence: `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java`)
- View controller → Skeleton drawable: exposes drawable (evidence: `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineController.java`)
- Skeleton drawable → Skeleton pose: creates pose (evidence: `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidSkeletonDrawable.java`)
- Skeleton drawable → Texture atlas: uses textures (evidence: `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/AndroidSkeletonDrawable.java`)
- Spine view → Canvas renderer: renders with (evidence: `spine-android/spine-android/src/main/java/com/esotericsoftware/spine/android/SpineView.java`)
- Animation data → LibGDX runtime: runtime support (evidence: `README.md`)
- Animation data → C++ runtime: runtime support (evidence: `README.md`)
- Animation data → C# runtime: runtime support (evidence: `README.md`)
- Animation data → TypeScript runtimes: runtime support (evidence: `README.md`)
- Animation data → iOS integration: runtime support (evidence: `README.md`)
- Animation data → Godot integration: runtime support (evidence: `README.md`)
