Ballmac UI home

Workspace Card

A workspace or team card with a generated cover and logo tile, plan, member faces, project and storage stats, a current badge, an actions menu and a loading state.

Acme Inc. Current

Product, design and engineering in one place.

AKMS8 more
Team
Projects
18
Storage
62 / 100 GB

Active 2 hours ago

Orbit Studio

Client work and experiments.

AKM
Free
Projects
4
Storage
9 / 10 GB

Active yesterday

Installation

$ pnpm dlx shadcn@latest add @ballmac/workspace-card

Usage

import { WorkspaceCard } from "@/components/ballmac/workspace-card"

The full example is in the Code tab above.

Examples

Loading and minimal

3 membersPro
Projects
2

API reference

PropTypeDefault
workspace

The workspace to show. Optional only while `loading`.

Workspace—
href

Where the card goes when opened. Makes the whole card clickable through its title.

string—
onOpen

Called when the title button is pressed (when no `href`).

() => void—
current

Mark as the workspace you are in now.

booleanfalse
actions

Entries for the "more" menu. Leave empty to hide the menu.

WorkspaceAction[][]
loading

Show a placeholder while data loads.

booleanfalse

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
TabOne link per card (the title); the actions menu is a separate button
Screen readersStorage is a labelled meter; loading state sets aria-busy

Use with AI

workspace {name,description,plan,members,memberCount,projects,storage,lastActive}, href or onOpen, current, actions[], loading. The title is the card's single link. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Workspace Card (@ballmac/workspace-card) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Workspace pickers and team lists
  • Account overview pages

Not for

  • A dropdown switcher; use team-switcher
  • Generic content cards; use card

Registry JSON: https://ui.ballmac.com/r/workspace-card.json

Credits

Free to use in personal and commercial projects.