https://github.com/eugeniusms/go-web-boilerplate
A boilerplate for go applications using Go Fiber, Postgres, JWT, Oauth2, Docker, Swagger, Mailer, Metrics.
https://github.com/eugeniusms/go-web-boilerplate
boilerplate docker fiber golang jwt mailer metrics oauth2 postgres swagger template web
Last synced: about 2 months ago
JSON representation
A boilerplate for go applications using Go Fiber, Postgres, JWT, Oauth2, Docker, Swagger, Mailer, Metrics.
- Host: GitHub
- URL: https://github.com/eugeniusms/go-web-boilerplate
- Owner: eugeniusms
- Created: 2023-06-08T14:27:54.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2023-06-11T07:48:11.000Z (about 3 years ago)
- Last Synced: 2025-02-22T22:41:30.601Z (over 1 year ago)
- Topics: boilerplate, docker, fiber, golang, jwt, mailer, metrics, oauth2, postgres, swagger, template, web
- Language: Go
- Homepage:
- Size: 67.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Go Web Boilerplate
This boilerplate is for applications using go with Postgres.
Lib used:
- github.com/go-playground/validator/v10
- github.com/goccy/go-json
- github.com/gofiber/fiber/v2
- github.com/gofiber/swagger
- github.com/golang-jwt/jwt
- github.com/golang-module/carbon
- github.com/kelseyhightower/envconfig
- github.com/pkg/errors
- github.com/sendinblue/APIv3-go-library/v2
- github.com/sirupsen/logrus
- github.com/swaggo/swag
- github.com/twharmon/gouid
- go.uber.org/dig
- golang.org/x/crypto
- gorm.io/driver/postgres
- gorm.io/gorm
## Getting started
First, clone this project with the following command:
```
git clone https://github.com/eugeniusms/go-web-boilerplate.git YourAppName
```
Then, if you want to rename your module, you can edit this first line of your go.mod
```
module go-web-boilerplate >>> module YourAppName
```
⚠ If you change it, some files will show new issues because they depend on this package. For example in ```application/auth/service.go```, you have to change ```go-web-boilerplate/application/auth``` to ```YourAppName/application/auth```
Then download all the dependencies using
```bash
go mod download
```
After this, you can run your app using
```bash
go run main.go
```
or build it using
```bash
go build
```
This will generate an executable file named ``.
## Wiki
- SQL Drivers : https://github.com/golang/go/wiki/SQLDrivers
## Contribute
Feel free to contribute, this project will be greater for anyone.
## Authors
[@Nofaldi Atmam](https://github.com/nofamex), [@Haikal Susanto](https://github.com/haikalSusanto), [@Eugenius Mario](https://github.com/eugeniusms)