# airbnb/lottie-web architecture

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

- Interactive diagram: https://gitdiagram.com/airbnb/lottie-web
- Repository: https://github.com/airbnb/lottie-web

## Overview

Lottie Web loads After Effects animation JSON or a URL, prepares it for playback, and renders frames into a chosen browser renderer. The public API and animation manager own instance creation and playback; animation instances coordinate data loading, frame updates, and rendering. Supporting branches cover vector shapes and animated properties, text and expressions, effects, assets and audio, and optional worker processing. README statements establish renderer choices and user-facing behavior; several internal connections are supported by indexed source references, while unsampled renderer and element internals are not expanded.

Main entry points: [`player/js/animation/AnimationItem.js`](https://github.com/airbnb/lottie-web/blob/master/player/js/animation/AnimationItem.js) (Animation instance), [`player/js/renderers/renderersManager.js`](https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/renderersManager.js) (Renderer selection), [`player/js/modules/main.js`](https://github.com/airbnb/lottie-web/blob/master/player/js/modules/main.js) (Lottie API), [`player/js/animation/AnimationManager.js`](https://github.com/airbnb/lottie-web/blob/master/player/js/animation/AnimationManager.js) (Animation manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Public API and playback"]
  node_api["Lottie API<br/>[main.js]"]
  node_manager["Animation manager"]
  node_instance["Animation instance<br/>[AnimationItem.js]"]
end

subgraph group_data["Animation preparation"]
  node_data["JSON data manager<br/>[DataManager.js]"]
  node_worker["Worker bridge<br/>[worker_wrapper.js]"]
end

subgraph group_render["Renderers and elements"]
  node_renderer_select["Renderer selection"]
  node_svg["SVG renderer<br/>[SVGRenderer.js]"]
  node_canvas["Canvas renderer<br/>[CanvasRenderer.js]"]
  node_html["HTML renderer<br/>[HybridRenderer.js]"]
  node_svg_elements["SVG elements"]
  node_canvas_elements["Canvas elements"]
  node_html_elements["HTML elements"]
end

subgraph group_runtime["Animation runtime"]
  node_properties["Animated properties<br/>[PropertyFactory.js]"]
  node_shapes["Shape properties<br/>[ShapeProperty.js]"]
  node_expressions["Expressions"]
  node_effects["Effects<br/>[EffectsManager.js]"]
  node_assets["Image assets<br/>[imagePreloader.js]"]
  node_fonts["Font manager<br/>[FontManager.js]"]
  node_audio["Audio controller<br/>[AudioController.js]"]
end

node_user(("Web developer"))
node_howler["Howler audio<br/>[howler.js]"]

node_user -->|"loads animation"| node_api
node_api -->|"delegates playback"| node_manager
node_manager -->|"creates instance"| node_instance
node_instance -->|"loads data"| node_data
node_data -.->|"offloads processing"| node_worker
node_instance -->|"selects renderer"| node_renderer_select
node_renderer_select -.->|"dispatches SVG"| node_svg
node_renderer_select -.->|"dispatches Canvas"| node_canvas
node_renderer_select -.->|"dispatches HTML"| node_html
node_user -->|"chooses renderer"| node_renderer_select
node_svg -.->|"renders elements"| node_svg_elements
node_canvas -->|"renders elements"| node_canvas_elements
node_html -.->|"renders elements"| node_html_elements
node_shapes -->|"uses properties"| node_properties
node_instance -.->|"initializes expressions"| node_expressions
node_instance -->|"preloads images"| node_assets
node_instance -.->|"waits for fonts"| node_fonts
node_instance -->|"controls audio"| node_audio
node_audio -->|"uses if available"| node_howler
node_effects -->|"builds effect values"| node_properties

click node_api "https://github.com/airbnb/lottie-web/blob/master/player/js/modules/main.js"
click node_manager "https://github.com/airbnb/lottie-web/blob/master/player/js/animation/AnimationManager.js"
click node_instance "https://github.com/airbnb/lottie-web/blob/master/player/js/animation/AnimationItem.js"
click node_data "https://github.com/airbnb/lottie-web/blob/master/player/js/utils/DataManager.js"
click node_worker "https://github.com/airbnb/lottie-web/blob/master/player/js/worker_wrapper.js"
click node_renderer_select "https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/renderersManager.js"
click node_svg "https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/SVGRenderer.js"
click node_canvas "https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/CanvasRenderer.js"
click node_html "https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/HybridRenderer.js"
click node_svg_elements "https://github.com/airbnb/lottie-web/tree/master/player/js/elements/svgElements"
click node_canvas_elements "https://github.com/airbnb/lottie-web/tree/master/player/js/elements/canvasElements"
click node_html_elements "https://github.com/airbnb/lottie-web/tree/master/player/js/elements/htmlElements"
click node_properties "https://github.com/airbnb/lottie-web/blob/master/player/js/utils/PropertyFactory.js"
click node_shapes "https://github.com/airbnb/lottie-web/blob/master/player/js/utils/shapes/ShapeProperty.js"
click node_expressions "https://github.com/airbnb/lottie-web/blob/master/player/js/utils/expressions/ExpressionManager.js"
click node_effects "https://github.com/airbnb/lottie-web/blob/master/player/js/EffectsManager.js"
click node_assets "https://github.com/airbnb/lottie-web/blob/master/player/js/utils/imagePreloader.js"
click node_fonts "https://github.com/airbnb/lottie-web/blob/master/player/js/utils/FontManager.js"
click node_audio "https://github.com/airbnb/lottie-web/blob/master/player/js/utils/audio/AudioController.js"
click node_howler "https://github.com/airbnb/lottie-web/blob/master/player/js/3rd_party/howler.js"

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_manager,node_instance toneBlue
class node_data,node_worker toneAmber
class node_renderer_select,node_svg,node_canvas,node_html,node_svg_elements,node_canvas_elements,node_html_elements toneMint
class node_properties,node_shapes,node_expressions,node_effects,node_assets,node_fonts,node_audio toneRose
class node_user toneIndigo
class node_howler toneTeal
```

## Components

### Public API and playback

- [Lottie API](https://github.com/airbnb/lottie-web/blob/master/player/js/modules/main.js): `player/js/modules/main.js`
- [Animation manager](https://github.com/airbnb/lottie-web/blob/master/player/js/animation/AnimationManager.js): `player/js/animation/AnimationManager.js`
- [Animation instance](https://github.com/airbnb/lottie-web/blob/master/player/js/animation/AnimationItem.js): `player/js/animation/AnimationItem.js`

### Animation preparation

- [JSON data manager](https://github.com/airbnb/lottie-web/blob/master/player/js/utils/DataManager.js): `player/js/utils/DataManager.js`
- [Worker bridge](https://github.com/airbnb/lottie-web/blob/master/player/js/worker_wrapper.js): `player/js/worker_wrapper.js`

### Renderers and elements

- [Renderer selection](https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/renderersManager.js): `player/js/renderers/renderersManager.js`
- [SVG renderer](https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/SVGRenderer.js): `player/js/renderers/SVGRenderer.js`
- [Canvas renderer](https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/CanvasRenderer.js): `player/js/renderers/CanvasRenderer.js`
- [HTML renderer](https://github.com/airbnb/lottie-web/blob/master/player/js/renderers/HybridRenderer.js): `player/js/renderers/HybridRenderer.js`
- [SVG elements](https://github.com/airbnb/lottie-web/tree/master/player/js/elements/svgElements): `player/js/elements/svgElements`
- [Canvas elements](https://github.com/airbnb/lottie-web/tree/master/player/js/elements/canvasElements): `player/js/elements/canvasElements`
- [HTML elements](https://github.com/airbnb/lottie-web/tree/master/player/js/elements/htmlElements): `player/js/elements/htmlElements`

### Animation runtime

- [Animated properties](https://github.com/airbnb/lottie-web/blob/master/player/js/utils/PropertyFactory.js): `player/js/utils/PropertyFactory.js`
- [Shape properties](https://github.com/airbnb/lottie-web/blob/master/player/js/utils/shapes/ShapeProperty.js): `player/js/utils/shapes/ShapeProperty.js`
- [Expressions](https://github.com/airbnb/lottie-web/blob/master/player/js/utils/expressions/ExpressionManager.js): `player/js/utils/expressions/ExpressionManager.js`
- [Effects](https://github.com/airbnb/lottie-web/blob/master/player/js/EffectsManager.js): `player/js/EffectsManager.js`
- [Image assets](https://github.com/airbnb/lottie-web/blob/master/player/js/utils/imagePreloader.js): `player/js/utils/imagePreloader.js`
- [Font manager](https://github.com/airbnb/lottie-web/blob/master/player/js/utils/FontManager.js): `player/js/utils/FontManager.js`
- [Audio controller](https://github.com/airbnb/lottie-web/blob/master/player/js/utils/audio/AudioController.js): `player/js/utils/audio/AudioController.js`

### Other components

- **Web developer**
- [Howler audio](https://github.com/airbnb/lottie-web/blob/master/player/js/3rd_party/howler.js): `player/js/3rd_party/howler.js`

## Connections

- Web developer → Lottie API: loads animation
- Lottie API → Animation manager: delegates playback (evidence: `player/js/modules/main.js`)
- Animation manager → Animation instance: creates instance (evidence: `player/js/animation/AnimationManager.js`)
- Animation instance → JSON data manager: loads data (evidence: `player/js/animation/AnimationItem.js`)
- JSON data manager → Worker bridge: offloads processing
- Animation instance → Renderer selection: selects renderer (evidence: `player/js/animation/AnimationItem.js`)
- Renderer selection → SVG renderer: dispatches SVG
- Renderer selection → Canvas renderer: dispatches Canvas
- Renderer selection → HTML renderer: dispatches HTML
- Web developer → Renderer selection: chooses renderer
- SVG renderer → SVG elements: renders elements
- Canvas renderer → Canvas elements: renders elements (evidence: `player/js/renderers/CanvasRenderer.js`)
- HTML renderer → HTML elements: renders elements
- Shape properties → Animated properties: uses properties (evidence: `player/js/utils/shapes/ShapeProperty.js`)
- Animation instance → Expressions: initializes expressions
- Animation instance → Image assets: preloads images (evidence: `player/js/animation/AnimationItem.js`)
- Animation instance → Font manager: waits for fonts
- Animation instance → Audio controller: controls audio (evidence: `player/js/animation/AnimationItem.js`)
- Audio controller → Howler audio: uses if available (evidence: `player/js/utils/audio/AudioController.js`)
- Effects → Animated properties: builds effect values (evidence: `player/js/EffectsManager.js`)
