Guide

Installation

Add Zinc to a Go module, import its packages, and manage versions.

Zinc is an ordinary Go module with no code generation or CLI. If you want a guided first run instead, start with the Quickstart.

Requirements

Go 1.25 or newer
A Go module, created with go mod init if you do not have one yet

Install

go get github.com/0mjs/zinc

Import

Zinc has two packages. Both come from the same module, so one go get installs both.

import (
  "github.com/0mjs/zinc"            // app, router, context, binding, responses
  "github.com/0mjs/zinc/middleware" // first-party middleware
)

The core package depends only on the standard library plus encoders for YAML and TOML. The middleware package adds golang-jwt for the JWT middleware. Integrations with larger dependencies, such as OpenTelemetry or the official Prometheus client, stay in your code and plug in through net/http.

Check the installed version

go list -m github.com/0mjs/zinc

Upgrade

go get github.com/0mjs/zinc@latest
go mod tidy

Next steps

Quickstart runs your first server.
Your First Route introduces handlers, input, and errors.