Skip to content
A modular, high performance, headless e-commerce storefront built with Python, GraphQL, Django, and ReactJS.
Python HTML
Branch: master
Clone or download

Latest commit

Latest commit 8b4c790 May 28, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Upgraded PostgreSQL version on Circle-CI Mar 9, 2020
.github Add docs to the PR template May 22, 2020
.tx Drop djangojs files May 14, 2020
deployment/elasticbeanstalk Move deployment scripts to a subdirectory Aug 24, 2018
locale Sync translations May 21, 2020
saleor Merge pull request #5686 from patrys/automatic-plugin-discovery May 28, 2020
scripts Change bash to sh Dec 12, 2019
templates Add tracking number as url in email templates May 14, 2020
tests Merge pull request #5682 from mirumee/bugfix/create_checkout_with_unp… May 22, 2020
.dockerignore Move to Circle 2.0 Jun 29, 2018
.editorconfig Update configuration files to new python formatter May 9, 2019
.gitattributes Move to Poetry Oct 8, 2019
.gitignore Add compiled versions of emails to the repository Feb 17, 2020
.isort.cfg Automatic plugin discovery May 22, 2020
.nvmrc chore: update .nvmrc version to use last nodejs LTS version Mar 3, 2019
.pre-commit-config.yaml Remove black from excluded email changes as it's not even relavant Feb 24, 2020
.pylintrc Replace permissions string with enums Dec 17, 2019
.travis.yml Add isort to CI May 4, 2020 Update changelog and versions May 22, 2020
Dockerfile Add compiled versions of emails to the repository Feb 17, 2020
LICENSE Update year in license file May 18, 2020
Procfile Add celeryworker process in procfile Jul 19, 2018 Update changelog and versions May 22, 2020 Add a security policy Feb 10, 2020
app.json Update Heroku config May 18, 2020 Drop Python 2 support Dec 14, 2017
package-lock.json Update MJML Apr 7, 2020
package.json Update changelog and versions May 22, 2020
poetry.lock Bump flake8 from 3.8.1 to 3.8.2 May 26, 2020
pyproject.toml Bump flake8 from 3.8.1 to 3.8.2 May 26, 2020
requirements.txt Update requirements files May 19, 2020
requirements_dev.txt Update requirements files May 19, 2020
runtime.txt Fix Python runtime on Heroku Dec 9, 2019
setup.cfg Refactor cursor pagination Mar 12, 2020
tox.ini Add isort to CI May 4, 2020

Saleor Commerce - A GraphQL-first platform for perfectionists

Saleor Commerce

Customer-centric e-commerce on a modern stack
A headless, GraphQL-first e-commerce platform delivering ultra-fast, dynamic, personalized shopping experiences. Beautiful online stores, anywhere, on any device.

Join our active, engaged community:
Website | Blog | Twitter | Gitter | Spectrum

Table of Contents

What makes Saleor special?

Saleor is a rapidly-growing open source e-commerce platform that has served high-volume companies from branches like publishing and apparel since 2012. Based on Python and Django, the latest major update introduces a modular front end powered by a GraphQL API and written with React and TypeScript.


  • PWA: End users can shop offline for better sales and shopping experiences
  • GraphQL API: Access all data from any web or mobile client using the latest technology
  • Headless commerce: Build mobile apps, customize storefronts and externalize processes
  • UX and UI: Designed for a user experience that rivals even the top commercial platforms
  • Dashboard: Administrators have total control of users, processes, and products
  • Orders: A comprehensive system for orders, dispatch, and refunds
  • Cart: Advanced payment and tax options, with full control over discounts and promotions
  • Payments: Flexible API architecture allows integration of any payment method. It comes with Braintree support out of the box.
  • Geo-adaptive: Automatic localized pricing. Over 20 local languages. Localized checkout experience by country.
  • SEO: Packed with features that get stores to a wider audience
  • Cloud: Optimized for deployments using Docker
  • Analytics: Server-side Google Analytics to report e-commerce metrics without affecting privacy

Saleor is free and always will be. Help us out… If you love free stuff and great software, give us a star! 🌟

Saleor Storefront - React-based PWA e-commerce storefront Saleor Dashboard - Modern UI for managing your e-commerce


Saleor requires Python 3.8, Node.js 10.0+, PostgreSQL and OS-specific dependency tools.

See the Saleor docs for step-by-step installation and deployment instructions.

Note: The master branch is the development version of Saleor and it may be unstable. To use the latest stable version, download it from the Releases page or switch to a release tag.

The current stable version is 2.10 and you should use this version for all three components:


Saleor documentation is available here:

To contribute, please see the mirumee/saleor-docs repository.

Saleor Platform

The easiest way to run all components of Saleor (API, storefront and dashboard) together on your local machine is to use the saleor-platform project. Go to that repository for instructions on how to use it.

View saleor-platform


For PWA, single-page storefront go to the saleor-storefront repository.

View storefront demo


For dashboard go to the saleor-dashboard repository.

View dashboard demo


Want to see Saleor in action?

View Storefront | View Dashboard (admin area)

Or launch the demo on a free Heroku instance.


Login credentials:


We love your contributions and do our best to provide you with mentorship and support. If you are looking for an issue to tackle, take a look at issues labeled Help Wanted.

If nothing grabs your attention, check our roadmap or come up with your feature. Just drop us a line or open an issue and we’ll work out how to handle it.

Get more details in our Contributing Guide.

Legacy views

If you're interested in using the old version of Saleor, go the legacy-views repository. It contains the 2.9.0 release, which includes Django-based views and HTML templates of Storefront 1.0 and Dashboard 1.0. Note: this version of Saleor is no longer officially maintained.

Your feedback

Do you use Saleor as an e-commerce platform? Fill out this short survey and help us grow. It will take just a minute, but mean a lot!

Take a survey


Disclaimer: Everything you see here is open and free to use as long as you comply with the license. There are no hidden charges. We promise to do our best to fix bugs and improve the code.

Some situations do call for extra code; we can cover exotic use cases or build you a custom e-commerce appliance.

Crafted with ❤️ by Mirumee Software

You can’t perform that action at this time.