Skip to content
Get packs

vue-awesome-swiper

Vue wrapper for the Swiper slider component. Now deprecated and archived.

GitHub Download v5.0.0
Stars
12.8k
Forks
1.9k
Licence
MIT
Language
JavaScript
Last update
3.9 years ago
Type
Library

This repository is archived and no longer maintained.

What it is

vue-awesome-swiper is a Vue component package that lets developers add touch-friendly image or content carousels (sliders) to Vue apps by wrapping the Swiper library. The project is archived and officially deprecated. Its v5 release only re-exports Swiper's own Vue component, so new projects are directed to use swiper/vue directly.

  • Add a carousel with pagination dots to a Vue 3 page using the Swiper and SwiperSlide components
  • Add autoplay or disable touch movement through the component's options, as shown in the README
  • Listen for Swiper events such as slide changes through component event bindings

Great for

  • Teams maintaining an existing Vue 3 app that already uses vue-awesome-swiper v5 and need a bridge while migrating
  • Developers who want to see how Swiper components are wired into Vue 3 templates
  • Maintainers who plan to fork the code and keep a private copy

Not ideal for

  • New projects: the README says it is deprecated and recommends the official Swiper Vue component instead
  • Vue 2 projects: v5 only supports Vue 3; older Vue 2 versions are listed as legacy releases
  • Anyone needing ongoing updates or bug fixes, since the repository is archived and last pushed in December 2022

How to get it

  1. 1

    Install with a package manager

    You'll need: Node.js and npm or yarn · Vue 3 project

    Install with npm

    npm install swiper vue-awesome-swiper --save

    Install with yarn

    yarn add swiper vue-awesome-swiper
  2. 2

    Run it

    • Install swiper and vue-awesome-swiper with npm or yarn
    • Import Swiper and SwiperSlide from vue-awesome-swiper in a Vue component
    • Import the swiper CSS and any module styles such as pagination
    • Place swiper-slide elements inside the swiper component and pass modules as a prop
  3. 3

    Get the most out of it

    • Check the official Swiper Vue documentation for the current API, since this package just re-exports it
    • Pass Swiper options such as autoplay or slides-per-view as props, as the Component API section shows
    • Use the container-start, wrapper-start, wrapper-end and container-end slots to add custom markup
    • Plan a migration to the official swiper/vue import path, which the README describes as equivalent

Downloads

Source code (.zip)main branch · straight from GitHubRelease v5.0.0Release notes and sourceOfficial website & docsgithub.surmon.me/vue-awesome-swiper

Strengths

  • Built on Swiper, a widely used slider library with many modules
  • The README shows simple template-based usage with clear install steps
  • MIT license permits forking and reuse

Trade-offs

  • Archived and deprecated, so it will not receive new fixes
  • v5 is not compatible with earlier versions, so upgrading older code takes rework
  • Its main value is as a thin re-export, so most real questions go to the Swiper documentation

How it compares

ProjectStarsTypeLevelUpdatedBest for
vue-awesome-swiper (this)12.8kLibraryintermediate3.9 years agoTeams maintaining an existing Vue 3 app that already uses vue-awesome-swiper v5 and need a bridge while migrating
primevue14.4kLibraryintermediate1 months agoVue developers who already use PrimeVue and need security fixes for existing projects
quasar27.2kFrameworkintermediate18 days agoDevelopers already familiar with Vue.js
vee-validate11.3kLibraryintermediate8 months agoVue developers who need form validation without writing it from scratch
element54kLibrarybeginner2.2 years agoDevelopers maintaining an existing Vue 2.x web application
element-plus27.8kLibraryintermediate4 days agoDevelopers building admin panels or business web apps with Vue 3

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.