Introduction

Ginboot is a lightweight and powerful Go web framework built on top of Gin. It handles the code every production API ends up writing (request binding, error mapping, configuration, repositories, tracing) so you can go from an empty directory to a production-ready API without assembling the plumbing yourself. Handlers stay plain Go functions: there are no annotations, no DI container and no code generation.

Start here

Why Ginboot

• Database agnostic — a single GenericRepository[T] interface over MongoDB, SQL and DynamoDB, giving you CRUD and pagination with almost no code. See Database Support.
• Runs anywhere — the same controllers serve HTTP locally and API Gateway events on AWS Lambda, with the runtime detected automatically. See AWS Lambda Support.
• Declarative configuration — ginboot.yml plus automatic .env loading and environment variable injection, read back through a typed server.Config(). See Configuration.
• Pluggable telemetry — an optional OpenTelemetry plugin (ginboot/telemetry) ships traces, metrics and logs to Grafana or any OTLP backend without bloating the core. See Telemetry.
• Context-bound logger — ctx.Logger().Info(...) correlates every log line with the active distributed trace.
• Service-to-service calls — ctx.CallService(...) resolves targets from config, environment or DNS and propagates W3C trace and auth headers. See Inter-Service Communication.