On GitHub, tholman/cursor-effects has picked up 4.1k stars, Image Tools, JavaScript. Old-school cursor effects for your browser built with modern JavaScript
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
"Knowing the codes" used to be all the rage, I want to bring a few back.
A repo of the old effects that inspired creativity and the desire to learn at least a little code around the world. Modernised so they're a little more efficient, and just as annoying (and twice as fun) as they were before. Have a play here.
The current effects are:
Rainbow Cursor
Emoji Rain
Elastic Emoji
Ghost Following
Trailing Cursor
Text Flag Cursor
Following Dot
Bubbles Particles
Snowflake Particles
Fairy Dust
Clock Cursor
Character Cursor
How to Set Up Locally/Develop
First the packages request (this is only rollup, which code compilation) with npm install
npm run watch This will compile the src in the dist folder that index.html is looking for and update it when changes are made. You can then go to index.html in the web browser of your choice.
How to Use
You need to include the following script tag in your webpage (see next section if you want to use this package via npm). And then, once the script is loaded you'll be able to add the effects to the page
Alternatively you can use a type="module" script on newer browsers with a import statement, if you are using the esm module you will import the cursor specific to your needs, rather than having to use the cursoreffects.x style.
<script type="module">
import { fairyDustCursor } from "https://unpkg.com/cursor-effects@latest/dist/esm.js";
new fairyDustCursor();
</script>
And then create a new instance of its type in your JavaScript. The script will create the canvas that is used, so nothing else is really needed.
window.addEventListener("load", (event) => {
new cursoreffects.ghostCursor();
});
You can also target specific elements, to have the canvas appear inside those, for example:
const targetElement = document.querySelector("#ghost");
new cursoreffects.ghostCursor({ element: targetElement });
To remove the effect, you can call destroy on it.
// Create
let cursorEffect = new ghostCursor();
// Destroy
cursorEffect.destroy();
or you can use NPM
npm install cursor-effects
import { emojiCursor } from "cursor-effects";
new emojiCursor({ emoji: ["🔥", "🐬", "🦆"] });
Specific Customization
A few of these have custom options as well (if you are interested in more options, opening an issue or PR is the way to go).
ghostCursor
You can change the cursor image in ghostCursor
new cursoreffects.ghostCursor(
{image:"https://www.cursor.cc/cursor/820/63/cursor.png"}
);
});
rainbowCursor
You can change the colors, size and length in rainbowCursor
new cursoreffects.rainbowCursor({
length: 3,
colors: ["red", "blue"],
size: 4,
});
springyEmojiCursor
You can change the emoji in springyEmojiCursor's emoji with the emoji a single string emoji.
new cursoreffects.springyEmojiCursor({ emoji: "🤷♂️" });
bubbleCursor
You can change the fill and stroke/border of the bubbles in bubbleCursor with the fillColor & strokeColor options
new cursoreffects.bubbleCursor({
fillColor: "#f771b4",
strokeColor: "#e6f1f7",
});
fairyDustCursor
You can customize the fairyDustCursor by using the fairySymbol option to change the emoji, and the colors option (an array) to define its trail colors.
new cursoreffects.fairyDustCursor({
colors: ["#ff0000", "#00ff00", "#0000ff"],
fairySymbol: "★",
});
emojiCursor
You can change the emoji in emojiCursor's emoji with the emoji option (a list of emoji),
and delay between emoji with the delay option (defaults to 16)
new cursoreffects.emojiCursor({ emoji: ["🔥", "🐬", "🦆"], delay: 25 });
textFlag
You can change the textFlag's text with the text option (String),
and color of the text with the color option (hex)
new textFlag({ text: "test", color: ["#FF6800"] });
Accessibility
The cursor won't display if the user's system accessibility settings have prefers-reduced-motion enabled.
trailingCursor
You can change the number of trail steps in trailingCursor with the particles option (a number), the rate of the trail with the rate option (a number between 0 and 1, default is 0.4), and the trailing cursor image with the baseImageSrc option (a URL or base64 string)
new cursoreffects.trailingCursor({
particles: 15,
rate: 0.8,
baseImageSrc: "data:image/png;base64,iVB...",
});
You can change the color of the following dot in followingDotCursor with the color option (hex)
new cursoreffects.followingDotCursor({ color: ["#323232a6"] });
characterCursor
Consider this cursor as an extension of the snowflake cursor, but instead of the snowflake emoji you can specify a list of characters and colors to use as well as defining how the character's velocity, rotation and scaling should change over the characters lifespan. For example to produce the same effect you see in the demo page, you would use this. (It will also do this by default, but this is a great way to experiement and play around with the effect)
Note that none of these behavior changing options are required but in that case it will use similar physics to the snowflake and use the asterisk character instead.
License
MIT af, but if you're using the scripts a GitHub sponsorship or shouting me a coffee would always be appreciated :)
How active is development on tholman/cursor-effects?
The most recent commit recorded on tholman/cursor-effects was 8 months ago, based on the GitHub push timestamp. The repository has 272 forks — one of the better signals of community interest.
How many stars does tholman/cursor-effects have?
tholman/cursor-effects has 4.1k GitHub stars — refresh the page for the live number, or check github.com/tholman/cursor-effects. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What else is in the Image Tools space?
tholman/cursor-effects is tracked by TopGit under the Image Tools category, alongside 4 GitHub-tagged topics. Trending and Topics pages list peer repositories of comparable stars and language.
What language is tholman/cursor-effects written in?
tholman/cursor-effects is written primarily in JavaScript. GitHub's language field is based on the largest share of bytes in the default branch.
What topics is tholman/cursor-effects associated with?
GitHub's repository topics for tholman/cursor-effects: "90s", "canvas", "javascript", "library". TopGit's editorial category is Image Tools.
Where do I read more about tholman/cursor-effects?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/tholman/cursor-effects is the definitive source.
Why is tholman/cursor-effects categorized under Image Tools?
TopGit places tholman/cursor-effects in the Image Tools category based on its GitHub topics and description (tagged: "90s", "canvas", "javascript"). Categories are assigned from real repository metadata, not editorial guesswork.
Read full README in the tab above.
Is cursor-effects worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of cursor-effects.