jajamoks / reaction

Mailchimp Open Commerce is an API-first, headless commerce platform built using Node.js, React, GraphQL. Deployed via Docker and Kubernetes.

Mailchimp Open Commerce (formerly Reaction Commerce)

Open Commerce Website | Twitter | Documentation | Discord

Mailchimp Open Commerce is an API-first, headless commerce platform built using Node.js, MongoDB, and GraphQL. It plays nicely with npm, Docker and Kubernetes.

Features

Fast	Returns data in split seconds, and faster queries mean faster web pages
Proven	Open Commerce fuels sites doing 10's of thousands of orders per day with 100's of thousands of products
Composable	A flexible plugin system allows you to pick and choose which integrations work best for you
Multi-tenant	Host multiple shops in the same installation
Scalable	Start out with a single server and scale up to hundreds
Flexible Products	Allows Products, with options and variants to fit a wide variety of needs
Inventory	Track inventory, allow or disallow backorders and more
Shipping	Integrate with a shipping rate provider or build your own custom table
Taxes	Integrate with a tax rate provider or build your own custom tax table
Fulfillment	Flexible fulfillment system allows you create your own fulfillment methods
Order Tracking	View and manage your orders in the included admin system
Emails	Customizable templates for Order confirmations and more
Open	Fully open source. Never be locked in again

Getting started

For complete documentation go to Open Commerce Quickstart for all supported operating systems.

What you need

• git
• Docker
• Docker Compose
• Windows users: WSL 2 and Docker for WSL

Clone and Start the platform

git clone https://github.com/reactioncommerce/reaction-development-platform.git
cd reaction-development-platform
make

Behind the scenes, the make process clones all of the relevant Open Commerce software repositories, sets up each environment, and pulls, builds, and starts each Docker container.

When make completes, three services will be running on localhost:

• Open Commerce API (port 3000), including the core plugins. This service also contains the GraphQL playground at localhost:3000/graphql.
• Example Storefront (port 4000), which is built with Next.js.
• Admin dashboard (port 4080), used to manage shop settings, accounts, products, and orders.

Go to the complete installation instructions to see how to set up your store

API development

What you need

• PNPM
• Docker & docker-compose

Install PNPM

npm i -g pnpm@latest

Clone and Start the source

git clone https://github.com/reactioncommerce/reaction.git
cd reaction
pnpm install
cp apps/reaction/.env.example apps/reaction/.env

Start dev-server with mongo on local:

## you must change MONGO_URL in the .env to mongodb://localhost:27017/reaction before start
pnpm run start:dev

Start dev-server with mongodb on docker

docker-compose up -d
pnpm run start:dev

Development Flow

1. Make some changes in one or more packages.
2. Add a changeset in that same PR.
3. Repeat the process of making changes and adding changesets.
4. Create PR

How to release

1. Run release action to create Version PR. This PR will remove all changeset files, bump up packages versions, update CHANGELOG files.
2. Merge Version PR into trunk, CircleCI will publish all the packages into npm.

Get involved

Contribute

⭐ If you like what you see, star us on GitHub.

Find a bug, a typo, or something that’s not documented well? We’d love for you to open an issue telling us what we can improve! This project uses semantic-release, please use their commit message format.

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

License

Reaction is GNU GPLv3 Licensed