Alpine.js 3.16.2

Remember when Alpine.js was just a few kilobytes of vanilla-JS magic for sprinkling interactivity onto server-rendered pages? Version 3.16.2, released August 17, 2026, keeps that spirit alive while quietly hardening the persist plugin and re-basing its reactivity core on Vue 3.5.

The 3.x line has spent the last several years proving that you don't need a full SPA framework to get reactive UI. What began in 2019 as a lightweight alternative to jQuery-era DOM manipulation is now the glue layer for countless Blade, Twig, and plain HTML projects — and releases like this one are about keeping that glue from cracking under real-world usage.

The Long Arc

Alpine's journey has been consistent: stay small, stay dependency-light, and make the x-data/x-bind/x-on trio feel inevitable. Where earlier versions leaned on a homegrown reactivity engine, the modern 3.x releases borrow the battle-tested @vue/reactivity package. That choice is what makes 3.16.2's internals upgrade — from Vue's reactivity core to the Vue 3.5 line — a quiet but meaningful step, keeping the engine aligned with one of the most heavily audited reactivity implementations in the JavaScript ecosystem.

What's Changed

• Persist plugin fixes — Fallback storage no longer returns undefined for missing keys (#4867), and the plugin now refuses to persist undefined values altogether (#4876).
• Effect ordering — Structural effects now run before dependent effects, closing a class of timing bugs where DOM structure updates raced their dependents (#4878).
• Reactivity core bump — @vue/reactivity upgraded to the Vue 3.5 series (#4861).

What It Means

For the average Alpine user, this is a stability release in the truest sense: no new directives, no new magic properties, no breaking changes — just the machinery underneath running more predictably. The persist-plugin corrections matter most to anyone storing UI state in localStorage or sessionStorage, where the old behaviour could leave undefined written back into storage.

Three new contributors — hamdyelbatal122, Xuepoo, and oddvalue — made their first commits in this release, a reminder that the project's small core still attracts fresh hands.

Alpine.js 3.16.2 is available now via npm ([email protected]) or the CDN.