A boilerplate for kickstart your nodejs api project with JWT Auth and some new Techs :)
MIT License
This Boilerplate use webpack 3 to compile code.
git clone https://github.com/EQuimper/nodejs-api-boilerplate.git
.yarn install
or npm i
.env
file in the root like the .env.example
file.With Homebrew you can just run brew install mongodb
and after brew services start mongodb
.
For get raven log create account here: Sentry
For security have add a whitelist function for your req.body
coming from the front end. You can take a look of it in the contants.js
file.
const WHITELIST = {
posts: {
create: ['title', 'text'],
update: ['title', 'text'],
},
users: {
create: ['email', 'username', 'password'],
},
};
Api doc his hosted on surge. Link. For change the url and have your own docs just add you link in the .env
file.
I've add pre-commit
and lint-staged
for lint your code before commit. That can maybe take time :bowtie:
yarn dev
or
npm run dev
PS That can crash if this is the first time but don't worry give it 2 sec the scripts gonna work. He just need to created a dist folder :) This way you have only one command to run.
yarn dev:debug
or
npm run dev:debug
toJSON()
help us to get only the data we want when we push the info to the client. So now we just need to put the user object in the res.json(user)
and we received only what we want. Why toAuthJSON()
? Cause if we populated the post we get the toJSON()
so the toAuthJSON()
is the on to call on signup and login for get the token and _id.
toAuthJSON() {
return {
_id: this._id,
token: `JWT ${this.createToken()}`,
};
},
toJSON() {
return {
_id: this._id,
username: this.username,
};
},
I'm using Joi in this boilerplate, that make the validation really easy.
export const validation = {
create: {
body: {
email: Joi.string().email().required(),
password: Joi.string().regex(/^[a-zA-Z0-9]{3,30}$/).required(),
username: Joi.string().min(3).max(20).required(),
},
},
};
routes.post(
'/signup',
validate(UserController.validation.create),
UserController.create,
);
For seed just run one of this following comand. This is helpful in dev for making fake user.
This is only available in dev environment
You can change the number of seed by changing the number in each script inside /scripts/seeds
yarn db:seeds-user
yarn db:seeds-clear-user
yarn db:seeds-clear
Monitoring Server on http://localhost:3000/status
bash scripts/development.sh
Thanks goes to these wonderful people (emoji key):
Emanuel Quimper💬 📝 🐛 💻 📖 💡 🚇 🔌 👀 ⚠️ 🔧 ✅ | Cristian Penarrieta⚠️ |
---|
This project follows the all-contributors specification. Contributions of any kind welcome!