A set of React components for animating elements as they scroll into the viewport

Made by Kitze
kitze.io · X · YouTube

More projects by Kitze

Zero To Shipped A full-stack starter kit for web and mobile apps.	Sotto Voice-to-text for macOS. Local AI, one-time purchase.	Tinkerer Club A private community for builders, self-hosters, and AI tinkerers.
Sizzy The browser for web developers.	Supermac A macOS command center for everyday workflows.	DMX A focused desktop client for X.

Support this project

 

Sponsors

Postiz Schedule social posts with AI agents.	FounderStack A SaaS stack for your business, without subscriptions.	Matte 3D mockups, screen recordings, and video editing.
HTML/CSS to Image Turn HTML/CSS into images, PDFs, and screenshots.	NameMyVenti Get your brand shouted out at Starbucks.

---

🧞‍♂️ react-genie

🙋‍♂️ Made by @thekitze

Other projects:

• 💻 Sizzy - A browser for designers and developers, focused on responsive design
• 🏫 React Academy - Interactive React and GraphQL workshops
• 🔮 Glink - Changelogs, Roadmap, User Requests
• 🐶 Benji - Ultimate wellness and productivity platform
• 🤖 JSUI - A powerful UI toolkit for managing JavaScript apps
• 📹 YouTube Vlog - Follow my journey

Used on sizzy.co

CodeSandbox

https://codesandbox.io/s/react-genie-example-8xfsc

Demo

https://8xfsc.csb.app/

Dependencies

• styled-components
• layout-styled-components
• react-animations
• react-intersection-observer

Usage

yarn add react-genie

Just render the RevealGlobalStyles component anywhere, so it will add the class names for the animations:

import {RevealGlobalStyles} from 'react-genie'

const App = () => {
  return (
    <div>
      <RevealGlobalStyles />
      <div> rest of the app </div>
    </div>
  );
};

Default animation:

import {Reveal} from 'react-genie';

<Reveal>
  <h1>The default animation is fade in</h1>
</Reveal>

Props:

{
  animation?: string; // animation class name
  delay?: number; // animation delay
  mode?: RevealMode; // "clone" or "wrap"
  debugName?: string; // if you specify it, you will get console logs
  style?: CSSObject; // extra styles
  onShowDone?: () => void; // callback after show
}

Specifying animation using the animation prop:

import {Reveal, Animation} from 'react-genie';

<Reveal animation={Animation.SlideInLeft}>
  <h1>This title will slide in from the left</h1>
</Reveal>

Hint: you can also pass your own class name here if you have custom animations.

Wrap vs Clone

The default mode is wrap, so the children element will be wrapped in an additional div. If you don't want that additional div, you can use clone or RevealMode.Clone.

import {Reveal, RevealMode} from 'react-genie';

<Reveal mode={RevealMode.Clone}>
  <h1>This h1 will be cloned instead of wrapped</h1>
</Reveal>

In order for clone to work your element needs to accept className, style, and ref, as props. So, if you're trying to clone custom components, make sure they support these props.

The AnimatedTitle component

import {Reveal, AnimatedTitle} from 'react-genie';

<AnimatedTitle>
  This sentence will animate in word by word
</AnimatedTitle>

The AnimatedTitle component will split the children prop word by word (so it should be a string), and animate each word with a delay in between.

---

More projects by Kitze

Apps & tools

gifs.so Search, copy, and download reaction GIFs.	Glink Feedback, roadmaps, changelogs, and discussions.	Benji Tasks, habits, calendar, health, and routines in one place.
Perkz Sell and manage access to private GitHub repositories.	JustWrite Distraction-free writing sprints for macOS, with time or word-count goals.	Releaseflow App updates and downloads.
Passlock A macOS password manager with time locks and unlock challenges.

Open source

Skillbox A self-hosted, versioned skills library for AI agents.	Unclutter Remove page clutter with AI-powered, reusable browser rules.	PageGrade Grade page clarity, writing, and on-page SEO.
Council Let your coding agents deliberate together before making a plan.	CodexMaxx Manage Codex accounts, usage, and active sessions on macOS.	React Hanger A collection of useful React hooks.
React Genie Animate React elements as they enter the viewport.	MobX Router A simple router for MobX and React apps.

All projects · GitHub · Follow on X · YouTube