Ballmac UI home

Banner

A page-wide announcement with semantic tones, optional action, and controlled or local dismissal.

A new workspace view is readyYour team can switch to the updated layout at any time.

Installation

$ pnpm dlx shadcn@latest add @ballmac/banner

Usage

import { Banner } from "@/components/ballmac/banner"

The full example is in the Code tab above.

Examples

Everything is syncedAll changes are saved.
Review your connectionUpdates may take longer than usual.

API reference

PropTypeDefault
title*

Short headline that names the announcement.

string—
description

Supporting detail, kept concise for a page-wide banner.

React.ReactNode—
tone

Semantic tone of the announcement.

"info" | "success" | "warning""info"
action

Optional link or button placed after the message.

React.ReactNode—
dismissible

Show a dismiss button.

booleanfalse
visible

Controlled visibility.

boolean—
defaultVisible

Initial visibility when uncontrolled.

booleantrue
onVisibleChange

Called when visibility changes.

(visible: boolean) => void—

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
Tab / EnterFocus and activate the action or dismiss control

Use with AI

A page-wide announcement with semantic tones, optional action, and controlled or local dismissal. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Banner (@ballmac/banner) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Announce a page-level update
  • Keep a persistent notice above page content

Not for

  • Use alert for content scoped to one panel

Registry JSON: https://ui.ballmac.com/r/banner.json

Credits

Free to use in personal and commercial projects.