GPUIX-UI

A minimal UI kit and CLI component registry for @gpuix/react and Bun with hardware-accelerated transitions and native system integrations.

Why it exists

• Built for GPUIx: Designed specifically around native GPU layout rules, avoiding HTML/DOM assumptions.
• Hardware-Accelerated Transitions: Tab navigation with sliding active pills and screen transitions (slide, fade) driven directly by GPU layout properties (left, top, opacity).
• Zero Native Addons for OS Dialogs: File and folder pickers rely on platform CLI bridges (osascript on macOS, PowerShell WinForms on Windows, zenity on Linux).
• Tree-Shaken Icons: Over 1,500 Lucide icons compiled into static GPUI primitives with zero runtime SVG parsing.
• Copy-Paste Architecture: Components live directly in your source tree under ui/, giving you full control to inspect, customize, and edit every line.

Available Components

• Layout: Flex, Row, Column, ScreenContainer, Header
• Navigation & Routing: Views, View, ViewTrigger, NavigationRoot, SegmentedNav, TabsList, TabTrigger, TabsContent
• Forms & Controls: Button, Badge, Input, Textarea, Checkbox, Switch
• Containers & Panels: Card (with subcomponents), ScrollArea, Separator, Skeleton
• Overlays & Dialogs: Popover, PopoverItem, ToastProvider (useToast), FilePickerTrigger (useFileDialog)
• Icons: Static JSX components from @/icon with direct sizing and coloring support

CLI Reference

Initialize configuration and base setup:

bunx gpuix-ui init [--no-paths]

Add components to ui/:

# Add specific component
bunx gpuix-ui add <element>

# Add multiple components
bunx gpuix-ui add view navigation button

# Add all components
bunx gpuix-ui add --all

# Force overwrite existing files
bunx gpuix-ui add <element> -o
bunx gpuix-ui add --all -o

Remove installed component and clean up barrel exports:

bunx gpuix-ui remove <element>

Documentation

Full component specifications and props reference are available in WIKI.md or on the GitHub Wiki.

License

All project code is available under the MIT License.