What is wobble?

Wobble is a tiny animation library that makes things move and bounce in a natural, realistic way. Instead of objects jumping instantly to a new position, wobble simulates how a real spring would behave, it stretches, overshoots a bit, then settles down with a satisfying bounce. You use it to add physics-based motion to anything in your app: a button expanding when clicked, a slider snapping to a value, a menu sliding in, or any value you want to animate smoothly. The magic happens because wobble uses real physics equations that describe how damped springs actually work. Rather than calculating motion frame-by-frame (the way many animation libraries do), it solves the math problem upfront and can tell you exactly where something should be at any point in time. This approach, borrowed directly from how Apple animates things on iPhone and Mac, is faster, more accurate, and lets you build smooth, interruptible animations. You control four knobs: stiffness (how tight the spring is), damping (how much friction slows it down), mass (how heavy the object is), and initial velocity (whether it starts moving). Tweak these and you get everything from a snappy, springy feel to a slow, heavy bounce. Anyone building interactive web or mobile interfaces could use this. A designer implementing a polished UI in React might use wobble to make a modal pop onto screen with a bounce. A game developer might use it for camera movement or character animations. A dashboard might use it to smoothly animate between data values. The library is only 1.7 KB compressed, so small it won't bloat your bundle, and it handles only one job: animating a single number from point A to point B with spring physics. You plug it into your animation loop, listen for updates, and move your visual elements based on the values it gives you each frame. The README is honest about what this library won't do: there's no built-in integration with React or Vue, no multi-dimensional springs (just single numbers), and no helper for chaining springs together. That's intentional. The author kept the scope minimal so the library stays tiny and focused, letting you build exactly the abstraction you need on top of it rather than forcing their opinions on you.