• About the Project
• Running the Project
• Prerequisites
• API Documentation
• CONTRIBUTING

This Project serves the backend APIs required for Real Dev Squad web projects. This project is built in Express.js.

$ npm install
$ npm start

$ npm run dev

$ npm run test-config

• The application uses node-config(documentation) for managing config.
• Create a new file: config/local.js. Override the required config values from config/development.js and config/default.js into config/local.js.
• Register the application for GitHub OAuth to get the clientId and clientSecret. Add the callback URL as http:https://<HOSTNAME>:<PORT>/auth/github/callback
• Create an application on FireStore and generate a service file. Add the service file with the name firestore-private-key.json in the project root.
• For running the project locally, Firebase Local Emulator Suite can also be used instead of using the remote DB. Steps for setting it up: CONTRIBUTING.md - Using Firebase Emulator Locally

• View the RDS API documentation: Real Dev Squad API
• You can also run the server and navigate to http:https://<HOSTNAME>:<PORT>/api-docs to view the API documentation.
• You can import the file API Schema to Postman or SwaggerHub.
• If any API changes have been made:
  • Write JS Doc on top of your routes using YAML based annotations in OPEN API 3.0 format.
  • Run npm run generate-api-schema to generate the API schema. A file public/apiSchema.json will be created/updated.

Read more about contributing to the project: CONTRIBUTING