Group

Group is Zinc’s route subtree type.

Create one with:

api := app.Group("/api", requireAPIKey)

What groups do

Groups let you:

• apply a common path prefix
• apply a shared middleware chain
• build nested APIs without repeating paths

Common methods

Method	Purpose
Use	Add group-local middleware
Group, Route	Create nested route trees
Get, Post, Put, Patch, Delete, Head, Options, Connect, Trace	Register routes under the group prefix
Add, Match, All, Any	Register more general route sets
Handle, TryHandle	Register a named source or runtime-defined route
HandleHTTP	Register a standard http.Handler using METHOD /pattern
RouteNotFound	Register a prefix-scoped not-found route
Mount, Static, StaticFS, File, FileFS	Mount handlers or serve files below the group prefix

Example

api := app.Group("/api", requireAPIKey)
v1 := api.Group("/v1")

v1.Get("/users/{id}", showUser)
v1.Post("/users", createUser)

v1.Handle(zinc.RouteSpec{
  Name:    "users.show",
  Method:  zinc.MethodGet,
  Path:    "/users/{id}",
  Handler: showUser,
})

Group route registration inherits the group prefix and middleware stack automatically. Use v1.TryHandle(spec) instead when the route declaration comes from runtime input and must return an error.

Standard handlers inherit them too:

v1.HandleHTTP("GET /metrics", promhttp.Handler())

Route-local middleware still works inside groups.

v1.Post("/posts", requireRole("editor"), createPost)