https://github.com/nolimits4web/swiper

Most modern mobile touch slider with hardware accelerated transitions
https://github.com/nolimits4web/swiper

carousel gallery mobile slider swipe swiper touch touch-events

Last synced: about 1 month ago
JSON representation

Most modern mobile touch slider with hardware accelerated transitions

Host: GitHub
URL: https://github.com/nolimits4web/swiper
Owner: nolimits4web
License: mit
Created: 2012-03-14T19:11:45.000Z (almost 14 years ago)
Default Branch: master
Last Pushed: 2026-01-12T17:49:58.000Z (about 2 months ago)
Last Synced: 2026-01-12T21:58:18.711Z (about 2 months ago)
Topics: carousel, gallery, mobile, slider, swipe, swiper, touch, touch-events
Language: JavaScript
Homepage: https://swiperjs.com
Size: 79.8 MB
Stars: 41,737
Watchers: 670
Forks: 9,718
Open Issues: 255
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-react - swiper - Most modern mobile touch slider (Uncategorized / Uncategorized)
awesome-learning-resources - swiper - modern mobile touch slider (Uncategorized / Uncategorized)
awesome-vue - swiper - Official Swiper component for Vue 3. Tree shakable, SSR support, typing, a11y and a lot more (Components & Libraries / UI Components)
awesome-technostructure - nolimits4web/swiper
awesome-vue - swiper - Official Swiper component for Vue 3. Tree shakable, SSR support, typing, a11y and a lot more (Components & Libraries / UI Components)
awesome-mobile-web-development - Swiper - The most modern mobile touch slider with hardware accelerated transitions. (Other Useful Tools and Libraries)
awesome - nolimits4web/swiper - Most modern mobile touch slider with hardware accelerated transitions (JavaScript)
awesome - nolimits4web/swiper - Most modern mobile touch slider with hardware accelerated transitions (JavaScript)
awesome-frontend-lib - swiper
awesome-ru - Swiper - Современный мобильный тач-слайдер с аппаратным ускорением. Автор: Владимир Харлампиди. (Веб-разработка)
-awesome-mobile-web-development - Swiper - The most modern mobile touch slider with hardware accelerated transitions. (Other Useful Tools and Libraries)
awesome-github-star - swiper
fucking-awesome-react - swiper - Most modern mobile touch slider (Uncategorized / Uncategorized)
fucking-awesome-vue - swiper - Official Swiper component for Vue 3. Tree shakable, SSR support, typing, a11y and a lot more (Components & Libraries / UI Components)
stars - nolimits4web/swiper - Most modern mobile touch slider with hardware accelerated transitions (JavaScript)
awesome-vue - swiper - Most modern mobile touch slider with hardware accelerated transitions ` 📝 4 days ago` (UI Components [🔝](#readme))
awesome - nolimits4web/swiper - Most modern mobile touch slider with hardware accelerated transitions (JavaScript)

README

^{Special thanks to:}

[Warp, built for coding with multiple AI agents](http://go.warp.dev/swiper)

---

Get Started |
Documentation |
Demos

# Swiper

Swiper - is the free and most modern mobile touch slider with hardware accelerated transitions and amazing native behavior. It is intended to be used in mobile websites, mobile web apps, and mobile native/hybrid apps.

Swiper is not compatible with all platforms, it is a modern touch slider which is focused only on modern apps/platforms to bring the best experience and simplicity.

## Features

- **Tree-shakeable**: Only modules you use will be imported into your app's bundle.
- **Mobile-friendly**: It is intended to be used in mobile websites, mobile web apps, and mobile native/hybrid apps.
- **Library Agnostic**: Swiper doesn't require any JavaScript libraries like jQuery, which makes Swiper much smaller and faster. It can be safely used with libraries such as jQuery, Zepto, jQuery Mobile, etc.
- **1:1 Touch movement**: By default, Swiper provides 1:1 touch movement interaction, but this ratio can be configured through Swiper settings.
- **Mutation Observer**: Swiper has an option to enable Mutation Observer, with this feature Swiper will be automatically reinitialized and recalculate all required parameters if you make dynamic changes to the DOM, or in Swiper styles itself.
- **Rich API**: Swiper comes with a very rich API. It allows creating your own pagination, navigation buttons, parallax effects and many more.
- **RTL**: Swiper is the only slider that provides 100% RTL support with correct layout.
- **Multi Row Slides Layout**: Swiper allows a multiple row slides layout, with a few slides per column.
- **Transition Effects**: Fade, Flip, 3D Cube, 3D Coverflow.
- **Two-way Control**: Swiper may be used as controller for any number of other Swipers, and even be controlled at the same time.
- **Full Navigation Control**: Swiper comes with all required built-in navigation elements, such as Pagination, Navigation arrows and Scrollbar.
- **Flexbox Layout**: Swiper uses modern flexbox layout for slides layout, which solves a lot of problems and time with size calculations. Such layout also allows configuring the Slides grid using pure CSS.
- **Most Flexible Slides Layout Grid**: Swiper has a lot of parameters on initialization to make it as flexible as possible. You can control slides per view, per column, per group, space between slides, and many more.
- **Images Lazy Loading**: Swiper Lazy Loading delays loading of images in inactive/invisible slides until the user swipes to them. Such feature could make the page load faster and improve Swiper performance.
- **Virtual Slides**: Swiper comes with Virtual Slides feature that is great when you have a lot of slides or content-heavy/image-heavy slides so it will keep just the required amount of slides in DOM.
- **Loop mode**
- **Autoplay**
- **Keyboard control**
- **Mousewheel control**
- **Nested sliders**
- **History navigation**
- **Hash navigation**
- **Breakpoints configuration**
- **Accessibility (A11y)**
- **And many more ...**

## Community

The Swiper community can be found on [GitHub Discussions](https://github.com/nolimits4web/swiper/discussions), where you can ask questions, voice ideas, and share your projects

Our [Code of Conduct](https://github.com/nolimits4web/swiper/blob/master/CODE_OF_CONDUCT.md) applies to all Swiper community channels.

## Dist / Build

On production use files (JS and CSS) only from `dist/` folder, there will be the most stable versions.

### Development Build

Install all dependencies, in repo's root:

```

$ npm install

```

And build development version of Swiper:

```

$ npm run build

```

The result is available in `dist/` folder.

### Running demos:

All demos located in `./playground` folder. There you will find Core (HTML, JS), React, Vue versions.
To open demo, run:

- **Core**: `npm run core`
- **React**: `npm run react`
- **Vue**: `npm run vue`

### Production Build

```

$ npm run build:prod

```

Production version will available in `dist/` folder.

## Contributing

All changes should be committed to `src/` files only. Before you open an issue please review the [contributing](https://github.com/nolimits4web/swiper/blob/master/CONTRIBUTING.md) guideline.

## Major Roadmapped Features

- [Top Feature Requests](https://github.com/nolimits4web/swiper/issues?q=is%3Aissue+is%3Aopen+label%3A%22feature+request%22+sort%3Areactions-%2B1-desc+) (Add your own votes using the 👍 reaction)
- [Top Bugs 😱](https://github.com/nolimits4web/swiper/issues?q=is%3Aissue+is%3Aopen+-label%3A%22feature+request%22++sort%3Areactions-%2B1-desc+) (Add your own votes using the 👍 reaction)

## Sponsors