What is vue-awesome-swiper?

surmon-china/vue-awesome-swiper — explained in plain English

Analysis updated 2026-06-24

★ 12,798JavaScriptAudience · developerComplexity · 2/5Setup · easy

Mindmap

mindmap
  root((repo))
    What it does
      Vue carousel wrapper
      Swiper integration
      Now deprecated v5
    Migration
      Use swiper/vue
      Legacy v2 to v4 branches
    Audience
      Vue developers
      Legacy codebases
    Setup
      npm install swiper
      Import components

mindmap root((repo)) What it does Vue carousel wrapper Swiper integration Now deprecated v5 Migration Use swiper/vue Legacy v2 to v4 branches Audience Vue developers Legacy codebases Setup npm install swiper Import components

Click or tap to explore — scroll the page freely

What do people build with it?

USE CASE 1

Add touch-friendly carousels to a Vue 3 app by migrating from vue-awesome-swiper to the official swiper/vue package

USE CASE 2

Maintain a legacy Vue 2 codebase that still depends on vue-awesome-swiper version 4 or earlier while planning an upgrade

What is it built with?

JavaScriptVue.jsSwiper

How does it compare?

	surmon-china/vue-awesome-swiper	cubiq/iscroll	mailcow/mailcow-dockerized
Stars	12,798	12,823	12,751
Language	JavaScript	JavaScript	JavaScript
Setup difficulty	easy	easy	hard
Complexity	2/5	2/5	4/5
Audience	developer	developer	ops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Project is deprecated, migrate to swiper/vue for long-term support, v5 is just a re-export of that package.

So what is it?

vue-awesome-swiper was a package that let Vue.js developers add touch-friendly slideshows and carousels to their web applications by wrapping a popular slider library called Swiper. Swiper is a standalone JavaScript library for creating smooth, touch-enabled slides, but wiring it into a Vue project requires some setup code. This package replaced that setup with ready-made Vue components you could drop directly into a template. The project is now deprecated. Swiper's maintainers released an official Vue component called swiper/vue, which removed the main reason for vue-awesome-swiper to exist. The final release of this package, version 5, does nothing more than re-export that official component, making the two functionally identical. The README advises migrating to swiper/vue as soon as possible for better long-term stability. If you are working with an older codebase that depends on version 4 or earlier, legacy branches are still available on GitHub. Version 4 supported Swiper 5 and 6 with Vue 2, version 3 supported Swiper 4 with Vue 2, and version 2 supported Swiper 3 with Vue 2. The current version 5 supports only Vue 3. For anyone still on this package, usage in version 5 is simple: install swiper and vue-awesome-swiper via npm or yarn, import the Swiper and SwiperSlide components, and place them in your Vue template with individual slides as child elements. All the configuration options and events from the underlying Swiper library pass through directly, so anything documented on the Swiper website applies here as well.

Copy-paste prompts

Prompt 1

I'm migrating a Vue 2 project from vue-awesome-swiper v4 to swiper/vue on Vue 3, show me a side-by-side diff of a basic carousel component in both APIs

Prompt 2

Set up a Vue 3 slideshow with auto-play, loop, and pagination dots using swiper/vue as a drop-in replacement for vue-awesome-swiper

Prompt 3

My codebase imports SwiperSlide from vue-awesome-swiper v5, generate a migration checklist to switch to the official swiper/vue package and remove the deprecated dependency

Frequently asked questions