Skip to content

Install · two commands

Your screen,
in minutes.

PulseUI is a plain Swift Package with a shadcn-style CLI: two commands, nothing to copy-paste by hand, no generated code kept in your repo — unless you want the sources.

pulse init pulse add <component…> Swift 6 iOS 26+ · macOS 26+ · visionOS 26+ · Swift 6 MIT License

One-liner

curl -fsSL https://raw.githubusercontent.com/qtttyr/PulseUI/main/scripts/install.sh | bash

Builds the CLI on first run and drops it into ~/.local/bin (Mac & Linux). If needed, run export PATH="$HOME/.local/bin:$PATH" once in the current terminal.

Swift Package

git clone https://github.com/qtttyr/PulseUI.git
cd PulseUI && swift run pulse

No binaries at all — run straight from the source. Works anywhere Swift 6 is installed.

01

Install pulse

pulse is a tiny CLI that wires PulseUI into your Swift package.

curl -fsSL https://raw.githubusercontent.com/qtttyr/PulseUI/main/scripts/install.sh | bash
02

Set up the package

Works from Swift Package projects and regular Xcode App projects. It adds the dependency or attaches a PulseUIComponents source group, generates the theme, and writes AGENTS.md for humans and coding agents.

pulse init --accent '#B51A00' --radius 10
03

Add components

One command, working code. Each component lands with a usage card. Add more anytime: pulse add otp slider avatar.

pulse add button toast alert

PulseButton("Continue", variant: .primary, size: .lg) {
    await submit()
}
04

Bring your own theme

Open the studio to generate your brand palette to Swift code, or hand-write it. Change one token — the whole app re-skins.

PulseTheme(
    colors: ColorTokens(
        accent: Color(light: 0x9ACA00, dark: 0xD9FE3E)
    ),
    radius: RadiusTokens(md: 10, lg: 14, xl: 18)
)
05

Leave cleanly

pulse remove leaves project components untouched. To remove the CLI itself, use pulse uninstall or brew uninstall pulse when installed through Homebrew.

pulse remove --yes

# if installed with Homebrew:
brew uninstall pulse

Next steps