# Massad/gin-boilerplate

The fastest way to deploy a RESTful API with Gin Framework — PostgreSQL, JWT auth, Redis, PDF generation, and Swagger docs out of the box.

Repository: https://github.com/Massad/gin-boilerplate
Canonical: https://ross.abutalabs.com/products/gin-boilerplate
Language: Go
License: MIT
License Family: permissive
Topics: gin-framework, redis, golang, postgresql, boilerplate-template, gin-boilerplate, restful-api, databases, go, go-boilerplate, golang-api, jwt-authentication, middlewares, pdf-generation, redis-database, sqlx, swagger
Last push: 2026-06-03T21:09:35+00:00

## Health v2 (maintenance only)
Score: 73/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 85, release rhythm 43, longevity 100
- inputs: {"age_days": 3803, "days_push": 91, "days_rel": 169, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1220, forks 219 (observed 2026-08-28T04:04:01.965865+00:00)

## What it is
A Go boilerplate project for quickly deploying RESTful APIs using the Gin web framework. It ships with PostgreSQL (via sqlx), JWT authentication backed by Redis, CORS/RequestID/Auth middleware, PDF generation, and Swagger documentation out of the box.

## Use cases
- bootstrap a REST API in Go with Gin
- add JWT authentication with Redis token storage to a Go API
- generate PDF invoices from a Go web service
- set up Swagger documentation for a Gin API
- start a Go project with PostgreSQL and JSONB queries
- quickly scaffold an API with CORS and request ID middleware

## When to choose
- you want a ready-made Gin + PostgreSQL + Redis starting point
- you need JWT auth and Swagger docs wired up from day one
- you're building a Go REST API and want sensible project structure and middleware included

## When to avoid
- you use an ORM-first stack or a database other than PostgreSQL
- you need a framework-agnostic or microservice-template solution rather than Gin
- you want a production-hardened, batteries-included framework instead of a starter template you must extend

## Facets
- artifact type: learning-resource
- maturity: active
- function: web-framework, auth, caching, database-driver, pdf, api-framework, middleware, api-documentation
- domain: web-development, backend, developer-tools, apis
- platform: go, windows, cross-platform
- tags: gin-framework, restful-api, jwt-authentication, postgresql, redis, sqlx, swagger, starter-template, cors, invoice-pdf, boilerplate, linux, macos

## Member repositories
- Massad/gin-boilerplate (main) score 73

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:01.965865+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T08:33:21.123271+00:00, confidence not recorded.
  - readme: https://github.com/Massad/gin-boilerplate (fetched 2026-08-28T04:04:01.965865+00:00, sha cc02daaae46e)
- Data as of 2026-08-30T08:39:29.467469+00:00.