Skip to content
JavaScript image gallery for mobile and desktop, modular, framework independent
Branch: master
Clone or download
Latest commit 80607e1 Jan 8, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist 4.1.3 build Jan 8, 2019
src fix: pointer events on multi-input devices with Windows 10 and Chrome Jan 8, 2019
website Fixed typo Nov 2, 2017
.gitignore build & cleanup Dec 5, 2014
.jshintrc 4.0.6 build Feb 25, 2015
.travis.yml fix Travis setup (#1464) Dec 18, 2017
Gruntfile.js devDependencies upd Jan 8, 2019
LICENSE 4.1.3 build Jan 8, 2019 readme upd: added another ember.js addon Feb 25, 2018
bower.json 4.1.3 build Jan 8, 2019
package.json devDependencies upd Jan 8, 2019
photoswipe.json 4.1.3 build Jan 8, 2019

PhotoSwipe Repository

Build Status devDependency Status Flattr

JavaScript image gallery for mobile and desktop.

Location of files

  • Compiled PhotoSwipe JS and CSS files, SVG and PNG sprites are in the dist/ folder.
  • Source files (.JS and .SCSS) are in the src/ folder. Note that PhotoSwipe uses Autoprefixer when compiling SASS files.
  • Demo website is in the website/ folder.
  • Documentation markdown files are in website/documentation/.

Plugins / extensions / addons

Coded something useful? Email me and I’ll post a link to it here.


To compile PhotoSwipe by yourself, make sure that you have Node.js, Grunt.js, Ruby and Jekyll installed, then:

  1. Clone the repository

    git clone

  2. Go inside the PhotoSwipe folder that you fetched and install Node dependencies

    cd PhotoSwipe && npm install

  3. Run grunt to generate the JS and CSS files in the dist folder and the site in the _site/ folder



  • Run grunt watch to automatically rebuild files (JS, CSS, demo website and documentation) when you change files in src/ or in website/.
  • Run grunt nosite to build just JS and CSS files (output is folder dist/).
  • Run grunt pswpbuild to build just JS files. Param --pswp-exclude allows to exclude modules, for example grunt pswpbuild --pswp-exclude=history will exclude history module.

Using PhotoSwipe?

If you’ve used PhotoSwipe in some interesting way, or on the site of a popular brand, I’d be very grateful if you shoot me a link to it.


Script is licensed under MIT license with one exception: Do not create a public WordPress plugin based on it, as I will develop it. If you need to use it for a public WordPress plugin right now, please ask me by email first. Thanks!

Attribution is not required, but much appreciated, especially if you’re making a product for developers.


PhotoSwipe 4.0+ is developed by Dmitry Semenov. But initially script was created in 2011 by Code Computerlove, a digital agency in Manchester, they passed on development in March 2014. You can view source and documentation of old PhotoSwipe (<4.0) in history of this repo.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.