lottie README

The project's README from github.com/diffusionstudio/lottie. As one markdown file: README.md.

Text to Lottie

English | 繁體中文

Text-to-lottie is an open-source framework for generating production ready Lottie animations with claude code/codex or any other coding agent supporting skills.

Created with Text-to-Lottie

Quick Start

Install the skill:

npx skills add diffusionstudio/lottie

Then ask your coding agent to generate a Lottie animation using text-to-lottie.

Example prompt:

Create a Lottie animation from the SVG path in https://github.com/JaceThings/SF-Hello/blob/main/SVG/hello-en.svg. Reveal the path with an animation that follows the natural path direction. Apply a premium apple themed gradient to the path. Use ease-in-out timing, a transparent background, and preserve the original SVG geometry.

The agent sets up the workspace and the included player, where each animation lives as a scene inside a project. Scenes load automatically from public/projects/<project>/<scene>/lottie.json and live-update in the player as the agent edits them — so you can inspect, scrub, and refine the generated Lottie in real time.

Prompt guide

1. Ground the model

Provide SVGs, real-world data, or screenshots whenever possible. Results are significantly better when the animation is based on concrete assets.

2. Use motion design terminology

Describe timing and movement using motion design language like ease-in, ease-out, and ease-in-out.

3. Think like a camera operator

Professional motion graphics often rely on camera movement. Include camera pushes, pans, zooms, and rig-like motion in your prompt.

4. Request the controls you need

By default, outputs usually only expose a background color control. If you want to customize other properties, explicitly ask the agent to create controls for them.

5. Specify FPS and duration

If your animation requires a specific frame rate or length, include the desired FPS and total frame count in the prompt.

Using the Generated Animation

Generated animations can be used directly as Lottie JSON files or imported into After Effects for further refinement.

Web / vanilla HTML

<script src="https://unpkg.com/lottie-web/build/player/lottie.min.js"></script>

<div id="anim"></div>

<script>
  lottie.loadAnimation({
    container: document.getElementById("anim"),
    renderer: "svg",
    loop: true,
    autoplay: true,
    path: "/animations/my-animation.json"
  });
</script>

React Native

Use React Native Skia to render Lottie animations via its Skottie module. It supports iOS, Android, and web, and lets you customize animation properties, assets, and typographies at runtime.

import { Skia, Canvas, Skottie, useClock } from "@shopify/react-native-skia";
import { useDerivedValue } from "react-native-reanimated";

const animation = Skia.Skottie.Make(JSON.stringify(require("./animation.json")));

export default function Loader() {
  const clock = useClock();
  const frame = useDerivedValue(
    () => ((clock.value / 1000) % animation.duration()) * animation.fps()
  );
  return (
    <Canvas style={{ width: 200, height: 200 }}>
      <Skottie animation={animation} frame={frame} />
    </Canvas>
  );
}

iOS Swift

import Lottie

let animationView = LottieAnimationView(name: "animation")
animationView.frame = view.bounds
animationView.contentMode = .scaleAspectFit
animationView.loopMode = .loop
view.addSubview(animationView)
animationView.play()

Android Kotlin

val view = findViewById<LottieAnimationView>(R.id.animationView)
view.setAnimation(R.raw.animation)
view.loop(true)
view.playAnimation()

Flutter

dependencies:
  lottie: ^1.0.0

import 'package:lottie/lottie.dart';

Lottie.asset('assets/animation.json')

lottie (diffusionstudio/lottie)

Searching Database…

5.6K ·GitHub
Lottie
Что это?Text-to-Lottie — это фреймворк с открытым исходным кодом, который позволяет создавать готовые для продакшена анимации Lottie. Вы описываете нужную анимацию обычным языком в Claude Code, Codex или любом другом кодинговом агенте, который поддерживает навыки.
Это плагин для моего кодингового агента или полноценное приложение для анимации?Это навык для агента и небольшое рабочее пространство с плеером. Навык учит кодингового агента создавать JSON-файлы Lottie, а входящий в комплект плеер в реальном времени показывает сцены, которые агент генерирует в public/projects/.
Какие кодинговые агенты поддерживаются?Прямо упомянуты Claude Code и Codex, но навык работает с любым кодинговым агентом, который поддерживает формат навыков. Это его единственное реальное требование.
Могу ли я полностью управлять анимацией сразу после установки?По умолчанию нет. Сгенерированные анимации обычно предоставляют только управление цветом фона, поэтому, чтобы менять любое другое свойство, нужно прямо попросить агента добавить для него элементы управления.
Где можно использовать сгенерированные файлы Lottie?Результат — стандартный JSON Lottie. Его можно напрямую использовать в вебе на обычном HTML, в React Native через модуль Skottie, нативно в iOS на Swift и Android на Kotlin, во Flutter или заново импортировать в After Effects для дальнейшей правки.
Как получить более качественный результат от агента?Опирайтесь в запросах на реальные SVG, скриншоты или данные, используйте терминологию моушн-дизайна, например ease-in/ease-out, мыслите категориями камеры, такими как наезды, панорамы и зумы, и явно указывайте FPS и длительность.
Можно ли редактировать сгенерированную анимацию в After Effects?Да, сгенерированные JSON-файлы Lottie можно напрямую импортировать в After Effects для дальнейшей доработки.
Нужно ли что-то дополнительно для воспроизведения результата в React Native?Для воспроизведения там используется модуль Skottie из React Native Skia. Он отрисовывает Lottie на iOS, Android и в вебе и позволяет настраивать свойства, ресурсы и типографику во время выполнения.
What are similar projects?guizang-product-video-skill, lottie-web, herk-edit-kit, skills, livecanvas, onetake, skills, hairline
Which topics is it in?svg-animation, motion-design, shadcn, motion-graphics, flutter, react-native, agent-skill, svg, tailwindcss, vite, wasm, design
Creator
diffusionstudio
Size
4.9 MB
Stars
5.6K
Updated
CommitJul 25Releasev1.0.0Jun 15
Age
4mo
Commits · 90 Days