Error Pages

Render family-aware, CSP-safe error pages from any handler — go-error-family integration, the FromError pipeline, JSON responses, and the demo routes.

The errorpage package turns a classified error into a finished page: a neutral card with a family-colored accent bar, an HTTP nnn chip row, the suggested fix, context, the cause chain, and a trace footer. It integrates with go-error-family and promotes samber/oops user-safe messages and trace IDs through the bridge.

Quick start

Wrap any handler with ErrorHandler — it derives everything from the error and writes the real HTTP status:

import (
    "github.com/larsartmann/templ-components/errorpage"
)

mux.Handle("GET /dashboard", errorpage.ErrorHandler(
    err,
    errorpage.ErrorHandlerConfig{Nonce: cspNonce()},
))

Prefer full control? Build the props yourself and render inside your own layout shell (the demo uses exactly this pattern for its standalone /errors/* routes):

props := errorpage.FromError(err) // family, title, code, why/fix, trace, status
props.ShowTimestamp = true
@errorpage.ErrorPage(props)

Families

Every error resolves to one of six families, which drives the color, icon, default title, and HTTP status:

FromError prefers the error's own ErrorTitle(); when absent it falls back to the family default, so a page never renders headingless.

JSON mode

API consumers get the same facts the page shows — set JSON: true:

errorpage.ErrorHandler(err, errorpage.ErrorHandlerConfig{
    JSON: true, // application/json error body
})

The body carries family, code, message, title, why, fix, trace, and context; untraced errors omit the trace key entirely.

Components

• ErrorPage — full-page display (<main> landmark, action pair, width enum, copy-to-clipboard code chip).
• NotFound404 — dedicated 404 with hero numeral, search, and quick links.
• ErrorDetail — inline card for dashboards and panels (Variant: Tinted or Neutral).
• ErrorAlert — family-aware banner.

All render family-safe colors in both themes and honor prefers-reduced-motion. See the API reference for the complete props model.