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.