A curated collection of reusable Go packages for common infrastructure concerns.
Gobox is a Go module that centralizes shared libraries reused across multiple projects. The goal is to keep common building blocks in one place so teams can reduce code duplication, standardize recurring infrastructure concerns, and move faster when starting or evolving services.
Each package is independently importable, has zero knowledge of the others, and ships with its own README and godoc.
go get github.com/raykavin/goboxThen import only the packages you need:
import "github.com/raykavin/gobox/log"
import "github.com/raykavin/gobox/retry"| Package | Description |
|---|---|
log |
Structured logger built on zerolog with colored console output, JSON mode, and HTTP request logging |
telemetry |
OpenTelemetry bootstrap: OTLP tracing, Prometheus metrics, and pluggable custom collectors |
healthcheck |
Health snapshot with concurrent database probes and Go runtime diagnostics |
| Package | Description |
|---|---|
httpclient |
Thin HTTP client wrapper with header presets, query params, and response decompression (gzip, br, zstd) |
httpserver |
Gin-based HTTP server with TLS, HTTP/2, timeouts, payload limits, and graceful shutdown |
| Package | Description |
|---|---|
database/gorm |
GORM connection factory with pooling, structured logging, and retry support |
database/migrate |
Schema migration and seed execution via golang-migrate (postgres, mysql, sqlite3) |
database/sql |
Generic database/sql connector with a caller-supplied row scanner |
| Package | Description |
|---|---|
config |
Configuration loading with Viper: env expansion, validation, hot-reload, and typed change events |
retry |
Context-aware retry with exponential backoff and caller-defined retry policy |
| Package | Description |
|---|---|
temporal |
Temporal client factory and activity options builder with sensible retry defaults |
| Package | Description |
|---|---|
oidcauth |
OIDC token verification with optional in-memory cache and Keycloak role helpers |
| Package | Description |
|---|---|
spreadsheet |
CSV and XLSX writer with multi-sheet support and configurable header styling |
cli |
Terminal helpers: ASCII art banner, colored system header, and concurrent progress display |
| Package | Description |
|---|---|
integration/prest |
Generic OAuth2-authenticated HTTP client for pREST APIs with typed JSON responses |
A good rule of thumb: move code here when it appears in more than one service, represents generic infrastructure logic, and carries no business-domain coupling. Keep domain rules in the application.
Contributions to gobox are welcome! Here are some ways you can help:
- Report bugs and suggest features by opening issues on GitHub
- Submit pull requests with bug fixes or new features
- Improve documentation to help other users and developers
gobox is distributed under the MIT License.
For complete license terms and conditions, see the LICENSE file in the repository.
For support, collaboration, or questions about gobox:
Email: raykavin.meireles@gmail.com
GitHub: @raykavin