swup/swup

Health v2 · maintenance only

Adoption not part of the score

5220 stars · 199 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

Swup is a versatile and extensible page transition library for server-rendered websites, written in TypeScript. It intercepts link clicks, loads pages in the background, and smoothly animates between old and new content while managing caching, preloading, browser history, scroll position, and accessibility.

Use cases

• add smooth page transitions to a server-rendered website
• make a multi-page site feel like a single-page app
• animate between pages using CSS transitions or the View Transitions API
• cache and preload pages to speed up navigation
• preserve browser history and scroll position during animated navigation
• replace only content containers instead of full page reloads
• animate form submissions or build infinite scroll with transitions

When to choose

• you have a server-rendered (MPA) site and want SPA-like transitions without a full framework
• you want minimal markup and automatic CSS animation timing detection
• you need a small, modular core with a rich plugin and theme ecosystem
• you want native browser history, caching, and preloading out of the box

When to avoid

• you are building a full SPA with React, Vue, or similar — their built-in routers handle transitions
• you need server-side rendering or client-side state management rather than page-to-page transitions
• your site relies heavily on full-page scripts that re-execute on every load without adaptation

Facets

library · maturity stable

animation routing caching plugin-system middleware web-development frontend web-design browser page-transitions view-transitions server-rendered spa-feel typescript progressive-enhancement nodejs web-server

Member repositories

For agents

markdown · JSON · MCP: product_card(name="swup/swup")