Ballmac UI home

Desktop 1: preferences window

The Settings window of a Tauri or Electron app: toolbar tabs on macOS, a side nav with setting cards on Windows. Launch at login, menu bar, appearance, a global shortcut recorder and update settings that apply as they change.

Open in v0 (opens in a new tab)

Installation

The default, and what a Radix-style project installs.

$ pnpm dlx shadcn@latest add @ballmac/desktop-1

Usage

Example: desktop-1-demo.tsx
import { Desktop1 } from "@/components/ballmac/blocks/desktop-1/desktop-1"

export default function Desktop1Demo() {
  return <Desktop1 feel="macos" appName="Acme" />
}

States

This block has no states. Settings apply the moment they change, as desktop apps do: nothing to load, submit or fail.

Quality scorecard

7/7

Every applicable check passes

Measured in Chromium 153.0.8010.12 on October 19, 2026, on version 1.0.1, across 3 examples.

How we measure
  • Passed: Accessibility scan

    No serious or critical issues in light and dark, on a phone and a desktop (axe-core 4.13.0, WCAG 2.1 AA and best-practice rules).

  • Passed: Small screens

    No sideways scrolling at 360, 390 or 1280 px wide.

  • Passed: Reduced motion

    No endless animation to begin with.

  • Passed: Right to left

    Mirrors correctly in Arabic, Hebrew, Persian and Urdu layouts (4% of elements off the mirror, limit 15%).

  • Passed: Clean console

    No console errors or React hydration errors while loading.

  • Passed: Keyboard

    14 tab stops, each showing a visible change when it takes focus. 3 documented keys.

  • Not applicable: Loading, empty and error

    Settings apply the moment they change, as desktop apps do: nothing to load, submit or fail.

  • Passed: Automated tests

    Covered by desktop-1.test.tsx.

  • For information: Footprint

    4.9 KB of source (gzip) in 1 file. Installs lucide-react, radix-ui.

Automated checks find a subset of problems and do not replace testing with a screen reader and a keyboard in your own app. What they miss.

Dependencies

Use with AI

A complete preferences window. <Desktop1 appName defaultValues onValuesChange={(v) => persist(v)} onCheckForUpdates />. Panes: General, Appearance, Shortcuts (a key-combination recorder that writes ⇧⌘Space on a Mac and Ctrl+Shift+Space on Windows), Updates, Advanced, plus extraPanes. Layout follows the feel: toolbar tabs and a pane-named title on macOS, side nav and setting cards on Windows. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Desktop 1: preferences window (@ballmac/desktop-1) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • The Settings or Preferences window of a Tauri or Electron app
  • A desktop-style web app that needs app-level preferences

Not for

  • Account settings saved with a button (use settings-1)
  • A settings page inside a web app's layout (use settings-2 or settings-panel)

Registry JSON: https://ui.ballmac.com/r/desktop-1.json

Free to use in personal and commercial projects.

Ballmac UI Pro

Need the whole screen, not one piece?

150 premium blocks (dashboards, settings, calendars, mail, shops, onboarding), a private shadcn registry and Figma tokens. Blocks that show data come with loading, empty and error states built in.

Not ready? Try three Pro blocks free

Leave your email and the blocks appear right here, ready to copy. Yours to use in any project.