# maccn

> A collection of beautifully designed, accessible, and customizable macOS UI components. Built on GPUI. Copy-paste ready. Use this index to discover the available documentation pages and markdown mirrors before browsing.

## Docs

- Overview
  - [Installation](https://maccn.vercel.app/docs.md): Add maccn to your GPUI project.
  - [Getting Started](https://maccn.vercel.app/docs/getting-started.md): Learn how to set up and use maccn in your GPUI project.
  - [Theme](https://maccn.vercel.app/docs/theme.md): Use MaccnTheme to drive light, dark, and accent colors.
  - [Assets](https://maccn.vercel.app/docs/assets.md): Learn how maccn handles icons and other assets.
  - Changelog
    - [Changelog](https://maccn.vercel.app/docs/changelog.md): Latest updates and announcements for maccn.
    - [August 2026 - Initial Release](https://maccn.vercel.app/docs/changelog/2026-08-15-initial-release.md)
- Components
  - [Components](https://maccn.vercel.app/docs/components.md): Here you can find all the macOS UI components available in the library.
  - GPUI
    - [Button](https://maccn.vercel.app/docs/components/gpui/button.md): A macOS push button with bordered, prominent, and destructive variants.
    - [Checkbox](https://maccn.vercel.app/docs/components/gpui/checkbox.md): A macOS checkbox with checked, unchecked, and indeterminate states.
    - [Radio Group](https://maccn.vercel.app/docs/components/gpui/radio-group.md): A group of mutually exclusive radio buttons.
    - [Switch](https://maccn.vercel.app/docs/components/gpui/switch.md): A macOS toggle switch with smooth animation.
    - [Segmented Control](https://maccn.vercel.app/docs/components/gpui/segmented-control.md): A segmented control for switching between views.
    - [Pop-Up Button](https://maccn.vercel.app/docs/components/gpui/pop-up-button.md): A dropdown button that opens a menu of selectable items.
    - [Progress](https://maccn.vercel.app/docs/components/gpui/progress.md): A horizontal progress bar with determinate and indeterminate modes.
    - [Spinner](https://maccn.vercel.app/docs/components/gpui/spinner.md): An animated loading indicator with spinning blades.
    - [Slider](https://maccn.vercel.app/docs/components/gpui/slider.md): A draggable slider for selecting a value in a range.
    - [Stepper](https://maccn.vercel.app/docs/components/gpui/stepper.md): An increment/decrement control with up and down chevrons.
    - [Label](https://maccn.vercel.app/docs/components/gpui/label.md): A text label with macOS typography styles.
    - [Badge](https://maccn.vercel.app/docs/components/gpui/badge.md): A macOS sidebar count badge.
    - [Box](https://maccn.vercel.app/docs/components/gpui/box.md): A grouped settings container with rounded corners and padding.
    - [Separator](https://maccn.vercel.app/docs/components/gpui/separator.md): A horizontal or vertical dividing line.
    - [Glass Panel](https://maccn.vercel.app/docs/components/gpui/glass-panel.md): A translucent panel with blur and vibrancy effects.
    - [Help Button](https://maccn.vercel.app/docs/components/gpui/help-button.md): A circular help button with a question mark glyph.
    - [Text Field](https://maccn.vercel.app/docs/components/gpui/text-field.md): A text input with placeholder, prefix, and suffix support.
    - [Secure Field](https://maccn.vercel.app/docs/components/gpui/secure-field.md): A masked password input field.
    - [Search Field](https://maccn.vercel.app/docs/components/gpui/search-field.md): A search input with magnifier icon and clear button.

## Machine-readable Resources

- [Full documentation](https://maccn.vercel.app/llms-full.txt)
- [Homepage markdown](https://maccn.vercel.app/llms.md/content.md)
- [OpenAPI description](https://maccn.vercel.app/openapi.json)
- [API catalog](https://maccn.vercel.app/.well-known/api-catalog)
- [Agent skill](https://maccn.vercel.app/.well-known/agent-skills/site-skill.md)