Plug ang play node.js REST API for mongo. Uses the same syntax as RestHeart but is implemented usigng node.js. Core node.js express boilerplate taken from express-mongoose-es6-rest-api. Make shure to check out!
Some Restheart features aren't implemented yet (json schema validation, aggregations, file storage) Fell free to colaborate
Api documented with swagger at /docs, (default host is localhost:4040)
Resources routes from Restheart are implemented at folder /server/api (in case you need to change)
Custom routes can be added at /server/plugins, there is an example folder demonstrating how to add new ones, just be aware that custom routes replaces the defalt ones if they have the same name.
Use docker to help deployment
Let me know any usefull feedbacks: alon.mota.l@gmail.com
ES6 support using Babel.
JavaScript code linting is done using ESLint - a pluggable linter tool for identifying and reporting on patterns in JavaScript. Uses ESLint with eslint-config-airbnb, which tries to follow the Airbnb JavaScript style guide.
Supports code coverage of ES6 code using istanbul and mocha. Code coverage reports are saved in coverage/
directory post yarn test
execution. Open coverage/lcov-report/index.html
to view coverage report. yarn test
also displays code coverage summary on console. Code coverage can also be enforced overall and per file as well, configured via .istanbul.yml
Promisified Code via bluebird, all our code is promisified, even the tests via supertest-as-promised.
API parameter validation via express-validation, validate body, params, query, headers and cookies of a request (via middleware) and return a response with errors;
Runs lint and tests before any commit is made locally, making sure that only tested and quality code is committed
Secure app via helmet
-
CORS support via cors
-
Uses http-status to set http status code. It is recommended to use
httpStatus.INTERNAL_SERVER_ERROR
instead of directly using500
when setting status code. -
Has
.editorconfig
which helps developers define and maintain consistent coding styles between different editors and IDEs.
Clone the repo
Install yarn:
npm install -g yarn
Install dependencies:
yarn
Set environment (vars):
cp .env.example .env
Start server:
# Start server
yarn start
Clone the repo
Install docker and docker compose
run using docker:
docker-compose up
Tests:
# Run tests written in ES6
yarn test
# Run test along with code coverage
yarn test:coverage
# Run tests on file change
yarn test:watch
# Run tests enforcing code coverage (configured via .istanbul.yml)
yarn test:check-coverage
Lint:
# Lint code with ESLint
yarn lint
# Run lint on any file change
yarn lint:watch
Other gulp tasks:
# Wipe out dist and coverage directory
gulp clean
# Default task: Wipes out dist and coverage directory. Compiles using babel.
gulp
# compile to ES5
1. yarn build
# upload dist/ to your server
2. scp -rp dist/ user@dest:/path
# install production dependencies only
3. yarn --production
# Use any process manager to start your services
4. pm2 start dist/index.js
In production you need to make sure your server is always up so you should ideally use any of the process manager recommended here. We recommend pm2 as it has several useful features like it can be configured to auto-start your services if system is rebooted.
Universal logging library winston is used for logging. It has support for multiple transports. A transport is essentially a storage device for your logs. Each instance of a winston logger can have multiple transports configured at different levels. For example, one may want error logs to be stored in a persistent remote location (like a database), but all logs output to the console or a local file. We just log to the console for simplicity, you can configure more transports as per your requirement.
Logs detailed info about each api request to console during development.
Logs stacktrace of error to console along with other details. You should ideally store all error messages persistently.
Get code coverage summary on executing yarn test
yarn test
also generates HTML code coverage report in coverage/
directory. Open lcov-report/index.html
to view it.
# service restarts on file change
bash bin/development.sh
# To use this option you need to make sure mongodb is listening on port 27017
# Build docker
docker build -t express-mongoose-es6-rest-api .
# Run docker
docker run -p 4040:4040 express-mongoose-es6-rest-api
If you would prefer not to use any of our tooling, delete the following files from the project: package.json
, gulpfile.babel.js
, .eslintrc
and .travis.yml
. You can now safely use the boilerplate with an alternative build-system or no build-system at all if you choose.
- Gulp recipes - the official Gulp recipes directory includes a comprehensive list of guides for different workflows you can add to your project.
Contributions, questions and comments are all welcome and encouraged. For code contributions submit a pull request with unit test.
This project is licensed under the MIT License
If you like this project or want a better one, offer me a job and I will deliver.
Alon Mota email: alon.mota.l@gmail.com