# qiangxue/go-rest-api

An idiomatic Go REST API starter kit (boilerplate) following the SOLID principles and Clean Architecture

Repository: https://github.com/qiangxue/go-rest-api
Canonical: https://ross.abutalabs.com/products/go-rest-api
Language: Go
License: MIT
License Family: permissive
Last push: 2022-02-07T01:35:15+00:00

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

## Adoption (not part of the score)
Stars 1696, forks 278 (observed 2026-08-28T04:05:23.910742+00:00)

## What it is
A Go boilerplate/starter kit for building RESTful API services following SOLID principles and Clean Architecture. It ships with JWT authentication, CRUD endpoints, structured logging, database migrations, validation, and full test coverage out of the box.

## Use cases
- bootstrap a new Go REST API project
- learn clean architecture in Go
- starter template with JWT authentication
- Go backend project structure with CRUD and migrations
- idiomatic Go API server skeleton
- example of testable Go web service

## When to choose
- starting a new Go REST API service and wanting a proven structure
- you want SOLID/clean-architecture conventions with batteries included
- you need JWT auth, migrations, validation, and logging prewired

## When to avoid
- you need a framework-agnostic or micro-framework-free setup
- the project's chosen libraries (ozzo-routing, ozzo-dbx) don't fit your stack
- you need actively evolving features - latest release is 2022 and it's in maintenance mode

## Facets
- artifact type: learning-resource
- maturity: maintenance
- function: api-framework, http-server, auth, logging, testing, orm
- domain: backend, web-development, developer-tools, apis
- platform: go, windows
- tags: rest-api, clean-architecture, solid-principles, starter-kit, jwt, crud, database-migration, postgresql, boilerplate, docker, linux, macos

## Member repositories
- qiangxue/go-rest-api (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:23.910742+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:32:30.553751+00:00, confidence not recorded.
  - readme: https://github.com/qiangxue/go-rest-api (fetched 2026-08-28T04:05:23.910742+00:00, sha c3e8f180c8f1)
- Data as of 2026-08-30T08:39:29.467469+00:00.