How airbnb/lottie-web works
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: AnimationItem.js Animation instance · renderersManager.js Renderer selection · main.js Lottie API · AnimationManager.js Animation manager
Components 21
Public API and playback
- Lottie API
player/js/modules/main.js - Animation manager
player/js/animation/AnimationManager.js - Animation instance
player/js/animation/AnimationItem.js
Animation preparation
- JSON data manager
player/js/utils/DataManager.js - Worker bridge
player/js/worker_wrapper.js
Renderers and elements
- Renderer selection
player/js/renderers/renderersManager.js - SVG renderer
player/js/renderers/SVGRenderer.js - Canvas renderer
player/js/renderers/CanvasRenderer.js - HTML renderer
player/js/renderers/HybridRenderer.js - SVG elements
player/js/elements/svgElements - Canvas elements
player/js/elements/canvasElements - HTML elements
player/js/elements/htmlElements
Animation runtime
- Animated properties
player/js/utils/PropertyFactory.js - Shape properties
player/js/utils/shapes/ShapeProperty.js - Expressions
player/js/utils/expressions/ExpressionManager.js - Effects
player/js/EffectsManager.js - Image assets
player/js/utils/imagePreloader.js - Font manager
player/js/utils/FontManager.js - Audio controller
player/js/utils/audio/AudioController.js
Other components
- Web developer
- Howler audio
player/js/3rd_party/howler.js
Connections 20
- Web developer → Lottie API: loads animation
- Lottie API → Animation manager: delegates playback
player/js/modules/main.js - Animation manager → Animation instance: creates instance
player/js/animation/AnimationManager.js - Animation instance → JSON data manager: loads data
player/js/animation/AnimationItem.js - JSON data manager → Worker bridge: offloads processing
- Animation instance → Renderer selection: selects renderer
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
player/js/renderers/CanvasRenderer.js - HTML renderer → HTML elements: renders elements
- Shape properties → Animated properties: uses properties
player/js/utils/shapes/ShapeProperty.js - Animation instance → Expressions: initializes expressions
- Animation instance → Image assets: preloads images
player/js/animation/AnimationItem.js - Animation instance → Font manager: waits for fonts
- Animation instance → Audio controller: controls audio
player/js/animation/AnimationItem.js - Audio controller → Howler audio: uses if available
player/js/utils/audio/AudioController.js - Effects → Animated properties: builds effect values
player/js/EffectsManager.js