SKN Framer Motion Type Extension Library

TypeScript React

 

Introduction:

This is a simple TypeScript Type Extension Library for Framer Motion 11, React 18 & also for Next.js 14

I made this library so that I can use it in all of my Next.js 14 projects without writing the same codes over and over again

 

Details:

Anime Type

• It provides total intellisense of framer motion styles in separate files to be used as variants
• This type will help to de-clutter your jsx/tsx components because you can create variants outside motion components and later use it inside the motion components
• This type will only work on motion components like motion.div, motion.span, motion.main etc. or any other custom motion components created with motion() function
• For usage instruction, see Usage section

CsxAnime Type

• It provides total intellisense of react csx styles in separate files and ensures compatibility with framer motion styles as well
• This type will help to de-clutter your jsx/tsx components because you can create csx styles outside motion components
• This type will only work on motion components like motion.div, motion.span, motion.main etc. or any other custom motion components created with motion() function
• For usage instruction, see Usage section

 

Use Case:

• React
• Next.js

 

Requirements:

This library has peer dependency for React & React DOM of minimum 18.3.1. It may or may not work on 19.x

It has peer dependency for Framer Motion of minimum 11.2.11. It may or may not work on 12.x

This library is intended to be used in Next.js of minimum 14.2.3. It may or may not work on 15.x

• 💀 Minimum react Version: 18.3.1
• 💀 Minimum @types/react Version: 18.3.3
• 💀 Minimum react-dom Version: 18.3.1
• 💀 Minimum @types/react-dom Version: 18.3.0
• 💀 Minimum next Version: 14.2.3
• 💀 Minimum framer-motion Version: 11.2.11

 

Complementary Libraries:

• @best-skn/react-types
• @best-skn/next-types

 

Usage:

To install the package, type the following in console

1npm add -D @best-skn/framer-types
2#or
3yarn add -D @best-skn/framer-types
4#or
5pnpm add -D @best-skn/framer-types
6#or
7bun add -D @best-skn/framer-types

Create a directory called types in the root location of your project, and create a file called motion.d.ts, then do this

1import "@best-skn/framer-types";

Check your tsconfig.json if includes property has **/*.ts, **/*.tsx otherwise the type definition file may not work

Now Inside your Next.js 14 Project, use the package like this (Just an example)

Anime Type:

(1) Motion style variants in separate file

1import type { Anime } from "framer-motion";
2
3type key = "container" | "box"; // * Create variant names here
4
5export const anime: Anime<key> = {
6  //* You'll get total intellisense for `variant` names
7  container: {
8    //* You'll get intellisense for motion styles inside `hidden` or `visible` properties
9    hidden: {
10      opacity: 0,
11      //* other motion styles here...
12    },
13    visible: {
14      opacity: 1,
15      //* other motion styles here...
16    },
17  },
18  box: {
19    hidden: {
20      opacity: 0,
21      //* other motion styles here...
22    },
23    visible: {
24      opacity: 1,
25      //* other motion styles here...
26    },
27  },
28};

(2) Import & use the created variants inside motion components in Next.js

1"use client"
2
3import { motion } from "framer-motion";
4import { anime } from "./anime.ts";
5
6const HomeComponent: React.FC<unknown> = () => {
7  return (
8    <motion.div
9      variants={anime.container} //* Put your variants here
10      initial="hidden"
11      animate="visible"
12    >
13      <motion.div
14        variants={anime.box} //* Put your variants here
15        initial="hidden"
16        animate="visible"
17      >
18        <!-- other elements here... -->
19      </motion.div>
20    </motion.div>
21  );
22};
23
24export default HomeComponent;

CsxAnime Type:

(1) React CSX styles with motion style compatibility in separate file

1import type { CsxAnime } from "framer-motion";
2
3type key = "container" | "box"; // * Create class names here
4
5export const csx: CsxAnime<key> = {
6  //* You'll get total intellisense for `class` names
7  container: {
8    //* You'll get intellisense for react css styles here
9    fontWeight: "bolder",
10    //* css styles here...
11
12    //* framer motion related styles
13    scaleX: "",
14  },
15  box: {
16    fontWeight: "bolder",
17    //* css styles here...
18
19    //* framer motion related styles
20    scaleX: "",
21  },
22};

(2) Import & use the created style inside motion components in Next.js

1"use client"
2
3import { motion } from "framer-motion";
4import { csx } from "./csx.ts";
5
6const HomeComponent: React.FC<unknown> = () => {
7  return (
8    <motion.div className={csx.container}>
9      <motion.div className={csx.box}>
10        <!-- other elements here... -->
11      </motion.div>
12    </motion.div>
13  );
14};
15
16export default HomeComponent;

 

Dedicated To:

• 👩‍⚕️Tanjila Hasan Trina: The long lost love of my life. The course of nature separated us from our paths and put us in separate places far away from each other. But no matter how separated we are right now, each and every moment of mine is only dedicated to you. We may not see each other in this lifetime as it seems but I will find you again in the next life. I just want to say: 世界は残酷だ それでも君を愛すよ
• 💯My Parents: The greatest treasures of my life ever.

 

License:

Copyright (C) 2024 SKN Shukhan

Licensed under the MIT License