skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
aprilnea/gpui-skills52 installs

gpui-component

gpui-component library patterns for building reusable UI components. Use when creating buttons, inputs, dialogs, forms, or following Longbridge component library conventions in GPUI applications.

How do I install this agent skill?

npx skills add https://github.com/aprilnea/gpui-skills --skill gpui-component
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides documentation and code patterns for developing UI components using the GPUI framework and the gpui-component library. It contains Rust code templates for various UI elements like buttons, forms, and dialogs. No malicious behaviors were detected.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

  • Runlayerpass

    15 files scanned · No issues

What does this agent skill do?

gpui-component Best Practices

Comprehensive guide for building UI components with gpui-component, a component library for GPUI applications.

When to Apply

Reference these guidelines when:

  • Creating reusable UI components
  • Implementing theme-aware styling
  • Building dialogs, popovers, or sheets
  • Creating form components (Input, Checkbox, etc.)
  • Implementing component animations
  • Following Longbridge component patterns

Rule Categories by Priority

PriorityCategoryImpactPrefix
1Component ArchitectureCRITICALcomp-
2Trait SystemCRITICALtrait-
3Theme SystemHIGHtheme-
4Dialog & PopoverHIGHdialog-
5Form ComponentsMEDIUMform-
6AnimationMEDIUManim-

Quick Reference

1. Component Architecture (CRITICAL)

  • comp-renderonce - Use RenderOnce with #[derive(IntoElement)]
  • comp-structure - Standard component structure template
  • comp-builder - Fluent builder pattern for components
  • comp-stateful - Entity + RenderOnce for stateful components
  • comp-callbacks - Use Rc<dyn Fn> for event callbacks

2. Trait System (CRITICAL)

  • trait-styled - Implement Styled for style customization
  • trait-disableable - Implement Disableable for disabled state
  • trait-selectable - Implement Selectable for selection state
  • trait-sizable - Implement Sizable with Size enum
  • trait-parent-element - Implement ParentElement for children
  • trait-interactive - Implement InteractiveElement for events

3. Theme System (HIGH)

  • theme-colors - Use ThemeColor for consistent colors
  • theme-active - Use ActiveTheme trait for theme access
  • theme-variants - Implement variant enums (ButtonVariant, etc.)
  • theme-size-system - Use StyleSized for size-based styling

4. Dialog & Popover (HIGH)

  • dialog-root - Use Root component as window root
  • dialog-window-ext - Use WindowExt for dialog management
  • dialog-confirm - Implement confirm/alert dialogs
  • dialog-form - Build form dialogs with input state
  • popover-pattern - Popover vs PopupMenu vs Sheet selection

5. Form Components (MEDIUM)

  • form-input-state - Entity-based input state management
  • form-focus - Focus management with keyed state
  • form-validation - Input validation patterns

6. Animation (MEDIUM)

  • anim-with-animation - Use with_animation for transitions
  • anim-keyed-state - Persist animation state with use_keyed_state
  • anim-easing - Use cubic_bezier for smooth animations

Component Structure Template

#[derive(IntoElement)]
pub struct MyComponent {
    // 1. Identifier
    id: ElementId,

    // 2. Base element (for event delegation)
    base: Div,

    // 3. Style override
    style: StyleRefinement,

    // 4. Content
    label: Option<SharedString>,
    children: Vec<AnyElement>,

    // 5. State configuration
    disabled: bool,
    selected: bool,
    size: Size,

    // 6. Callbacks
    on_click: Option<Rc<dyn Fn(&ClickEvent, &mut Window, &mut App)>>,
}

Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│  Window                                                      │
│  ├── Root (Entity, manages overlay state)                   │
│  │   ├── view: AnyView (user's main view)                   │
│  │   ├── active_dialogs: Vec<ActiveDialog>                  │
│  │   ├── active_sheet: Option<ActiveSheet>                  │
│  │   └── notification: Entity<NotificationList>             │
│  │                                                          │
│  └── Render Layers                                          │
│      ├── Layer 0: Root.view (main content)                  │
│      ├── Layer 1: Sheet (side drawer)                       │
│      ├── Layer 2: Dialogs (stackable)                       │
│      └── Layer 3: Notifications                             │
└─────────────────────────────────────────────────────────────┘

Popup Component Comparison

FeatureDialogPopoverPopupMenuSheet
PositionCenteredAnchoredAnchoredSide
OverlayYesNoNoYes
StateRootkeyed_stateEntityRoot
StackingMultipleSingleSubmenusSingle
CloseESC/Click/ButtonESC/OutsideESC/SelectESC/Overlay

How to Use

Read individual rule files for detailed explanations and code examples:

rules/comp-renderonce.md
rules/trait-styled.md
rules/dialog-root.md

Each rule file contains:

  • Brief explanation of why it matters
  • Code examples with correct patterns
  • Common mistakes to avoid

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/aprilnea/gpui-skills/gpui-component">View gpui-component on skillZs</a>