Minimalistic HTTP server template in Go that is:

• Small (less than 300 lines of code)
• Single file
• Only standard library dependencies

Not a framework, but a starting point for building HTTP services in Go. This project was first introduced in GopherCon Korea 2024, See session in this link(in Korean) and see presentation in this link(in English)

Inspired by Mat Ryer & earthboundkid and even kickstart.nvim

• Graceful shutdown: Handles SIGINT and SIGTERM signals to shut down gracefully.
• Health endpoint: Returns the server's health status including version and revision.
• OpenAPI endpoint: Serves an OpenAPI specification using embed package
• Debug information: Provides various debug metrics including pprof and expvars.
• Access logging: Logs HTTP request details using slog.
• Panic recovery: Catch and log panics in HTTP handlers gracefully.
• Fully documented: Includes comments and documentation for all exported functions and types.

• Use this template to create a new repository
• Or fork the repository and make changes to suit your needs.

Go 1.22 or later

• golangci-lint
• air

$ make run

• this will build the server and run it on port 8080
• Checkout Makefile for more

• GET /health: Returns the health of the service, including version, revision, and modification status.
• GET /openapi.yaml: Returns the OpenAPI specification of the service.
• GET /debug/pprof: Returns the pprof debug information.
• GET /debug/vars: Returns the expvars debug information.

• Use this template to create a new repository
• Or fork the repository and make changes to suit your needs.
• Find and replace all strings raeperd/kickstart.go with your repository/image name

$ sed -i '' '/^\/\/go:embed/! {/^\s*\/\/.*$/d; /^\s*\/\*\*/,/\*\//d;}' *.go

• GopherCon Korean 2024 Session (in Korean)
• How I write HTTP services in Go after 13 years | Grafana Labs