RetailysUI

General Components

Buttons, badges, avatars, icons, tooltips, dropdowns, and tags — the foundational building blocks of every interface.

Buttons

Versatile button components covering primary actions, destructive operations, social logins, app store links, and grouped selections.

Primary Variants

Color Variants

With Icons

Icon Only

States

Utility Buttons

Close Button

Social Buttons

App Store Buttons

Button Group

PropTypeDefaultDescription
size"sm" | "md" | "lg" | "xl""sm"Button size
color"primary" | "secondary" | "tertiary" | "link-gray" | "link-color" | "primary-destructive" | "secondary-destructive" | "tertiary-destructive" | "link-destructive""primary"Button color variant
iconLeadingFC | ReactNode-Icon before text
iconTrailingFC | ReactNode-Icon after text
isLoadingbooleanfalseShow loading spinner
showTextWhileLoadingbooleanfalseKeep text visible during loading
isDisabledbooleanfalseDisable the button
noTextPaddingbooleanfalseRemove text padding for icon-only buttons

Badges

Status indicators, labels, and categorization tokens available in multiple colors, sizes, and styles.

Colors

GrayBrandErrorWarningSuccessGray BlueBlue LightBlueIndigoPurplePinkOrange

Sizes

SmallMediumLarge

Types

Pill ColorColorModern

Variants

ActiveFeaturedRemovable

Badge Group

New featureCheck out our latest update
PropTypeDefaultDescription
type"pill-color" | "color" | "modern""pill-color"Badge visual style
size"sm" | "md" | "lg""md"Badge size
colorBadgeColors"gray"Badge color — 12 options: gray, brand, error, warning, success, gray-blue, blue-light, blue, indigo, purple, pink, orange

Avatars

User and entity representations with images, initials, status indicators, and verification badges.

Sizes

Avatar
Avatar
Avatar
Avatar
Avatar
Avatar
Avatar

Initials

JD
AB
CD

Status

Online
Offline

Verified

Verified
Verified

Placeholder

Avatar Label Group

John Doe

john@example.com

Jane Smith

Product Designer

Profile Photo

PropTypeDefaultDescription
size"xxs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl""md"Avatar size
srcstring | null-Image source URL
altstring-Image alt text
status"online" | "offline"-Online status indicator
verifiedbooleanfalseShow verified badge
initialsstring-Fallback initials when no image
placeholderIconFC-Custom placeholder icon component
contrastBorderbooleanfalseShow a contrast border around the avatar
focusablebooleanfalseShow focus ring when parent group is focused

Tooltips

Contextual information overlays triggered on hover or focus, with configurable placement and optional descriptions.

Basic

Placements

With Arrow

PropTypeDefaultDescription
title*ReactNode-Primary tooltip text
descriptionReactNode-Secondary descriptive text
placement"top" | "bottom" | "left" | "right" | ..."top"Tooltip position relative to trigger
arrowbooleanfalseShow directional arrow on tooltip
delaynumber300Delay in ms before showing
closeDelaynumber0Delay in ms before hiding
offsetnumber6Distance from trigger in px
isDisabledbooleanfalsePrevent tooltip from appearing

Tags

Interactive tokens for categorization and filtering, supporting selection, removal, and grouping.

Basic

Design
Development
Marketing

Removable

Design
Development
Marketing

With Dot

Active
Warning
Error

Sizes

Small
Tags
Medium
Tags
Large
Tags

Selectable

React
Vue
Angular
Svelte

TagGroup Props

PropTypeDefaultDescription
label*string-Accessible label for the tag group
size"sm" | "md" | "lg""sm"Size of all tags in the group
selectionMode"none" | "single" | "multiple""none"Selection behavior for tags

Tag Props

PropTypeDefaultDescription
id*string-Unique identifier for the tag
dotbooleanfalseShow a leading dot indicator
dotClassNamestring-Custom class for the dot color
onClose(id: string) => void-Callback when close button is clicked — shows close button
countnumber-Numeric count badge shown after label
avatarSrcstring-Leading avatar image source