Configuration

Use NewWithConfig when you need more than the defaults.

app := zinc.NewWithConfig(zinc.Config{
	CaseSensitive:          true,
	StrictRouting:          true,
	AutoHead:               true,
	AutoOptions:            true,
	HandleMethodNotAllowed: true,
	BodyLimit:              8 << 20,
	ProxyHeader:            zinc.HeaderXForwardedFor,
	TrustedProxies:         []string{"10.0.0.1"},
	RouteCacheSize:         1000,
})

Most applications can start with zinc.New() and add config only when routing behavior, server timeouts, proxy trust, or extension points need to change.

Routing behavior

• CaseSensitive
• StrictRouting
• AutoHead
• AutoOptions
• HandleMethodNotAllowed
• RouteCacheSize

These control how Zinc matches and caches routes.

Server behavior

• ServerHeader
• BodyLimit
• ReadTimeout
• WriteTimeout
• IdleTimeout

Proxy awareness

• ProxyHeader
• TrustedProxies

These affect how client IP helpers behave.

app := zinc.NewWithConfig(zinc.Config{
	ProxyHeader:    zinc.HeaderXForwardedFor,
	TrustedProxies: []string{"10.0.0.1"},
})

Use this only for proxies you control. If TrustedProxies does not trust the direct peer, Zinc ignores forwarded IP headers.

Extension points

Plug in application-specific behavior with:

• RequestBinder
• Validator
• Renderer
• JSONCodec
• ErrorHandler

Use these when you need custom serialization, validation, rendering, or error-envelope policies without replacing the rest of Zinc.

Example:

app := zinc.NewWithConfig(zinc.Config{
	Validator: validator,
	ErrorHandler: func(c *zinc.Context, err error) {
		_ = c.Status(zinc.StatusInternalServerError).JSON(zinc.Map{
			"error": err.Error(),
		})
	},
})

See also

• Config API for the field-level reference.
• Errors for custom error handlers.
• Binding for validators and request binders.