# @galacean/engine-lottie

> Lottie runtime of oasis engine

Latest version **1.5.1** (published 2025-09-25) · 0 weekly downloads

## Install

```sh
npm install @galacean/engine-lottie
pnpm add @galacean/engine-lottie
yarn add @galacean/engine-lottie
bun add @galacean/engine-lottie
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 1.5.1 |
| Published | 2025-09-25 |
| First published | 2023-04-10 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 1 |
| Unpacked size | 536.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | yiqi, imchenjian, chengkong.zxx, eyworldwide, yinjie, ruimeng.su, gl3336563, zhanyingwei, zhuxudong, johanzhu, mrkou47, husong, luzhuang, jujie, feyabibi |

## Links

- npm: https://www.npmjs.com/package/@galacean/engine-lottie
- Repository: https://github.com/galacean/engine-lottie
- Homepage: https://github.com/galacean/engine-lottie#readme
- Issues: https://github.com/galacean/engine-lottie/issues
- npm.io page: https://npm.io/package/@galacean/engine-lottie

## Dependencies (1)

- [bezier-easing](https://npm.io/package/bezier-easing.md) ^2.1.0

## Recent versions

- 1.5.1 (latest) — 2025-09-25
- 1.6.3 (engine-1.6) — 2026-07-07
- 1.4.5 (engine-1.4) — 2025-12-10
- 1.5.2 (engine-1.5) — 2025-12-09
- 1.1.4 (engine-1.1) — 2025-05-14
- 1.4.0-alpha.5 (alpha) — 2025-04-27
- 1.1.1 (engine-1.3) — 2024-11-27
- 1.1.0-beta.1 (beta) — 2024-10-02
- 1.4.4 — 2025-12-09
- 1.6.2 — 2025-12-09
- 1.4.3 — 2025-12-09
- 1.6.1 — 2025-09-25
- 1.6.0 — 2025-09-17
- 1.5.0 — 2025-05-22
- 1.2.0 — 2025-05-14
- … 38 more at https://npm.io/package/@galacean/engine-lottie/versions

## README

# Galacean Lottie

<a href="https://www.npmjs.com/package/@galacean/engine-lottie"><img src="https://img.shields.io/npm/v/@galacean/engine"/></a>
![npm-size](https://img.shields.io/bundlephobia/minzip/@galacean/engine-lottie)
![npm-download](https://img.shields.io/npm/dm/@galacean/engine-lottie)

This is a [lottie](https://airbnb.io/lottie) runtime created by [Galacean Engine](https://github.com/galacean/engine). It is high-performance owing to drawing all sprites in batch, which is different from svg or canvas renderer of [lottie-web](https://github.com/airbnb/lottie-web).

See more info: [documentation](https://galacean.antgroup.com/engine/docs/graphics/2D/lottie/)

## Features
- [x] Sprite element: transform and opacity animation.
- [x] Text element
- [x] 3D rotation: rotate element in 3D space.
- [x] Animation clip: play animation clip.

#### TODO
- [ ] Sprite mask
- [ ] Shape element
- [ ] Expression

## Usage

See: https://galacean.antgroup.com/engine/docs/graphics/2D/lottie/

## Install

```bash
npm i @galacean/engine-lottie --save
```

## Contributing
Everyone is welcome to create issues or submit pull requests. Make sure to read the [Contributing Guide](https://github.com/galacean/engine/blob/main/.github/HOW_TO_CONTRIBUTE.md) before submitting changes.

## Dev

1.Clone this repository and install the dependencies:

```bash
npm i
```

2.Run the example:

```bash
npm run example
```
## License

MIT

---
_Source: https://npm.io/package/@galacean/engine-lottie · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._