Spirit
🙌 Play Spirit animations on the web
Install / Use
/learn @spirit/SpiritREADME
<p align="center">
<img src="https://spiritapp.io/banner.jpg" alt="Spirit" width="100%" />
</p>
<h1 align="center">Spirit ⚡️ Web Player</h1>
<p align="center">
<a href="https://travis-ci.org/spirit/spirit">
<img src="https://img.shields.io/travis/spirit/spirit.svg" alt="travis" />
</a>
<a href="https://npmjs.org/package/spiritjs">
<img src="https://img.shields.io/npm/v/spiritjs.svg" alt="version" />
</a>
<a href="https://greensock.com/gsap">
<img src="https://img.shields.io/badge/gsap-v3+-brightgreen.svg" alt="greensock" />
</a>
<a href="https://npmjs.org/package/spiritjs">
<img src="https://img.shields.io/npm/dm/spiritjs.svg" alt="downloads" />
</a>
<a href="https://github.com/spirit/spirit/releases/latest">
<img src="https://img.shields.io/github/release-date/spirit/spirit.svg" alt="release" />
</a>
</p>
<p align="center">
<b>Lightweight and easy to use</b>
<br />
<sub>Play your animations on the web<sub>
</p>
Getting Started:
Browser:
<svg>
<g id="container">
<path d="..." data-spirit-id="body" />
<path d="..." data-spirit-id="mouth" />
<path d="..." data-spirit-id="legs" />
</g>
</svg>
<script src="https://unpkg.com/spiritjs/dist/spirit.min.js"></script>
<script>
spirit
.loadAnimation({
path: './animation.json',
container: document.getElementById('container'),
})
.then(timeline => timeline.play());
</script>
Node:
install:
npm install spiritjs --save
Usage:
// load GSAP from CDN
import spirit from 'spiritjs';
spirit.loadAnimation({ path: './animation.json' }).then(timeline => timeline.play());
// use existing GSAP instance
import gsap from 'gsap';
import spirit from 'spiritjs';
spirit.setup(gsap).then(() => {
spirit.loadAnimation({ path: './animation.json' }).then(timeline => timeline.play());
});
For more info check out the API Documentation.
Links
- Documentation - What is Spirit
- Documentation - Install Web Player
- Documentation - Simple Usage
- Documentation - Extended Usage
