MINO / SMALL STEPS. OPEN POSSIBILITIES.

Start small.
Grow your way.

Adopt what you need. Compose as you grow. Keep writing familiar Go.

go get github.com/hainuoli/mino

Go 1.23+·MIT·Zero third-party runtime dependencies

01

Progressive

From one utility to an HTTP service, at your own pace.

02

Lightweight

2,003 production code lines. Zero third-party runtime dependencies.

03

Fast

85.5 ns/op for static routes. Lowest median in four of six measured workloads.

04

Great DX

Useful defaults and consistent conventions, with less repetitive code.

05

Intuitive

Standard HTTP handlers, contexts, and error chains. Familiar Go.

06

Adopt on demand

Use the packages you need, independently or together.

HELLO, MINO.

Familiar Go.
A natural start.

A standard HTTP handler. One call to return JSON. Save as main.go to run your first Mino service.

Run this example
main.gonet/http + Mino
package main

import (
	"log"
	"net/http"

	"github.com/hainuoli/mino/rest"
	"github.com/hainuoli/mino/rest/httpx"
)

func main() {
	mux := rest.NewMux()

	mux.Get("/", func(w http.ResponseWriter, r *http.Request) {
		httpx.OkJSON(w, "Hello, Mino!")
	})

	log.Fatal(http.ListenAndServe(":8080", mux))
}
GET /"Hello, Mino!"200 OK

01 / ROOM TO GROW

Room to grow.

Progressive adoption
1

Start with one package

Encode JSON, wrap errors, or compose existing middleware.

jsonx · errorx · mapping · chain
2

Add request handling

Bring in binding, validation, and responses. Keep standard handlers.

httpx.Parse → Validate → OkJSON
3

Grow into a service

Add routing, groups, and middleware around the same handlers.

rest.NewMux → Route → Use

02 / AT HOME IN NET/HTTP

Your existing service.
A small next step.

Replace the constructor. Keep your registrations, handlers, middleware, and server setup. Enable path policies to match your existing service.

Move from ServeMux
Start heremain.go
− mux := http.NewServeMux()
+ mux := rest.NewMux()

  mux.HandleFunc("GET /users/{id}", getUser)
http.Handler→r.PathValue→Keep your code

03 / SMALL CODE. MEASURED SPEED.

Speed, with the evidence.

See the methodology

85.5ns/op

Static routing · Lowest median in four of six workloads

88 KiB

Added binary size over a minimal net/http server.

Footprint details
Time in ns/op; lower is better.
Scenario / ns/opMinoGinChigo-zero router
Static route85.5101.2220.3123.4
One parameter183.0127.0343.5385.2
Three parameters274.5197.6499.1679.2
1,000 routes131.3170.6355.15,328.0
Five middleware layers254.9279.1410.7304.4
Route + JSON178.5217.9316.5219.5

Apple M4 · Go 1.25.4 · Median of five runs · -cpu=1 · 2026-11-15

In-process ServeHTTP without default middleware; go-zero uses its standalone router.

Gin leads the parameter workloads. Mino currently allocates a map when populating standard PathValue. Read the analysis ↗

YOUR CODE. YOUR PACE.

Start with the part you need.

Build your first Mino service