Yeoman generator for creating RESTful NodeJS APIs, using ES6, Mongoose and Express. The fastest way to get your project up and running using an awesome stack.
- Make sure you have yeoman installed on your machine:
npm install -g yo - Install the generator globally:
npm install -g generator-api - Run:
yo api, oryoand chooseApioption
Make sure you have node version >= 6 because this project uses native supported ES6 features.
- Run:
mongodto start the local mongodb in a separated terminal instance (If you don't have mongodb installed locally, visit It's webpage to learn how to install it). - Run:
npm run devto run the app (By default the app will run atlocalhost:8080, you can change this in the config file).
Did you choose Docker (:whale:) support?
You only need Docker and docker-compose installed, forget about having node, mongodb or npm.
- Run:
docker-compose upto run the app. You might needsudofor this one.
NOTE: The Dockerfile uses node:latest as its starting point, if you wish to use another version of Node check out the available ones here.
You'll likely be consuming mongodb as a service, so make sure to set the env var pointing at it. Then run npm start.
Using Docker
Build the Docker container and run it:
sudo docker build -t <image-name> .
sudo docker run \
-p <host-port>:8080 \
-d <image-name> \
-e MONGO_DB_URI=mongodb://<username>:<password>@<host>:<port> \
npm run startAssuming we use user and pet models the generated project will look like this:
├───index.js
├───routes.js
├───package.json
├───config.js
└───lib/
| ├───controller.js
| ├───facade.js
└───model/
├───user/
│ └───controller.js
| └───facade.js
| └───router.js
| └───schema.js
└───pet/
└───controller.js
└───facade.js
└───router.js
└───schema.js
HTTP layer, in this instance you can manage express request, response and next. In lib/controller are the basic RESTful methods find, findOne, findById, create, update and remove. Because this class is extending from there, you got that solved. You can overwrite extended methods or create custom ones here.
This layer works as a simplified interface of mongoose and as business model layer, in this instance you can manage your business logic. Here are some use case examples:
- Validate collection
xbefore creating collectiony - Create collection
xbefore creating collectiony
In lib/facade you have the basic support for RESTful methods. Because this class is extending from there, you got that solved. You can overwrite extended methods or create custom ones here. Also you can support more mongoose functionality like skip, sort etc.
Once you have the generated project, if you want to add a new model you can simply run yo api:model. This will generate a new folder under model, in order to make it work, you just need to import the route into the routes.js.
Example:
- Run
yo api:model, write foo (What ever model name you want) - Go to
routes.jsand import the new generated model routeconst foo = require('./model/foo/router') - Use the imported route
router.use('/foo', foo)
Contributors are welcome, please fork and send pull requests! If you find a bug or have any ideas on how to improve this project please submit an issue.
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent