summaryrefslogtreecommitdiff
path: root/goodgame/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'goodgame/README.md')
-rw-r--r--goodgame/README.md69
1 files changed, 69 insertions, 0 deletions
diff --git a/goodgame/README.md b/goodgame/README.md
new file mode 100644
index 0000000..1f8f3d2
--- /dev/null
+++ b/goodgame/README.md
@@ -0,0 +1,69 @@
+# Goodgame Application test
+
+Comes with:
+
+- ES6 support.
+- API documentation using Swagger.
+- ESLint for code linting.
+- Configuration management using dotenv.
+- Logging of requests with Winston.
+- Tests using Mocha/Chai.
+- Coverage report through nyc.
+
+---
+
+## Check the application live
+
+If you don't want to run it locally, just go to [https://goodgame-test.herokuapp.com/docs/](https://goodgame-test.herokuapp.com/docs/) and experiment with the API
+
+### Expert mode
+Open a terminal and use the following command:
+
+```bash
+curl -X POST "https://goodgame-test.herokuapp.com/" -H "accept: application/json" -H "Content-Type: application/json" -d "{ \"amount\": 100}"
+```
+You can edit the amount directly on the command
+
+---
+
+## Prerequisites
+
+- [Node.js](https://yarnpkg.com/en/docs/install)
+- [NPM](https://docs.npmjs.com/getting-started/installing-node)
+
+## Setup
+
+Install the dependencies and get started right away.
+
+ $ cd goodgame
+ $ npm install
+
+Make a copy of `.env.example` as `.env` and update your application details and database credentials.
+
+### Environment variables description
+
+- `NODE_ENV`: The node environment
+- `PORT`: Application port. If not specified, it defaults to port 7777.
+- `TEST_PORT`: Port to run tests.
+- `URL`: The server's URL. Used by swagger docs explorer
+
+This in an example of a `.env` file
+
+```env
+NODE_ENV=development
+PORT=7777
+TEST_PORT=3333
+URL=localhost
+```
+
+### Starting the application
+
+ $ npm start
+
+Navigate to [http://localhost:7777/docs/](http://localhost:7777/docs/) to verify the instalation.
+
+## Tests
+
+If you have set the test database on the .env file, you can run the tests by using
+
+ $ npm run test