GraphQL NodeJS Boilerplate

GraphQL NodeJS Boilerplate allows you to start new server side web project from scratch using NodeJS, Express, GraphQL and Typescript.

Also this boilerplate contains babel configuration to use all lates ES7+ features.

This is a backend part of GraphQL boilerplate projects. You can also review graphql-react-boilerplate to see how things works on the client side.

Installation

Use these steps to install project

Postgres DB

This boilerplate based on PostgreSQL database, but you can easily change it to any other preferable database. Project uses TypeORM as ORM for your database.

You can install Docker postgress image:

docker run -p 5434:5434 --name graphql_boilerplate_db -d postgres:latest

Than you should create database graphql_boilerplate

Dont forget to add Postgres connection credentials to .env file

Example .env file:

DB_HOST=localhost
DB_PORT=32768
DB_USERNAME=postgres
DB_PASSWORD=
DB_DATABASE=graphql_boilerplate

For local development use: yarn run start

To build project run: yarn run build

To serve built files run: yarn run serve

Usage

In this project you can review how could be designed and developed such basic parts of an application:

Authentication using JWT based on GraphQL mutations.
All API calls are secured with access token. You can manage live time of access token and refresh it with additional refresh token.
GraphQL mutations and queries using expres-graphql
All parts of application developed using Typescript, you can review how to use GraphQL with NodeJS and Typescript.
Project uses TypeOrm ORM to easily manage Postgress database from your NodeJS application.

Main technologies and libraries

Contributing

Fork it!
Create your feature branch: git checkout -b my-new-feature
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin my-new-feature
Submit a pull request :D

Author

Vlad Morzhanov

morzhanov / graphql-nodejs-boilerplate Goto Github PK