Github url


by dimsemenov

dimsemenov /PhotoSwipe

JavaScript image gallery for mobile and desktop, modular, framework independent

20.3K Stars 3.1K Forks Last release: over 1 year ago (v4.1.3) MIT License 389 Commits 46 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

PhotoSwipe Repository

Build StatusdevDependency StatusFlattr

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


to generate the JS and CSS files in the


folder and the site in the





  • Run
    grunt watch
    to automatically rebuild files (JS, CSS, demo website and documentation) when you change files in
    or in
  • Run
    grunt nosite
    to build just JS and CSS files (output is folder
  • 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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.