Start with one package. Grow at your own pace.
A progressive Go toolkit. Small packages, familiar APIs.
English
·
简体中文
·
Documentation
·
API
Progressive Start with a utility package. Grow into a service.
Adopt on demand Use each package independently. Compose them as needed.
Lightweight A compact implementation. Only the Go standard library at runtime.
Fast Fast route matching. Low-overhead middleware composition.
Intuitive Standard HTTP types, familiar contexts, and Go error chains.
Delightful DX Clean, consistent APIs for binding, validation, and responses.
Quick start
Requires Go 1.23+.
go get github.com/hainuoli/mino/rest
mux := rest.NewMux()
mux.Get("/", func(w http.ResponseWriter, r *http.Request) {
httpx.OkJSON(w, "Hello, Mino!")
})
http.ListenAndServe(":8080", mux)
Run the complete example → · Explore progressive adoption →
Bring your existing handlers
Replace the http.ServeMux constructor and keep your registrations.
- mux := http.NewServeMux()
+ mux := rest.NewMux()
mux.HandleFunc("GET /users/{id}", getUser)
Keep your handlers, middleware, and r.PathValue. Enable path cleaning, escaped-path matching, and slash redirects as your existing service requires.
ServeMux migration guide →
Median ns/op . Lower is better.
Workload
Mino
Gin
Chi
go-zero router
Static route
85.5
101.2
220.3
123.4
One path parameter
183.0
127.0
343.5
385.2
Three path parameters
274.5
197.6
499.1
679.2
1,000 static routes
131.3
170.6
355.1
5,328.0
Five middleware layers
254.9
279.1
410.7
304.4
Route + JSON response
178.5
217.9
316.5
219.5
Apple M4 · macOS arm64 · Go 1.25.4 · 2026-11-15. Five 1-second runs, -cpu=1.
Benchmark setup and parameter-route cost
Gin v1.12.0 · Chi v5.5.0 · go-zero v1.10.3.
In-process ServeHTTP benchmarks with identical response work and no default middleware. go-zero uses its standalone router. Network and business logic are excluded.
Mino writes parameters through Request.SetPathValue so handlers can use r.PathValue. For these fresh requests, Go 1.25.4 initializes a parameter map; Gin reuses a pooled parameter slice. This accounts for Mino's additional parameter-storage allocations.
Methodology, allocation analysis, and raw results →
86.6 KiB of source. Zero third-party runtime dependencies.
All six packages total 2,003 production code lines . In a minimal HTTP server, the Mino router adds 88 KiB over the standard-library baseline.
Source and binary measurements
Production source
Code lines
Size
Core utilities
283
11.7 KiB
Router + middleware composition
1,417
59.8 KiB
HTTP helpers
303
15.2 KiB
All six packages
2,003
86.6 KiB
Code lines exclude comments and blank lines. Source size includes comments and whitespace. Tests, examples, and tools are excluded from both counts.
Minimal HTTP server
Binary size
net/http baseline
5.30 MiB
Mino router
5.39 MiB
Go 1.25.4 · linux/amd64 · CGO disabled · -trimpath -ldflags='-s -w'. Both binaries include the Go runtime.
Fixtures and measurement details →
Explore Mino
Getting started · Packages · Guides and examples · API reference
Contributing · Security · MIT License