DEV Community

Cover image for Common Ninja Starter Kit - A Boilerplate Project For Building Universal E-Commerce Apps With NodeJS & React
Daniel Sternlicht for Common Ninja

Posted on

Common Ninja Starter Kit - A Boilerplate Project For Building Universal E-Commerce Apps With NodeJS & 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.

Common Ninja 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.

Prerequisite

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
Enter fullscreen mode Exit fullscreen mode
  • Browse to the project's folder (cd commonninja-node-react-starter-kit) and run the following script:
./scripts/dev-setup.sh
Enter fullscreen mode Exit fullscreen mode
  • 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
Enter fullscreen mode Exit fullscreen mode
  • Next, start the project by running:
docker compose up
Enter fullscreen mode Exit fullscreen mode
  • 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.

❓ What is Common Ninja?

Common Ninja is a platform that allows developers to build & monetize apps for e-commerce platforms very easily. With our single e-commerce API you can build your app once, and integrate it with multiple platforms like Shopify, BigCommerce, Wix, WooCommerce, and more. There's no need to rebuild the app and make it work on every platform individually.

In addition, Common Ninja offers a set of APIs and tools that help developers to boost up the development process, and provide payments and storage solutions.

πŸ“š Learn more

If you're not familiar with Common Ninja or how to build your first app using our API, here's the previous article we wrote about it.

In addition, you can use the following resources to learn more and get help:

πŸ“œ Common Ninja Docs
πŸ’¬ Discord Community

Discussion (0)