# [Spree Commerce](https://spreecommerce.org) [![Gem Version](https://badge.fury.io/rb/spree.svg)](https://badge.fury.io/rb/spree) [![Test Coverage](https://api.codeclimate.com/v1/badges/8277fc2bb0b1f777084f/test_coverage)](https://codeclimate.com/github/spree/spree/test_coverage)
**Spree** is a headless open source e-commerce platform for global brands.
* [Success Stories](https://spreecommerce.org/stories/)
* [Integrations](https://spreecommerce.org/integrations/)
* [Roadmap](https://github.com/spree/spree/milestones?direction=asc&sort=due_date&state=open)
* [Join our Slack community](http://slack.spreecommerce.org/)
## Key Features
* **[Headless Commerce](https://spreecommerce.org/use-cases/headless-ecommerce-api/)** - build mobile apps or custom storefronts in any technology, [JS/TS SDK available](https://github.com/spree/spree-storefront-api-v2-js-sdk)
* **[PWA](https://spreecommerce.org/use-cases/spree-pwa-progressive-web-application/)** - offline shopping experiences like native mobile apps
* **[Global Commerce](https://spreecommerce.org/use-cases/international-sales-demo/)** - multi currency and multi language support out of the box, different shipping methods / costs for different regions, advanced tax calculation
* **Multi-Store** - host multiple brands / stores on one Spree instance with different branding, configuration, payment methods, shipping options, product catalogs etc
* **[Multi-vendor marketplace](https://spreecommerce.org/use-cases/multi-vendor-marketplace-demo/)** - run your own marketplace with multiple suppliers with dedicated Supplier Dashboard
* **Responsive Admin Panel** - manage and curate products, users, orders, returns, shipments & more
* **Orders** - robust system for orders, shipments, returns and refunds
* **Carts** - comprehensive and advanced discounts system
* **Payments** - over 30 payment provider integration out of the box plus API to integrate any other gateway
* **Run everywhere** - cloud, VPS, Docker, Kubernetes
* **Battle Tested** - used by thousands of merchants around the globe in all categories since 2007!
* **Fully customizable** - pick and choose parts you want to use and customize everything else (storefront, order processing, API, etc) to create unique solutions that your business requires
* **More features available via extensions** - dozens of extensions built by community, ready for use for free!
## Sponsored by
> [Vendo][vendo] is a great fit for marketplaces of all sizes - either with own fulfillment and multiple warehouses or in a dropshipping model. Vendo **automates everything** from **vendor onboarding**, accepting buyer **payments in over 135 currencies**, to supplier **payouts in 50 countries**.
> Vendo ensures excellent buyer experience with smooth product discovery and search, a multitude of payment methods and optimal shipping cost calculation. Vendo keeps suppliers happy with easy onboarding, automated products sync using their preferred method and easy payouts.
> [Start your 14-day free trial](https://app.getvendo.com/users/new?typeform-source=spree_github)
---
## Documentation
* [Getting Started](https://dev-docs.spreecommerce.org/getting-started/installation)
* [Developer Documentation](https://dev-docs.spreecommerce.org/)
## API
* [API Reference](https://api.spreecommerce.org/)
* [JavaScript / TypeScript SDK](https://github.com/spree/spree-storefront-api-v2-js-sdk)
## Contributing
Spree is an open source project and we love contributions in any form - pull requests, issues, feature ideas!
Please review the [Contributing Guide](https://dev-docs.spreecommerce.org/contributing/index)
## License
Spree is released under the [New BSD License](https://github.com/spree/spree/blob/main/license.md).
[vendo]:https://getvendo.com?utm_source=spree_github