Shopify Koa.js React App

Production-ready boilerplate to create a Shopify node app made with Koa.js, Shopify-koa-auth, JSON web token, MongoDB with Mongoose ORM, and React with Polaris.

First things first

Since this tutorial (Link before Unite) from Shopify using shopify-cli has a lot of issues with Authentication, Session, Cookie, Infinite redirect, Expected a valid shop query parameter… that make me frustrated for days, I decided to make this boilerplate which include all requirements for a Shopify app and have none of the above issues.

Key features

Using shopify-koa-auth (offline access mode) which make authentication process much faster
Cookie base authentication using JWT with httpOnly and secure flag
All mandatory Webhooks (GDPR and app/uninstalled topics) registered
Querying Shopify resources with either Rest API or GraphQL API

Prerequisites

If you don’t have one, create a Shopify partner account.
If you don’t have one, create a Development store where you can install and test your app.
In the Partner dashboard, create a new app. You’ll need this app’s API credentials during the setup process.

Installation

Install and start MongoDB

Clone the repo

  git clone https://github.com/hta218/shopify-koajs-react-app.git && cd shopify-koajs-react-app

Install dependencies
```
  npm run set-up
  # or yarn set-up
```
Inside /server directory, create .env file with all credentials from your private app that you have created in the above step (Take a look at .env.example for the template)
Start app
```
  npm start
```

Authentication

Shopify OAuth process require HTTPS so you need to either using ngrok or generate SSL files then move theme to server/certs directory (recommended)