Codacity

Codacity is a single page flashcard application that supports markdown notation and syntax highlighting. It's built with React on front end and Node.js on back end. The React app sends HTTP request to the back-end API service. The back-end sends JSON object back.

This project was bootstrapped with Create React App and hosted on Netlify.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

Download the back end API for this project here.

Install Node.js (version 8.10.0 or later).

Install MongoDB using Homebrew.

# Install Homebrew
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# Install MongoDB
brew install mongodb

Create a directory for MongoDB to store its data and make sure this directory has the right permission.

sudo mkdir -p /data/db
sudo chown -R `id -un` /data/db

Installing

Back End

Start MongoDB:

mongod

Install all the dependencies:

cd codacity-api
npm install

Start the back end server at localhost:3900.

cd codacity-api
npm start

Front End

Install all the dependencies:

cd codacity
npm install

Run the React app in the development mode.

cd codacity
npm start

Deployment

These instructions will get the back-end API up and running on Heroku and front-end React app up and running on Netlify.

Host Database on mLab

Create a new database.

Sing up an mLab account and sign in to your dashboard.
Click + Create new to create a new database.
Choose any Cloud Provider and select the free SANDBOX for Plan Type.
Choose a preferred region.
Give your database a name. For example: codacity.
Continue and submit order.

Create a user for this database.

Inside the database you just created, click Users tab.
Click Add database user and specify database username and password.

At the database page, there's a MongoDB URI available on the top. We'll set Heroku's MONGODB_URI environment variable to this value later. It looks like:

mongodb://<dbuser>:<dbpassword>@ds123456.mlab.com:33212/codacity

Setup Heroku

Make sure you have an account with Heroku and have installed the Heroku CLI. Choose a region.

$ heroku login
Enter your Heroku credentials.
Email: adam@example.com
Password (typing will be hidden):
Authentication successful.

Deploy Back End

Create a Heroku app via the command line:

cd codacity-api
heroku create

Set the MONGODB_URI variable to your mLab database URI. Replace <dbuser> and <dbpassword> with your database's user and password. For exmaple:

heroku config:set MONGODB_URI=mongodb://<dbuser>:<dbpassword>@ds123456.mlab.com:33212/codacity

Add, and commit all your data to git. Then push it to Heroku:

git push heroku master

Deploy Front End

Create another Heroku app for front end.

cd codacity
heroku create