NewmacOS 27 components and blocks

macOS, built with shadcn/ui.

Native-looking controls, menus, windows and sidebars for the web, matched to macOS 27. Copy them into your project with the shadcn CLI and make them yours.

$npx shadcn@latest add @cupertinoui/button
Favorites
iCloud
Macintosh HD
245,1 GB of 994,7 GB used
Applications48,2 GB
Documents86,9 GB
Photos41,7 GB
macOS18,3 GB
Battery LevelLast 24 hours
Last charged
Today, 07:12
Screen on
4 h 12 min
Wi‑Fi
Known Network
Harbor LightsThe Coastline Club
1:24-2:34
New Event
Added to your Work calendar.
Alert
Display
Built-in Liquid Retina XDR
True Tone
Night Shift
macOS 27.1Downloading… 2,1 of 6,4 GB
x
About 8 minutes left
AirDrop
Share with people nearby.
Discoverable by
MA
Mia AppleseediMessage
Are we still on for the design review?
Yes! 10:00 in the big room.
Great, I’ll bring the Dock mockups.
Delivered
Move “Roadmap.key” to the Trash?

You can’t undo this action.

Notifications
How Calendar alerts you.
Allow notifications
Badge app icon
Play sound
CPU LoadActivity Monitor
44 %
Focus
components
77
blocks
17
appearances
2
accent colors
8

Matched to macOS 27

Colors, text styles and control sizes are what macOS 27 itself reports, and the window chrome was measured from real screenshots.

Liquid Glass

Toolbar capsules, full-height sidebars, glass menus and popovers, and the inactive window look.

Light, dark and accents

Both appearances and every macOS accent color, driven by CSS variables in a single file.

shadcn/ui compatible

Same component names and props. Stock shadcn components pick up the macOS tokens too.

Blocks

Complete windows you can drop into a page. Sign In, Preferences and Reminders are free. Finder, Mail and the other app windows come with Pro.

A shadcn registry

Install with the shadcn CLI. You own the code: every component is copied into your project.

Feels like a Mac. Because it works like one.

Not just the look: the details people expect from macOS. Everything below is live, so go ahead and try it.

Windows that behave

Minimize into the Dock with the Genie effect, zoom with the green button, drag and resize.

Wi-Fi

Your accent color

Pick one: every control on this site follows it.

The Dock

Magnification, running dots, badges and labels.

Liquid Glass toolbars

Button groups that also work like radio buttons.

Finder, from JSON

Drag to select, drag onto a folder to move, right-click to rename, duplicate or tag, double-click to open.

A whole desktop, in a web page.

Finder, System Settings, Mail, Notes, Safari and Calendar, built only from CupertinoUI. Drag the windows, resize them, minimize them into the Dock or open apps from it.

Open the full desktop

77 components

Every control you know from a Mac, with keyboard support and accessibility from Base UI.

All components
Button
Tabs
Pop-up Button
Checkbox & Radio
Slider

Up and running in three steps.

The shadcn CLI does the work. See the installation guide for the details.

  1. 1

    Add the registry

    Point the namespace at CupertinoUI in components.json.

    "@cupertinoui": "https://cupertino-ui.com/r/{name}.json"
  2. 2

    Install the theme

    Colors, materials, text styles and radii, in one CSS file.

    npx shadcn@latest add @cupertinoui/macos-theme
  3. 3

    Add components

    Pick what you need; each one brings its dependencies along.

    npx shadcn@latest add @cupertinoui/window @cupertinoui/dock

Questions

Does it work with my shadcn/ui project?

Yes. CupertinoUI is a shadcn registry: the same CLI installs it, components keep the shadcn names and props, and the theme maps the shadcn tokens to macOS values, so stock components fit in too.

Is it free?

Yes. Every component, the theme and the smaller blocks are MIT licensed. CupertinoUI Pro adds Pro components and the macOS app blocks, such as Finder, Notes and Safari, monthly, yearly or with a one-time Lifetime license.

Do I own the code?

Like shadcn/ui, every component is copied into your project. Change anything; there is no package to upgrade or work around.

What does it need?

React 19 and Tailwind CSS v4. Next.js works out of the box, and any setup the shadcn CLI supports will do.

Light, dark and accent colors?

Both appearances and all eight macOS accent colors, from CSS variables in a single theme file. Windows also have the inactive look, with grey traffic lights and accents.

Is it accessible?

Menus, dialogs, selects, sliders and the other interactive parts are built on Base UI, with keyboard navigation and screen reader support.

Is CupertinoUI made by Apple?

No. CupertinoUI is an independent project and isn’t affiliated with or endorsed by Apple. macOS is a trademark of Apple Inc.

Start building for the Mac on the web.

Add the registry, install the theme and pick your components.