Reaction Commerce

Reaction is an event-driven, real-time reactive commerce platform built with JavaScript (ES6). It plays nicely with npm, Docker, and React.

Features

Reaction’s out-of-the-box core features include:

Drag-and-drop merchandising
Order processing
Payments
Shipping
Taxes
Discounts
Analytics
Integration with dozens of third-party apps
See full list of features on our Roadmap

Since anything in our codebase can be extended, overwritten, or installed as a package, you may also develop, scale, and customize anything on our platform.

Getting started

Requirements

Reaction requires Meteor, Git, MongoDB, OS-specific build tools and optionally, ImageMagick. For step-by-step instructions, check out this page.

Install and create your first store

Install the Reaction CLI to get started with Reaction:

npm install -g reaction-cli

Create your store:

reaction init
cd reaction
reaction

You can also run the app locally using docker-compose by running:

docker-compose up

This will use the docker-compose.yml file. This can be used to evaluate the app locally (on all Operating Systems supported by Docker), however, for active local development or customization, it is better to run reaction outside of Docker for faster app builds.

Learn more on how to configure your project.

Get involved

Documentation and tools

Get help

Learn

Contact the team

Security reporting instructions: Report security vulnerabilities to mailto:security@reactioncommerce.com.
Reaction Action: RSVP for the monthly Reaction Action livestreams.

Contribute

⭐ Star us on GitHub — it helps!

We love your pull requests! Check our our Good First Issue and Help Wanted tags for good issues to tackle.

Pull requests should:

Pass linting tests: Run npm run lint to make sure you're following the Reaction Code Style Guide.
Pass acceptance and unit tests: Run reaction test to confirm both acceptance tests and unit tests are passing
Have a link to the issue.

Get more details in our Contributing Guide.

Deploy on Docker

We ensure that all releases are deployable as Docker containers. While we don't regularly test other methods of deployment, our community has documented deployment strategies for AWS, Digital Ocean, and Galaxy. For an introduction to Docker deployment, the Reaction deployment guide has detailed examples.

We've included a demo docker-compose file in the repository. It shows how to use mongo as a service with your Reaction app. It can be used to do a demo of your production build by running this command:

docker-compose -f docker-compose-demo.yml up

You can also use this file as starting point for your production docker-compose setup.

See it in action

You can check our latest release in Heroku by simply clicking the button below. You will need to create a Heroku account if you do not have one yet or log in using an existing account.

terryluwenbinbin/reaction