A modular, high performance, headless e-commerce platform built with Python, GraphQL, Django, and React.
BSD 3-Clause "New" or "Revised" License
17587
390
4789

Saleor Commerce - A GraphQL-first platform for perfectionists

Saleor Commerce

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

Join our active, engaged community:
Website | Twitter | GitHub Discussions

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.

Features

  • Headless / API first: Build mobile apps, custom storefronts, POS, automation, etc
  • Extensible: Build anything with webhooks, apps, metadata, and attributes
  • GraphQL API: Get many resources in a single request and more
  • Multichannel: Per channel control of pricing, currencies, stock, product, and more
  • Enterprise ready: Secure, scalable, and stable. Battle-tested by big brands
  • CMS: Content is king, that's why we have a kingdom built-in
  • Dashboard: User friendly, fast, and productive. (Decoupled project repo )
  • Global by design Multi-currency, multi-language, multi-warehouse, tutti multi!
  • 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
  • SEO: Packed with features that get stores to a wider audience
  • Cloud: Optimized for deployments using Docker

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

Installation

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

Note: The main 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 production-ready version is 3.x and you should use this version for all three components:

Saleor Cloud

The fastest way to develop with Saleor is by using developer accounts in Saleor Cloud.

Register here or install our CLI tool:

npm i -g @saleor/cli

and run the following command:

saleor register

Bootstrap your first storefront with:

saleor storefront create --demo

Documentation

Saleor documentation is available here: docs.saleor.io

To contribute, please see the saleor/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

Storefront

An open-source storefront in React.js with Next.js. Built for Headless Commerce, using a modern stack with TypeScript, GraphQL, Apollo, and Tailwind CSS.

React Storefront Repository

View Storefront Demo

Dashboard

For the dashboard go to the saleor-dashboard repository.

View dashboard demo

Demo

Want to see Saleor in action?

Or launch the demo on a free Heroku instance.

Deploy

Login credentials: admin@example.com/admin

Contributing

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.

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

License

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.

Crafted with ❤️ by Saleor Commerce

hello@saleor.io

Contributors

maarcingebala
dominik-zeglen
IKarbowiak
patrys
fowczarek
korycins
Pacu2
mad-anne
salwator
akjanik
artursmet
NyanKiyoshi
szewczykmira
benekex2
koradon
jxltom
tomaszszymanski129
mociepka
dependabot-preview[bot]
krzysztofwolski
bogdal
weronka
d-wysocki
michaljelonek
dependabot[bot]
mateuszgrzyb
rafalp
Kwaidan00
oldPadavan
marekbrzoska
derenio
Bonifacy1
SzymJ
jakubkuc
przlada
itbabu
gabmartinez
L3str4nge
GrzegorzKowalik
CossackDex
magul
tomcio1205
8r2y5
mitcom
lampyjon
stnatic
piotrgrundas
patrick-emmanuel
pawelzar
cmiacz
daltonsena
zedzior
k-brk
mirekm
MahmoudRizk
stephenmoloney
dekoza
Julian-B90
khalibloo
piotrantosz
AlicjaSzu
curaloucura
zauddelig
funkybob
amorphic
LeOndaz
snyk-bot
kadewu
ashishnitinpatil
karolkielecki
timuric
adithyabsk
lex111
RemyDCF
GrzegorzDerdak
jbergstroem
zodiacfireworks
mmiszy
Rohja
szymi-
mstrumeck
pdblaszczyk
ajostergaard
ozdemirburak
jfialkoff
MacLake
tiangolo
simonbru
vladox
dzkb
neerajgupta2407
CarlesLopezMagem
joelvarma
MatthewBosek
richlloydmiles
apsummers
gargarchit
benoj
borekb
dankolbman