@fiscozen/navbar

RFC: https://github.com/fiscozen/knowledge-base/pull/91

Navbar skeleton component meant for primary navigation.

Elevation (elevation)

FzNavbar casts an elevation shadow by default. Pass elevation="flat" for a navbar that sits on the page background rather than above it — the backoffice rail inside FzFrameTemplate is the case it exists for: with nothing behind the rail, a shadow draws a fake edge along a seamless surface.

<FzNavbar variant="vertical" elevation="flat" />

| Value | | | --- | --- | | raised (default) | the elevation shadow — unchanged from every version before the prop existed | | flat | no shadow |

Why a prop and not a class at the call site. The shadow is declared by this package's own .fz-navbar rule, which sits at the same specificity as a Tailwind utility — so whether a shadow-none added at the call site wins comes down to stylesheet order, not intent. The --fz-navbar-shadow custom property is not an answer either: setting it needs style, which consuming repos block under their compose-only styling policy exactly as they block class. Deciding it inside the component is the only way the capability exists for them at all. elevation also takes precedence over --fz-navbar-shadow, deliberately — an explicit API should beat a property set further up.

The other layout values (--fz-navbar-padding, --fz-navbar-height, --fz-navbar-bg, …) are still custom properties, with the same caveat: they are out of reach for a compose-only consumer. Promote one to a prop when a consumer actually needs it.