goServe

An api server starter kit using gin, mongodb, jwt authentication

goServe is a seed project for you to kickstart golang restful api project.It tries to mimic Django by providing essential package such as basic authentication, social authentication, database connection and more to come. However, unlike Django, goServe only tries to serve the needs of Single Page Application and mobile application.

To use

1. put this project into go src directory
2. modify config.json to configure your app (mongodb url, jwt key, email)
3. go run main.go

gin

goServe uses Gin as the framework. Gin provides excellent middlewares and uses httprouter for its performance.

mongodb

goServe uses Mgo as the MongoDB driver. Enjoy.

jwt auth flow

goServe implements the authentication flow with json web token. Token-based authentication provides better decoupling, scalability and real stateless api. For more information, go to ins and outs of token-based auth

Auth supports:

1. email password
2. facebook auth

Deploy to VPS

1. install Go and config GOPATH
2. install Git and clone your project
3. install Supervisor
4. build your app into bin
5. use Supervisord to keep process running in the background (property “directory” denotes where your app runs from. Thus, keep your JSON config file in this directory)