Update Readme, bump nodejs version to current LTS. (#149)

* Update Readme, bump nodejs version to current LTS.

Author: Alex G Rice

.nvmrc

@@ -1 +1 @@
-v8.13.0
+v12.16

README.md

@@ -1,52 +1,71 @@
 # osm-teams 🤝
 
-Check the beta 👉 https://mapping.team
+Check the beta 👉 <!-- markdownlint-disable MD034 -->https://mapping.team
+<!-- markdownlint-enable MD034 -->
 
 ## Installation
+
 ### Requirements
-- Postgresql. On macOS, the easiest is to install [Postgres.app](https://postgresapp.com/).
-- NodeJS v10+
-- Docker & Docker Compose
+
+- [PostgreSQL](https://www.postgresql.org). On OS X, the easiest is to install [Postgres.app](https://postgresapp.com/).
+- [Node.js](https://nodejs.org) v12.16+
+- [Docker](https://www.docker.com/) & Docker Compose
 
 ### Setting up Hydra
 
 1. Create the database for tokens
-```
-createdb osm-teams
-```
-For the rest of this documentation, we will assume that the database location is `postgres://postgres@localhost/osm-teams?sslmode=disable` on your local machine. Inside docker, that location is `postgres://[email protected]/osm-teams?sslmode=disable`
 
-2. Create a a `.env` file by copying `.env.sample` and replacing the values as needed. `OSM_CONSUMER_KEY` and `OSM_CONSUMER_SECRET` are values obtained by creating a new OAuth app on openstreetmap.org. The .env file can contain:
-```
-OSM_CONSUMER_KEY=<osm-teams-app>
-OSM_CONSUMER_SECRET=<osm-teams-app-secret>
-DSN=postgres://[email protected]/osm-teams?sslmode=disable
-SECRETS_SYSTEM=<random-guid>
-```
+    ```bash
+    createdb osm-teams
+    createdb osm-teams-test
+    ```
 
-3. Migrate the database
-```
-docker-compose run --rm hydra migrate sql --yes postgres://[email protected]/osm-teams?sslmode=disable
-```
+    For the rest of this documentation, we will assume that the database location is `postgres://postgres@localhost/osm-teams?sslmode=disable` on your local machine. Inside docker, that location is `postgres://[email protected]/osm-teams?sslmode=disable`
 
-4. Build the images:
-```
-docker-compose build
-```
+1. Create an `.env` file by copying `.env.sample` and replacing the values as needed. `OSM_CONSUMER_KEY` and `OSM_CONSUMER_SECRET` are values obtained by creating a new OAuth app on openstreetmap.org. The .env file can contain:
 
-5. Start Hydra and the server
-```
-docker-compose -f docker-compose.dev.yml up
-```
+    ```bash
+    OSM_CONSUMER_KEY=<osm-teams-app>
+    OSM_CONSUMER_SECRET=<osm-teams-app-secret>
+    DSN=postgres://[email protected]/osm-teams?sslmode=disable
+    SECRETS_SYSTEM=<random-guid>
+    ```
+
+1. Install Javascript dependencies and migrate the osm-teams database
+
+    ```bash
+    nvm use
+    yarn install
+    yarn run migrate
+    ```
+
+1. Migrate the Hydra database
+
+    ```bash
+    docker-compose run --rm hydra migrate sql --yes postgres://[email protected]/osm-teams?sslmode=disable
+    ```
+
+1. Build the docker images:
+
+    ```bash
+    docker-compose build
+    ```
+
+1. Start Hydra and the server
+
+    ```bash
+    docker-compose -f docker-compose.dev.yml up
+    ```
 
 ⚠️ In development, `docker-compose -f docker-compose.dev.yml up` enables hot module reloading while you make modifications to the code. `docker-compose up` should be used for production/staging deployments.
 
 This will start hydra where the token issuer is at `http://localhost:4444` and the admin interface is at `http://localhost:4445`. This also sets up the consent and login interface at `http://localhost:8989` (where we will create a first-party oauth app)
 
-### Setting up the first party app
+### Setting up the OSM-teams app
 
-Create the first party "manage" app
-```
+Create the [first-party](https://auth0.com/docs/applications/concepts/app-types-first-third-party) "manage" app
+
+```bash
 docker-compose exec hydra hydra clients create --endpoint http://localhost:4445 \
   --id manage \
   --secret manage-secret \
@@ -56,13 +75,10 @@ docker-compose exec hydra hydra clients create --endpoint http://localhost:4445
   --callbacks http://localhost:8989/login/accept
 ```
 
-Migrate the database
-```
-npm install
-npm run migrate
-```
-
+<!-- markdownlint-disable MD034 -->
 ✨ You can now login to the app at http://localhost:8989
+<!-- markdownlint-enable MD034 -->
 
 ## Acknowledgments
+
 - This app is based off of [OSM/Hydra](https://github.com/kamicut/osmhydra)