Simple application using MEVN stack.

TOC

• What is MEVN stack?
• Requirements
• Usage
  1. Localhost
  2. Docker
• Documentation
• Features

What is MEVN stack?

The acronym “MEVN” stands for “MongoDB Express.js VueJS Node.js”.

Requirements

• MongoDB >= v3
• Express.js >= 4
• Node.js >= 10

Usage

First, clone the repo:

git clone https://github.com/IvanKozlov95/mevn_stack
cd protranslating

Application can be run two ways: locally or via docker. Depends on what you want follow the instructions in sections below.

Localhost

Launch mongod instance in 1st terminal tab:

mongod

Launch REST API from 2d terminal tab. From cloned folder root:

cd server
npm i
npm run start

And finally launch vue application from 3d terminal tab. From cloned folder root:

cd client
npm i
npm run start

Now you can access application on http://localhost:8080/clients. See features section to see what app can do.

Docker

Make sure your docker daemon is running.

docker ps

Start docker-machine and get its ip.

docker-machine start \<machine-name\>
docker-machine ip \<machine-name\>

From root of cloned folder do following commands. Replace ip with you docker-machine ip.

cd server
docker build --build-arg mongodb=mongodb://192.168.99.100/ -t rest-server .
cd ../client
docker build --build-arg base_url=http://192.168.99.100:3000 --build-arg host=0.0.0.0 -t vue-app .
cd ../docker
docker-compose up -d

After these steps you will be able to access app on <you_machine_ip>:8080. Rest API is avaliable at <you_machine_ip>:3000

Documentation

To see REST api documentation follow instructions in Usage to deploy app (locally or via docker). Then open localhost:3000/docs or <docker-machine ip>:3000/docs in browser.

Features

Application has two entities: Client and Provider. Client has name, email, phone and list of providers. Provider has name. All fields must be unique and not empty. User can:

• Add/edit/delete clients
• Add/edit/delete providers