Versatile and extensible page transition library for server-rendered websites 🎉
Go to file
Rasso Hilber c7fdba3a15
Merge pull request #1007 from swup/dependabot/npm_and_yarn/npm_and_yarn-e04d5d616f
2025-07-22 08:29:57 +02:00
.github/workflows Merge branch 'main' into patch-2 2025-06-07 09:42:07 +02:00
.husky Upgrade husky setup 2024-09-24 15:06:46 +02:00
src Make swup outside contributor friendly 2025-06-07 07:41:26 +00:00
tests Handle empty array as `Path` in `matchPath` 2025-04-29 10:28:38 +02:00
.editorconfig update .editorconfig to include TS 2023-01-09 13:47:00 +01:00
.eslintrc.cjs Fix eslint errors 2023-11-21 00:16:17 +01:00
.eslintrc.compat.cjs Fix indentation in .eslintrc.compat.cjs 2025-06-07 07:41:26 +00:00
.gitignore Group and comment gitignore file 2023-09-05 20:21:38 +02:00
.nvmrc provide .nvmrc file to keep the node version consistent across maintainers 2023-01-11 23:50:55 +01:00
CHANGELOG.md Fix changelog release date 2025-04-29 13:01:29 +02:00
LICENSE Fixed error on empty page classes 2017-10-31 00:28:18 +01:00
README.md Fix link to third-party plugins 2025-06-28 10:29:43 +02:00
package-lock.json Bump form-data in the npm_and_yarn group across 1 directory 2025-07-21 23:08:07 +00:00
package.json Update package version 2025-04-29 10:02:43 +00:00
tsconfig.json Pass around the `Visit` object 2023-11-20 13:23:08 +01:00

README.md

swup 4 is released  🎉  Check out the release notes and upgrade guide.


swup

npm version Bundle size npm downloads Test status License


Swup

Versatile and extensible page transition library for server-rendered websites.

FeaturesDemosPluginsThemesDocumentationDiscussions

Overview

Swup adds page transitions to server-rendered websites. It manages the complete page load lifecycle and smoothly animates between the current and next page. In addition, it offers many other quality-of-life improvements like caching, smart preloading, native browser history and enhanced accessibility.

Make your site feel like a snappy single-page app — without any of the complexity.

Features

  • ✏️ Works out of the box with minimal markup
  • Auto-detects CSS transitions & animations for perfect timing
  • 🔗 Updates URLs and preserves native browser history
  • 🏓 Manages the scroll position between pages and anchor links
  • 🚀 Uses a cache to speed up subsequent page loads
  • 📡 Offers hooks to customize and extend the page load lifecycle
  • 🔌 Has a powerful plugin system and many official and third-party plugins
  • 🎨 Provides ready-to-go themes to get started quickly

Demos

Explore our interactive demos to see swup in action.

Documentation

Visit our official documentation to learn more.

Plugins

Swup is small by design. Extended features can be added via plugins:

Check out the list of official and third-party plugins.

Themes

Get started quickly with one of three official themes: fade, slide, and overlay.

Examples

Take a look at the interactive demos and sites using swup for more examples.

Having trouble?

If you're having trouble implementing swup, check out the Common Issues section of the docs, look at closed issues or create a new discussion.

Want to Contribute?

We're looking for maintainers!   👀

Become a sponsor on Open Collective or support development through GitHub sponsors.

This project is tested with BrowserStack.