Contrib Modules

Kruda ships optional contrib modules as separate Go modules with their own go.mod. Install only what you need.

Available Modules

Module	Install	Description
jwt	go get github.com/go-kruda/kruda/contrib/jwt	JWT sign, verify, refresh (HS256/384/512, RS256)
ws	go get github.com/go-kruda/kruda/contrib/ws	WebSocket upgrade, RFC 6455 frames, ping/pong
ratelimit	go get github.com/go-kruda/kruda/contrib/ratelimit	Token bucket / sliding window rate limiting
session	go get github.com/go-kruda/kruda/contrib/session	Session middleware with pluggable store
compress	go get github.com/go-kruda/kruda/contrib/compress	Response compression (gzip, deflate)
etag	go get github.com/go-kruda/kruda/contrib/etag	ETag response caching
cache	go get github.com/go-kruda/kruda/contrib/cache	Response cache (in-memory, Redis)
otel	go get github.com/go-kruda/kruda/contrib/otel	OpenTelemetry tracing
prometheus	go get github.com/go-kruda/kruda/contrib/prometheus	Prometheus metrics
swagger	go get github.com/go-kruda/kruda/contrib/swagger	Swagger UI HTML

Example: JWT Authentication

import (
    "os"
    "github.com/go-kruda/kruda"
    "github.com/go-kruda/kruda/contrib/jwt"
)

// Protect a route group
api := app.Group("/api").Guard(jwt.New(jwt.Config{
    Secret: []byte(os.Getenv("JWT_SECRET")),
}))

api.Get("/profile", func(c *kruda.Ctx) error {
    claims := jwt.ClaimsFrom(c)
    return c.JSON(claims)
})

Example: Rate Limiting

import (
    "time"
    "github.com/go-kruda/kruda/contrib/ratelimit"
)

// 100 requests per minute per IP
app.Use(ratelimit.New(ratelimit.Config{
    Max:    100,
    Window: time.Minute,
}))

// Stricter limit on auth endpoints
app.Use(ratelimit.ForRoute("/api/login", 5, time.Minute))

Example: Response Cache

import (
    "time"
    "github.com/go-kruda/kruda/contrib/cache"
)

app.Get("/users", handler, cache.New(cache.Config{
    Expiration: 5 * time.Minute,
}))