starfall-animation
v1.0.11
Published
Animation package like Canva's starfall animation for HTML, VanillaJS, React and Typescript Projects
Downloads
21
Maintainers
mahbubdevReadme
starfall-animation
A simple animation package like popular image editor Canva's starfall animation Usable in HTML, VanillaJS, React and Typescript Projects.
Demo Video
Click on below image to watch the video 👇
starfall-animation is simillar to popular image editor website Canva's Starfall Animation. You can use this package on HTML, VanillaJS, React and Typescript Projects by following our documentation from below.
This package is fully customizable that means you can change any style as you want. You can also use it with CSS framework like Tailwind/Bootstrap.
Documentation
Installation
npm install starfall-animationor
yarn add starfall-animationUsage
How to use starfall-animation on HTML/CSS/JS projects?
Wait you can't use starfall-animation directly on HTML/CSS/JS projects.
You need to create a Vanilla project using this command npm create vite@latest
HTML or VanillaJS Example
index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>starfall-animation Example</title>
</head>
<body>
<div style="height: 500px; width: 500px;margin: 0 auto;" id="starfall">
</div>
<script type="module">
import { starfall } from "starfall-animation";
import 'starfall-animation/style.css';
starfall();
</script>
</body>
</html>HTML VanillaJS Example Explanation
In this example, used vite to create a vanilla project.
Installed the starfall-animation package using npm i starfall-animation
After that, we created a div with starfall id because our package depends on this id and work with only this id.
Then we added:
<script type="module">
import { starfall } from "starfall-animation";
import 'starfall-animation/style.css';
starfall();
</script>
before </body> tag of our index.html and imported necessary resources from our package.
Then we called starfall() function and voilla it works like a charm.
React or Typescript Example
Make sure to remove <React.StrictMode> from main.jsx otherwise this will render 2 times or double stars
App.jsx or App.tsx
import { useEffect } from 'react'
import { starfall } from 'starfall-animation'
import 'starfall-animation/style.css'
function App() {
useEffect(() => {
const faKitUploadElement = document.getElementById('fa-kit-upload');
if (!faKitUploadElement) {
starfall();
}
}, []);
return (
<div style={{ height: '500px', width: '500px', background: 'linear-gradient(145deg, rgb(119, 46, 195), rgb(58, 18, 153))', }} id="starfall">
</div>
)
}
export default App
Here I am calling starfall() function inside useEffect() And created a div using starfall id to inject the styles inside it. Our package depends on this id and work with only this id.
Customize Styles
To add your custom style you need to comment out default style which you have imported
<!-- import 'starfall-animation/style.css' -->
Then add below style.css to your index.html/App.jsx/App.tsx and change the css color or other properties as you wish
style.css
#starfall {
--glow-rgb: 239 42 201;
background: linear-gradient(145deg, rgb(119, 46, 195), rgb(58, 18, 153));
height: 100vh;
overflow: hidden;
}
#starfall * {
margin: 0;
padding: 0;
box-sizing: border-box;
}
#starfall .glow-point {
position: absolute;
box-shadow: 0rem 0rem 1.2rem 0.6rem rgb(var(--glow-rgb));
pointer-events: none;
}
#starfall .star {
position: absolute;
z-index: 2;
color: white;
font-size: 1rem;
animation-duration: 1500ms;
animation-fill-mode: forwards;
pointer-events: none;
}
@keyframes fall-1 {
0% {
transform: translate(0px, 0px) rotateX(45deg) rotateY(30deg) rotateZ(0deg) scale(0.25);
opacity: 0;
}
5% {
transform: translate(10px, -10px) rotateX(45deg) rotateY(30deg) rotateZ(0deg) scale(1);
opacity: 1;
}
100% {
transform: translate(25px, 200px) rotateX(180deg) rotateY(270deg) rotateZ(90deg) scale(1);
opacity: 0;
}
}
@keyframes fall-2 {
0% {
transform: translate(0px, 0px) rotateX(-20deg) rotateY(10deg) scale(0.25);
opacity: 0;
}
10% {
transform: translate(-10px, -5px) rotateX(-20deg) rotateY(10deg) scale(1);
opacity: 1;
}
100% {
transform: translate(-10px, 160px) rotateX(-90deg) rotateY(45deg) scale(0.25);
opacity: 0;
}
}
@keyframes fall-3 {
0% {
transform: translate(0px, 0px) rotateX(0deg) rotateY(45deg) scale(0.5);
opacity: 0;
}
15% {
transform: translate(7px, 5px) rotateX(0deg) rotateY(45deg) scale(1);
opacity: 1;
}
100% {
transform: translate(20px, 120px) rotateX(-180deg) rotateY(-90deg) scale(0.5);
opacity: 0;
}
}Contributions
If you want to contribute to this project,fork the repository and clone it to your local machine. Commit your changes and push your changes to your forked repository. Finally, open a pull request with a detailed description of your changes. I highly appreciate any contributions.
Special thanks to Hyperplexed who indirectly contributed on this project.
Issues
If you are facing any problem feel free to share here
Our Community
You can also post your problems in our community for any kind of support 👨💻
TechHelpBD is one of the best technology based knowledge sharing Community ► Like Our Facebook Page=>https://facebook.com/TechHelpBD ► Join Our Facebook Group=>https://facebook.com/groups/TechHelpBangladesh ► Join Our Telegram Group=>https://t.me/TechHelpBangladesh ► Join Our Discord Server=>https://discord.gg/FFyVXZze4F ► Join Our Whatsapp Group=>https://chat.whatsapp.com/KsnXhnqsG9g3lxXE6nMheE ► Subscribe Our YouTube Channel=>https://youtube.com/TechHelpBangladesh 🌐Our Official Website: https://TechHelpBD.com
We recommend you to post your problems on our Facebook group and Github repo issues section first to get early response.
Support Me
☕ Buy Me a Coffee: https://buymeacoffee.com/MahbubDev
Hire Me
❒ Fiverr: https://cutt.ly/owHcCvkR ❒ UpWork: https://upwork.com/freelancers/~0165010699ff14d094