Skip to content

Commit 27b7581

Browse files
Merge pull request #203 from AndelaOSP/ch-update-ReadMe-165309154
#165149995 Update ReadMe
2 parents 6390211 + 7d9ebb0 commit 27b7581

File tree

1 file changed

+22
-18
lines changed

1 file changed

+22
-18
lines changed

README.md

Lines changed: 22 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,18 @@ WIRE-API powers [WIRE](https://github.com/AndelaOSP/wire)
99

1010
Ensure you have the following installed locally:
1111

12-
* [Postgres](https://www.postgresql.org/)
12+
- [Postgres](https://www.postgresql.org/)
1313

14-
* [Node](https://nodejs.org/en/)
14+
- [Node](https://nodejs.org/en/)
1515

1616
Clone repo:
17+
1718
```
1819
git clone https://github.com/AndelaOSP/wire-api.git
1920
```
2021

2122
Navigate to repo:
23+
2224
```
2325
cd wire-api/src
2426
```
@@ -29,25 +31,26 @@ Install all dependencies:
2931
yarn install
3032
```
3133

32-
Start Postgres and create `wired_dev` database if it does not exist.
34+
Start Postgres and create a database named `wire_dev` if it does not exist.
3335

34-
Set up the environment variables appropriately by renaming `.env.example` to `.env` and updating it with the required values described below:
35-
- NODE_ENV : environment you are running on (`development` for local setup)
36-
- DATABASE_URL : Postgres url for the database (`postgres://localhost:5432/wire_dev` for local setup)
37-
- PORT : port in which the app will be listening (`3000` for local setup)
38-
- SECRET_KEY : secret key used to generate the api tokens
39-
- EMAIL_SENDER : email address used to send invite emails (consult team lead)
40-
- EMAIL_PASSWORD : password for the above email address
41-
- SLACK_BUG_WEBHOOK_URL : webhook url for sending api errors to slack (consult team lead)
42-
- EMAIL_VERIFICATION_URL : andela user service endpoint for listing users (consult team lead)
43-
- API_TOKEN : authorization token used while querying the user service (consult team lead)
36+
Set up the environment variables appropriately by renaming `.env.example` to `.env`.
4437

45-
Setup database url for migrations:
46-
```
47-
export DATABASE_URL = postgres://localhost:5432/wire_dev
48-
```
38+
Ensure the `.env` file has the following key value pairs for your local setup
39+
40+
41+
| Key | Description | Value |
42+
| ---------------------- | -------------------------------------------------------- | ---------------------------------- |
43+
| NODE_ENV | Environment you are running the app | development |
44+
| DATABASE_URL | Postgres url for the database | postgres://localhost:5432/wire_dev |
45+
| PORT | Port the app is listening to | 3000 |
46+
| SECRET_KEY | Secret key used to generate the api tokens | consult team lead |
47+
| EMAIL_SENDER | Email address used to send invite emails | consult team lead |
48+
| EMAIL_PASSWORD | Password for the above email address | consult team lead |
49+
| EMAIL_VERIFICATION_URL | Andela user service endpoint for listing users | consult team lead |
50+
| API_TOKEN | Authorization token used while querying the user service | consult team lead |
4951

5052
Run migrations and seeders:
53+
5154
```
5255
yarn run migrate-seed
5356
```
@@ -65,6 +68,7 @@ Navigate to the port and test the endpoints on postman
6568
<img width="1097" alt="wire-api" src="https://user-images.githubusercontent.com/16113214/30543777-f7e5ad12-9c8c-11e7-80e0-b5fd3fa36546.png">
6669

6770
### Api Documentation
68-
The API documentation can be found here:
71+
72+
The API documentation can be found here:
6973

7074
[![Run in Postman](https://run.pstmn.io/button.svg)](https://www.getpostman.com/collections/36756909f8349f8b606f)

0 commit comments

Comments
 (0)