Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vsouza/go-gin-boilerplate
A starter project with Golang, Gin and DynamoDB
https://github.com/vsouza/go-gin-boilerplate
bolierplate dynamodb gin gin-boilerplate golang starter-project travis-image
Last synced: 7 days ago
JSON representation
A starter project with Golang, Gin and DynamoDB
- Host: GitHub
- URL: https://github.com/vsouza/go-gin-boilerplate
- Owner: vsouza
- Created: 2016-07-21T13:41:16.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-06-26T14:17:31.000Z (8 months ago)
- Last Synced: 2025-01-24T12:07:30.263Z (14 days ago)
- Topics: bolierplate, dynamodb, gin, gin-boilerplate, golang, starter-project, travis-image
- Language: Go
- Homepage:
- Size: 68.4 KB
- Stars: 764
- Watchers: 15
- Forks: 162
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-gin - vsouza/go-gin-boilerplate
README
# Go Gin Boilerplate
> A starter project with Golang, Gin and DynamoDB
[![Build Status][travis-image]][travis-url]
[](https://codebeat.co/projects/github-com-vsouza-go-gin-boilerplate)
[![Go Version][go-image]][go-url]
[![License][license-image]][license-url]
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fvsouza%2Fgo-gin-boilerplate?ref=badge_shield)
Golang Gin boilerplate with DynamoDB resource. Supports multiple configuration environments.
This project use a [DynamoDB base docker image](https://github.com/vsouza/docker-dynamoDB-local).
Setup DynamoDB dependency: `docker run -d -p 8080:8080 vsouza/dynamo-local --port 8080`
### Boilerplate structure
```
.
├── Makefile
├── Procfile
├── README.md
├── config
│ ├── config.go
│ ├── development.yaml
│ ├── production.yaml
│ └── test.yaml
├── controllers
│ └── user.go
├── db
│ └── db.go
├── forms
│ └── user.go
├── header.jpg
├── main.go
├── middlewares
│ └── auth.go
├── models
│ └── user.go
└── server
├── router.go
└── server.go
```
## Installation
```sh
make deps
```
## Usage example
`curl http://localhost:8888/health`
## Development setup
Running DynamoDB on Docker Image:
check this project: [vsouza/docker-dynamoDB-local](https://github.com/vsouza/docker-dynamoDB-local)
## Release History
* 0.0.2
* Auth middleware with sha checking. Support multiple config files.
* 0.0.1
* Configuration by environment, Auth and Log middlewares, User entity.
## Meta
Vinicius Souza – [@iamvsouza](https://twitter.com/iamvsouza) – [email protected]
Distributed under the MIT license. See [License](https://vsouza.mit-license.org) for more information.
[https://github.com/vsouza](https://github.com/vsouza)
[go-image]: https://img.shields.io/badge/Go--version-1.9-blue.svg
[go-url]: https://golang.org/doc/go1.9
[travis-image]: https://travis-ci.org/vsouza/go-gin-boilerplate.svg?branch=master
[travis-url]: https://travis-ci.org/vsouza/go-gin-boilerplate
[license-image]: https://img.shields.io/badge/License-MIT-blue.svg
[license-url]: https://vsouza.mit-license.org
## License
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fvsouza%2Fgo-gin-boilerplate?ref=badge_large)