← Back to archive

Repo of the Day

go-kvolt/kvolt

Published: Nov 19, 2026

Open repository ↗

Go web framework on net/http: radix router, context API, and middleware. Optional Redis, Prometheus, and gRPC. Production-promising v2.1 — Go 1.27+

Summary

KVolt is a Go web framework built on net/http, with a radix router, a context-based request API, middleware, and graceful shutdown. The README documents v2.5.1 and Go 1.27+, while Redis, Prometheus, OpenTelemetry, and gRPC support is available through separate optional imports.

What it is useful for

KVolt is useful for building HTTP APIs with familiar routing and JSON handling while staying on Go’s standard net/http foundation. Routes can include parameters such as /users/:id, static suffixes, wildcards, and groups, with helpers for trailing slashes and 405 responses.

The default application includes recovery, request IDs, and a 1 MB request-body limit. Available middleware covers logging, timeouts, CORS, gzip, rate limiting, CSRF, secure headers, JWT, API keys, basic authentication, tenant handling, RBAC, idempotency keys, and audit trails.

The framework also provides JSON binding and validation, cookies, server-sent events, WebSockets, safe uploads, sessions, an in-memory queue, and a sharded memory cache. Redis-backed caching and queues, Prometheus metrics, OpenAPI generation with Scalar UI, and HTTP/gRPC dual serving are also documented. Examples cover a full application, tenant and RBAC handling, background jobs, and running HTTP and gRPC together.

How engineers can use it

Start with Go 1.27 or newer, then install the documented module release:

go get github.com/go-kvolt/kvolt/[email protected]

Create an application using kvolt.Default(), register middleware and routes, and call app.Run(":8080"):

app := kvolt.Default()
app.Use(middleware.Logger())

app.GET("/ping", func(c *context.Context) error {
	return c.JSON(200, map[string]string{"message": "pong"})
})

if err := app.Run(":8080"); err != nil {
	log.Fatal(err)
}

Run it with:

go run .

The endpoint is then available at http://localhost:8080/ping. For write APIs, handlers can use c.Bind with JSON and validation tags, return validation errors, and respond with c.JSON.

The CLI provides a scaffold with health, OpenAPI, and tenant endpoints:

go install github.com/go-kvolt/kvolt/v2/cmd/[email protected]
kvolt new my-app
cd my-app && go mod tidy && go run ./cmd/api

If kvolt is not found, the README says to add $(go env GOPATH)/bin to PATH.

Notable constraints are the 1 MB default body limit and the documented at-least-once behavior of the Redis queue, which requires job handlers to account for repeated delivery. The repository’s own development workflow includes go test ./....