Node API Base

Node Api Base is a boilerplate project for JSON RESTful APIs. It's based on Node v10.3.0 and Typescript v3.0.3.

Features

This template comes with:

Schema
- Users table with roles (Admin and Regular by default)
Endpoints
- Sign up regular user
- Sign up admin user with authentication and authorization
- Authentication for both kinds of users
Middleware
- Authentication
- Authorization (based on roles)
- Exception handling
Tests
- Unit tests for user
- Integration tests for API
Code quality tools
API documentation following https://apiblueprint.org/

How to use

Clone this repo
Rename the folder and change name in package.json to the project name
Create an .env file
In the .env file set the following values:
```
JWT_KEY = secret -> a secret value for json web token hashing
DATABASE_URL = database url with format postgres://user:secret@host:port/database_name
```
If you want to use another database instead of using postgres you'll need to change the app.ts database connection method and also set the database url to an accordingly format
Run yarn
Run yarn run dev to run on development
You can now try your REST services!

Note: when creating an entity it must be exported in models/index.ts in order to be used. Tests: To run the tests after step 5, run yarn run test (make sure to point to a test database on DATABASE_URL)

Deploying to Heroku

Run heroku create appName on the repo
Add Heroku Postgres add-on (or whatever database you're using)
Set environment values in heroku settings, as shown in the previous section (DATABASE_URL is probably already set)
Run git push heroku branch (whatever branch you want to push)

NPM Packages

Api Docs

https://nodeapibase.docs.apiary.io

Current version

v1.0.0

License

Alxzu/node-api-base

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages