appkit

README

appkit

A composable Go framework for HTTP applications, including configuration, authentication, sessions, logging, encryption, and web serving.

Install

go get github.com/containeroo/appkit

Example

Define your application and management routes, then serve them independently:

app := http.NewServeMux()
app.HandleFunc("GET /", home)

management := http.NewServeMux()
management.HandleFunc("GET /healthz", health)
management.HandleFunc("GET /readyz", readiness)

serverConfig := httpserver.Config{
    Application: app,
    Management:  management,
    RoutePrefix: cfg.Server.RoutePrefix,
}
handlers := httpserver.New(serverConfig)
if err := httpserver.Run(
    ctx,
    cfg.Server.ListenAddress,
    cfg.Server.ManagementListenAddress,
    handlers,
    logger.With("component", "server"),
); err != nil {
    logger.Error("run server", "event", "server_run_failed", "error", err)
    return err
}

See examples/basic for a complete runnable example with configuration flags, logging, graceful shutdown, and both listeners.

go run ./examples/basic --route-prefix /app

curl http://127.0.0.1:8080/app/
curl -i http://127.0.0.1:8081/healthz

Proxy authentication may restrict immediate ingress peers with proxy.TrustCIDRs and config.Proxy.TrustedCIDRs. Use httpauth.AuthorizeWithError for authorization checks that can fail independently of access denial. web.SPA renders the entry point as a Go template, while httpkit/assets.Static serves static files.