Skip to main content

Workflow Node

Work in Progress

Base node component for workflows with handles, status indicators, icons, and badges. Automatically adjusts handle positions for RTL.

Note: This component is currently under development. Some features may not work as expected. We're actively working on improvements and will update the documentation once stable.

Preview

Installation

Terminalbash

Usage

Reacttsx

Examples

Different Node Types

tsx

With Status Indicators

tsx

With Custom Content

tsx

Props

Note: These props are passed via the data property of each node object in the WorkflowCanvas.

NameTypeDefaultDescription
label
Required
stringNode label/title
labelAr
stringNode label in Arabic (for RTL)
description
stringNode description text
descriptionAr
stringNode description in Arabic (for RTL)
type
stringNode type/category (shown as badge)
typeAr
stringNode type in Arabic (for RTL)
icon
LucideIconIcon component to display
status
'active' | 'inactive' | 'error' | 'success'Badge status indicator color
isRTL
booleanfalseWhether text direction is RTL
children
React.ReactNodeCustom content to render inside the node

Accessibility

Keyboard Navigation

  • Tab: Focus the node
  • Arrow Keys: Move the selected node
  • Delete: Delete the selected node

Screen Reader

Each node is announced with its label, description, and type. Status indicators are included in the accessible name when present.

Visual Feedback

  • Selected nodes show a focus ring
  • Status indicators use distinct colors (blue, green, red, gray)
  • Error and success states have colored borders

RTL Considerations

Workflow nodes automatically adjust handle positions for RTL layouts. Input handles appear on the right, output handles on the left. Set isRTL in node data and use Arabic label/description variants.

LTR (English)

RTL (العربية)

Related Components

Workflow Canvas

Canvas container for workflow nodes

Card

Base container component

Badge

Status and type indicators