react-textmotion ·

🚀 Animate text and UI elements effortlessly in React. Lightweight, fully tested, and production-ready.

react-textmotion is a lightweight yet powerful React library to animate text and components with ease.
From character-level typing effects to complex UI block animations, it provides intuitive APIs, presets, and full customizability through a single TextMotion component.

Features

• Lightweight & Performant – minimal footprint, no heavy deps
• Robust & Tested – 100% test coverage with Jest + React Testing Library
• Flexible API – animate by character or word, supporting both plain text and rich React nodes.
• Presets & Motion – use built-in effects or define your property values
• Developer-Friendly – JSDoc, examples, TypeScript support

Installation

npm install react-textmotion
# or
yarn add react-textmotion
# or
pnpm add react-textmotion

Quick Start

import { TextMotion } from 'react-textmotion';

export default function App() {
  return (
    <TextMotion split="character" preset={['fade-in', 'slide-up']}>
      Hello World!
    </TextMotion>
  );
}

Instantly animates "Hello World!" with fade + slide.

Components

TextMotion

Animate plain text strings or any React children (mixed tags, custom components, blocks) with per-character or word animations.

// Animating a plain string
<TextMotion
  split="character"
  trigger="scroll"
  repeat={false}
  initialDelay={0.5}
  animationOrder="first-to-last"
  motion={{
    fade: {
      variant: 'in',
      duration: 0.25,
      delay: 0.025,
      easing: 'linear',
    },
    slide: {
      variant: 'up',
      duration: 0.25,
      delay: 0.025,
      easing: 'linear',
    },
  }}
  onAnimationStart={() => console.log('Animation started')}
  onAnimationEnd={() => console.log('Animation ended')}
>
  Hello World!
</TextMotion>

// Animating mixed React nodes
<TextMotion
  as="span"
  split="word"
  trigger="on-load"
  initialDelay={0.5}
  animationOrder="first-to-last"
  preset={['fade-in', 'slide-up']}
  onAnimationStart={() => console.log('Animation started')}
  onAnimationEnd={() => console.log('Animation ended')}
>
  <span>Hello</span> <b>World!</b>
</TextMotion>

API Reference

TextMotion Props

| Prop | Type | Default | Required | Description | | ------------------ | ------------------------------------ | --------------- | ----------------------- | -------------------------------------------------------------------- | | children | ReactNode | - | Yes | Content to animate. Can be a string, a number, or any React element. | | as | string | "span" | No | HTML tag wrapper | | split | "character" \| "word" | "character" | No | Text split granularity. | | trigger | "on-load" \| "scroll" | "scroll" | No | When animation starts | | repeat | boolean | true | No | Repeat entire animation | | initialDelay | number | 0 | No | Initial delay before animation starts (in s) | | animationOrder | "first-to-last" \| "last-to-first" | first-to-last | No | Order of the animation sequence | | motion | Motion | - | Yes (if preset unset) | Custom animation config | | preset | Preset[] | - | Yes (if motion unset) | Predefined animation presets | | onAnimationStart | () => void | - | No | Callback function that is called when the animation starts | | onAnimationEnd | () => void | - | No | Callback function that is called when the animation ends |

Presets

react-textmotion simplifies animation creation with a set of predefined animation presets. These presets offer common animation patterns that you can use directly via the preset prop, or as inspiration for custom animations using the motion prop.

Here's a quick overview of the available animation types and their variants:

• fade: Controls the opacity of the elements.
  • fade-in: Elements appear by fading in.
  • fade-out: Elements disappear by fading out.
• slide: Moves elements in a specified direction.
  • slide-up: Elements slide upwards.
  • slide-down: Elements slide downwards.
  • slide-left: Elements slide to the left.
  • slide-right: Elements slide to the right.
• scale: Adjusts the size of the elements.
  • scale-in: Elements grow in size.
  • scale-out: Elements shrink in size.
• rotate: Rotates elements around their center.
  • rotate-clockwise: Elements rotate in a clockwise direction.
  • rotate-counterclockwise: Elements rotate in a counter-clockwise direction.
• bounce: Creates a bouncing effect.
  • bounce-in: Elements bounce into view.
  • bounce-out: Elements bounce out of view.
• elastic: Provides an elastic, spring-like movement.
  • elastic-in: Elements move into view with an elastic effect.
  • elastic-out: Elements move out of view with an elastic effect.
• flip: Flips elements along an axis.
  • flip-in: Elements flip into view.
  • flip-out: Elements flip out of view.

Testing & Quality

• 100% test coverage with Jest + React Testing Library
• GitHub Actions CI (build, lint, test, coverage)
• TypeScript definitions included

License

MIT © 2025 Donghyun Lee . For more details, see LICENSE