Documentation

Eleven sections, in the order recommended for first-time readers. Every page has a Markdown companion at the same path with a .md suffix.

• Configuration

  RedirectTrailingSlash, RedirectFixedPath, HandleMethodNotAllowed, CaseInsensitive, NotFound, MethodNotAllowed, and the security-relevant defaults.

• Cookbook

  Recipes for the patterns that come up most often: graceful shutdown, file uploads, server-sent events, static files, and more.

• Error handling

  HandlerFuncE, HTTPError, and the typed error pipeline. How errors are surfaced, logged, rendered, and turned into HTTP responses.

• Getting started

  Install MuxMaster, register a route, run the server, and verify the response. The shortest path to a running router.

• Groups

  Compose route prefixes, scoped middleware, and nested groups with mux.Group. Includes the With, Route, and Mount idioms with worked examples.

• Maximum performance

  Zero-allocation hot path with PoolRequestBundle and PoolFastParams: the lifetime contract, the failure modes, and four recipes. 45 ns / 0 B / 0 allocs on a 1-param route.

• Middleware

  The 17 bundled middleware constructors covering request lifecycle (RequestID, Recoverer, Logger), transport (Compress, RealIP, CleanPath, StripSlashes, NoCache, SetHeader), throughput (Timeout, Throttle), and authentication (BasicAuth, APIKey, JWTAuth, OAuth2Introspect, CORS).

• Migration

  Mapping idioms from net/http, gorilla/mux, chi, gin, and httprouter onto MuxMaster. Side-by-side examples for the most common migration paths.

• Observability

  Structured logging with slog, RequestID correlation, custom Prometheus metrics middleware, OpenTelemetry tracing, health checks, and pprof.

• Performance

  Allocation profile, FastHandler, the radix-tree lookup cost model, and the benchmarks that back the documented latency and throughput numbers.

• Response helpers

  JSON, XML, Text, Redirect, NoContent, and the typed Params accessors that read URL parameters without reflection or per-request allocation.

• Routing

  Define static, parametric, and catch-all routes; pattern syntax; match precedence; and the trade-offs the MuxMaster radix tree makes.