Reaction is a modern reactive, real-time event driven ecommerce platform.
npm install -g reaction-cli reaction init cd reaction reaction
reaction -v provides useful version information you'll need for debugging if you have issues with
ImageMagick is optional, but required for transforming images for responsive sizing.
Windows users should review the Windows specific installation requirements for Meteor and Reaction.
reaction-cli also requires a recent version of npm.
You can use npm to update to the latest version.
npm i -g n n stable
Reaction is expected to have a stable codebase ready for some production configurations within the next couple of major releases. Be aware though, that we're updating frequently. Even existing structures that are functionally done are getting frequent updates to ensure we're current with the most current libraries available to us.
Currently good for contributing, observing progress, and testing. We'd encourage due diligence in production usage, be very comfortable with the code, and risk tolerant. There are still many parts in development!
If you are interested in participating in the development of Reaction, that's really great!
For a high level review our roadmap, take a look at the Reaction vision page.
For a kanban-esque, hardcore, real time progress overview of all Reaction Commerce projects use our waffle board.
Grouped by functional area, reactioncommerce/reaction projects deliver a progress view of the Reaction sub-projects.
For grouping of issues with an estimated release schedule, review the release milestones.
If you are planning on contributing to Reaction, that's great. We welcome contributions to Reaction.
Explore the GitHub issues already opened. If you find something you want to work on, let us know right there in the comments. If you are interested in a specific aspect of the project but aren’t sure where to begin, feel free to ask. Start small and open up a dialogue with us. This will help to get your contributions accepted easily.
If the contribution you wish to make isn't documented in an existing issue, please create an issue, before you submit a Pull Request. This will allow the Reaction Maintainers and Collaborators a chance to give additional feedback as well.
Pull Requests should
- Have an associated issue
- Have accepted the Contributor License Agreement
- Enforce the Reaction style guide
- Pass both Acceptance tests and Unit testing.
Installation, configuration and development documentation is available on docs.reactioncommerce.com
Testing is an important way of participating as well. If you do discover an issue, please create an issue here to report an issue.
Integration tests can be run at the command line with
reaction test. Use
npm run-script test-local to run local tests.
We use BrowserStack for automated acceptance testing.
We require that all releases are deployable as Docker containers. While we do not actively test or support other methods of deployment, the community has documented deployment strategies for Heroku, AWS, Digital Ocean and Galaxy.
Docker images are pushed when Reaction sucessfully builds and passes all tests on the
development branches. These images are released on Reaction Commerce Docker Hub. There are two images available: reactioncommerce:prequel - the latest
development image and reactioncommerce:reaction, the