JSFeeds: blog.strapi.io - �� Deliveroo Clone - NextJS, Strapi, GraphQL, Stripe, React Context (Part 1/7

Saturday, 13 October, 2018 UTC

�� Deliveroo Clone - NextJS, Strapi, GraphQL, Stripe, React Context (Part 1/7 - Setup)

Summary

This tutorial is an adaptation of Pierre's Nuxtjs and Strapi Deliveroo clone here

This tutorial will be adapted to use Nextjs (React) over Nuxt (Vue) on the front end, complete with GraphQL, Strapi, Stripe and React Context.

Get ready to develop a Deliveroo clone, using amazing technologies: Nextjs (React), GraphQL, Stripe and Strapi! From signup to order, you are going to let users discover restaurants, dishes and select their happy meal.

The demo of the final result should make you hungry:

Note: the source code is available on GitHub:

https://github.com/ryanbelke/strapi-next

Screenshots of final product:

Strapi:

Strapi is the most advanced open-source Node.js API Content Management Framework used to build scalable, secure, production ready API's quickly and efficiently saving developers countless hours of development.

With its extensible plugin system, it provides a large set of built-in features: Admin Panel, Authentication & Permissions management, Content Management, API Generator, etc. Unlike online CMS, Strapi is 100% open-source (take a look at the GitHub repository), which means:

Strapi is completely free.
You can host it on your own servers, so you own the data.
It is entirely customizable and extensible, thanks to the plugin system.

Next.js:

Next is a lightweight development framework to create static, server rendered applications in React. Next will take care of the heavy lifting of the application such as code splitting, HMR (hot module replacement) and SSR (server side rendering) and allow us to focus on the application.

React:

React is one of the most popular front end Javascript frameworks, developed by facebook and used by countless tech companies including Netflix, Airbnb and Github to build applications. React is a declarative library that makes it easy to create interactive user interfaces, keeping the code base organized through its component based architecture.

GraphQL:

GraphQL is a query language also developed by Facebook to allow the front end of an application to easily query an application's API. Each query requests only the data needed to be rendered by the current view. This allows the developer to craft a great user experience across multiple devices and screen sizes.

Stripe:

Stripe is one of (if not the largest) payment processor's for application today. Stripe has developed the tools and SDKs to allow developers to craft and integrate secure, compliant payment processing into any app with easy.

Table of contents

🏗️ Setup (part 1) - current
🏠 Restaurants (part 2)
🍔 Dishes (part 3)
🔐 Authentication (part 4)
🛒 Shopping Card (part 5)
💵 Order and Checkout (part 6)
🚀 Bonus: Deploy (part 7)
👏 Conclusion

🏗️ Setup

To setup Next.js we will need an empty directory to install the library and host our project root:
note: I am going to use the nextjs Canary branch is which pre-release and as of writing not the stable master branch of the project. This decision is to demo the use of the ReactJS Context API

mkdir strapi-deliveroo  
cd strapi-deliveroo

yarn add next@canary react react-dom

next 7.0 (canary) is the stable version of Nextjs as of time of publishing

note: I am using yarn as my package manager, you can also use npm and execute npm install --save next react react-dom

Add the following to your packages.json file:

"scripts": {
  "dev": "next",
  "build": "next build",
  "start": "next start"
}

So that your file looks like this (your package dependencies may have different versions depending on the time of install):

{
  "dependencies": {
    "next": "^7.0.0-canary.20",
    "react": "^16.5.1",
    "react-dom": "^16.5.1"
  },
  "scripts": {
    "dev": "next",
    "build": "next build",
    "start": "next start"
  }
}

Nextjs uses any javascript file in the /pages directory as the routes for the application. To setup simply create the /pages directory and add an index.js file with:

mkdir pages  
cd pages  
touch index.js

Now that we have our main route (index.js), this will be loaded each time the browser URL is at the root (i.e. www.yourapp.com). To test this you can insert the following into the index.js file:

export default () => <div>Welcome to next.js!</div>

To view the application running, start the local dev server using

yarn dev

Your application should now be visible at http://localhost:3000

Be sure to create a .gitignore and add .next and node_module directories to it

touch .gitignore

/* .gitignore */
node_modules  
.next

Adding Bootstrap:
For this tutorial, we will use react-strap to implement Bootstrap 4 into our application.
For the CSS styling we will import directly from a CDN

First install Reactstrap

yarn add reactstrap bootstrap

reactstrap is simply a front end library to easily create Bootstrap components and styling.

To import the CSS and share a Layout component across all our pages we will use a custom _app.js file inside the pages directory. This file will serve to override the default App.js used by Next and be rendered on each page, allowing us to set global styles/shared components in one place. This will allow us the ability to import a component and globally set the stylesheet inside the header.

touch _app.js

Now if we add in some reactstrap components inside of index.js we should see the bootstrap styling applied.

Designing the page

Now that we have Bootstrap running inside of our Next.js project, we can begin to style the basic shared front end components like the navbar.

First create a folder to store our components and create our layout component

cd ..  
mkdir components  
cd components  
touch Layout.js

Nextjs uses the <Link> component to perform the client side routing between pages. The Link component is just a Higher Order Component and can accept any html tag that can handle an onClick handler (<a>,<button>,<div> etc.)

This will cause us to have to make a few modifications outside of the reactstrap documentation. To style our navbar we can use the built in CSS in JS <style jsx> shipped by default with nextjs

Inserting CSS in JS as:

<style jsx> {`  
  a { color: yellow }
`}
</style

Allows us to scope CSS to the components the style tag is rendered in, you can also pass in the global option to set a global style: <style jsx global>

You can read more on CSS in JS in the Next documents here:

https://nextjs.org/docs/#css-in-js

Open the Layout.js file and create the shared layout components and insert the Stripe script (for later) as follows:

Edit the index.js file:

You should now have a shared header bar across all your pages:

We will create two additional pages to allow users to sign in and sign up at /signin and /signup respectively. You will need to create the corresponding files inside the /pages directory
/pages/signin.js /pages/signup.js

cd ..  
cd pages

touch signin.js

touch signup.js

Populate the files with the following code that we will come back to once our Strapi server is setup.

Restart the server to see your changes at http://localhost:3000.

Strapi

Having a frontend is good, but your app obviously needs a backend to manage users, restaurants, dishes and orders. To make the magic happen, let's create a Strapi API.

Install Strapi

Requirements: please make sure to use Node 9 (or more) and have either MongoDB, Postgres or MySQL installed and running on your machine.

Install Strapi using npm:

npm i strapi@alpha -g

Note: Strapi v3 is still an alpha version, but it will be fine for this tutorial.

Generate a Strapi project

Scaffold your API inside the deliveroo-clone-tutorial through a single command line:

Install a strapi server from the root of your project directory:

cd ..  
strapi new server

The CLI will ask you to choose your database: select MongoDB, Postgres or MySQL. Then, fill the database information in. The default values should work if you correctly installed the database system on your machine.

Start the server

Launch the Node.js server:

cd server  
strapi start

Starting now, you should be able to visit the admin panel of your project: http://localhost:1337/admin.

Create your first User

Add your first user from the registration page.

Good job, you successfully setup both Next and Strapi projects! 🎉

🏠 In the next section, you will learn how to display the list of restaurants: https://blog.strapi.io/strapi-next-restaurants/.

... more @ blog.strapi.io

blog.strapi.io