Precast UI CLI

A CLI tool for adding brutalist UI components to your React projects, similar to shadcn/ui but with registry URL support.

Installation

npm install -g precast-ui

Usage

Initialize your project

precast-ui init

This will:

• Create a precast-ui.config.json configuration file
• Set up the components directory structure
• Add necessary dependencies to your package.json

Add components

# Add local components
precast-ui add button
precast-ui add button card input

# Add components from registry URLs (like shadcn)
precast-ui add "https://magicui.design/r/marquee"
precast-ui add "https://ui.shadcn.com/registry/alert"

# Mix local and registry components
precast-ui add button "https://magicui.design/r/marquee" alert

# List available local components
precast-ui add

Options

• --yes, -y: Skip confirmation prompts
• --overwrite, -o: Overwrite existing files

Configuration

The precast-ui.config.json file contains your project configuration:

{
  "srcDir": "src",
  "componentsDir": "components",
  "cssFramework": "css-modules",
  "typescript": true
}

Registry URL Support

Precast UI supports installing components from any registry URL that returns a valid component definition. This works exactly like shadcn/ui:

# Install from any registry
precast-ui add "https://registry.example.com/components/my-component"

# Works with popular registries
precast-ui add "https://magicui.design/r/marquee"
precast-ui add "https://ui.shadcn.com/registry/alert"

Available Local Components

• button - Brutalist button component
• alert - Alert component for important messages
• badge - Small status indicator
• card - Container component
• input - Form input component

CSS Frameworks Supported

• CSS Modules (default)
• Tailwind CSS

Development

Building

bun run build

Testing

# Run simple functionality tests
node test-simple.js

# Test registry URL functionality
node test-registry-url.js

Deployment

# Deploy to npm
./deploy.sh

License

MIT