snow-mountain

Common Ninja Starter Kit – A Boilerplate Project for Building Universal E-Commerce Apps With NodeJS & React


Last updated on
Common NinjaDeveloper PlatformNews & Updates

Summary (TL;DR): In this article, we will discuss the new starter kit we’ve created, for building universal e-commerce apps with Node.js and React.

In one of the previous articles we wrote, we walked you through the process of building your first Shopify app with Common Ninja, NodeJS, and React.

The article was very detailed, and contained a lot of code examples, but we got some feedback from many developers that it would be helpful to get a boilerplate project that will save more time on bootstrapping a new project.

Well, your prayer was heard, and today we’re happy to launch the official Common Ninja Starter Kit for NodeJS & ReactJS developers.

The project is available in the link below 👇🏻, and you can follow the main README.md file to see how it works:
https://github.com/CommonNinja/commonninja-node-react-starter-kit.

The starter kit will enable you to run a single command, after which you’ll be able to start working on your universal e-commerce app. The app will be able to support multiple platforms, including Shopify, BigCommerce, WooCommerce, Wix, and more.

Prerequisites

In order to run the project you’ll need the following:

Once you have these, the next step would be to prepare your environment.

Getting Started

  • Clone the starter kit repository
git clone https://github.com/CommonNinja/commonninja-node-react-starter-kit.git
  • Browse to the project’s folder (cd commonninja-node-react-starter-kit) and run the following script:
./scripts/dev-setup.sh
  • In the (packages/server folder, edit the .env file and set your Common Ninja app credentials:
# Common Ninja App
COMMONNINJA_APP_ID=XXXX-XXXX-XXXX-XXXX-XXXX
COMMONNINJA_APP_SECRET=cn_XXXX-XXXX-XXXX-XXXX-XXXX
  • Next, start the project by running:
docker compose up
  • Browse to the project locally at http://localhost:3000.

And that’s it!

You can read more about the project’s structure here.

What’s next?

The next thing you should do, is to start adding integrations to e-commerce platforms, and connect your app to payment providers.

You may read more about it in Common Ninja’s official documentation.