electerious/basicscroll

basicScroll is a small JavaScript library that lets web developers create scroll-driven animations on websites, for both desktop and mobile browsers. The core idea is simple: as the user scrolls down the page, the library watches how far they have scrolled and updates CSS variables accordingly. Those CSS variables can then be connected to any visual property in your stylesheet, so the animation logic stays in CSS rather than being hardcoded in JavaScript. The practical result is things like elements that fade in as they enter the viewport, text that moves at a different speed than the background to create a depth effect, or shapes that morph as the user scrolls. The library describes several live demo examples on CodePen, including a parallax scene with multiple moving layers, animated headline letters, and text that morphs using a CSS clipping technique. Using it requires some comfort with web development: you install it via npm or yarn (standard package management tools for JavaScript projects), then create instances in your JavaScript code by specifying which page element to watch, where the animation should start and stop relative to the viewport, and which CSS variable to change between which two values. The library handles the math and the timing, calling your CSS variable updates on every animation frame as the user scrolls. It does not depend on any framework like React or Vue, so it can be dropped into any web project. The README notes that it requires a few modern browser features, including CSS Custom Properties, which are not available in very old browsers. If you are a non-developer who received a link to this repository, basicScroll is a front-end utility for adding scroll animation effects to websites without writing complex animation code from scratch.