agentsclimarketplace

Plex ui

Skill plex-ui/ui/skills/plexui/skills/plex-ui

Manages Plex UI components and projects — installing, composing, styling, and debugging UI. Provides component APIs, design token conventions, and usage patterns. Applies when working with @plexui/ui, Plex UI components, or any project importing from @plexui/ui. Also triggers for Plex UI setup, theming, dark mode, responsive design, or icon usage.From its SKILL.md

Install
npx -y skills add plex-ui/ui --skill plex-ui

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

10.7 KB, as published. Nobody here has run it

Plex UI

A production-grade React component library with 35+ components, 14 hooks, a three-layer design token system, and a unified 9-step size scale — powered by Radix primitives and Tailwind CSS 4.

IMPORTANT: All components are imported from @plexui/ui/components/<Name>. Hooks from @plexui/ui/hooks/<name>. Never import from the package root.

Installation & Setup

npm install @plexui/ui

Global stylesheet (e.g. main.css or globals.css):

@import "tailwindcss";
@import "@plexui/ui/css";
@source "../node_modules/@plexui/ui";

Import the stylesheet before rendering (e.g. main.tsx or layout.tsx):

import "./main.css";

Wrap your app in PlexUIProvider:

import { PlexUIProvider } from "@plexui/ui/components/PlexUIProvider";

export default function Layout({ children }: { children: React.ReactNode }) {
  return (
    <PlexUIProvider linkComponent="a">
      {children}
    </PlexUIProvider>
  );
}

Next.js: Pass linkComponent={Link} from next/link for client-side routing.

Principles

  1. Use existing components first. Check the component list below before writing custom markup.
  2. Use the unified size scale. All controls share the same size prop with 9 steps — use it consistently.
  3. Use semantic colors. color="primary", text-primary, bg-surface — never raw Tailwind colors like bg-blue-500.
  4. Use CSS variable tokens. The three-layer token system handles light/dark automatically via light-dark().
  5. Compose, don't reinvent. Dashboard = Sidebar + Menu + Tabs + components. Form = Field + Input + Select + Button.

Critical Rules

These rules are always enforced. Each links to a detailed reference file.

Imports & Structure -> components.md

  • Always import from subpaths. import { Button } from "@plexui/ui/components/Button" — never from root.
  • Wrap app in PlexUIProvider. Required for link routing and shared context.
  • Use "use client" when needed. Components with state, effects, or event handlers need the directive in Next.js App Router.

Styling & Tokens -> styling.md

  • Use semantic color props. color="primary", color="danger" — not Tailwind color classes.
  • Use the variant prop. variant="solid", "soft", "outline", "ghost", "surface".
  • Use the size prop. 9-step scale from 3xs to 3xl. Default is md.
  • Dark mode is automatic. Uses CSS light-dark(). Set color-scheme: dark on :root — no dark: prefix needed.
  • Use Plex UI utility classes. text-primary, text-secondary, bg-surface, border-default — not raw colors.

Icons -> icons.md

  • Import icons from @plexui/ui/components/Icon. Named exports like IconSearch, IconCheck, etc.
  • Icons auto-size inside components. No manual w-4 h-4 needed — components handle icon sizing via the size prop.
  • Use iconSize prop to override. When the default icon size doesn't fit, use iconSize="sm" etc.

Component Reference

All components use subpath imports: import { X } from "@plexui/ui/components/X"

Controls (unified size scale)

ComponentKey PropsDescription
Buttoncolor, variant, size, pill, block, disabledPrimary action element
ButtonLinkSame as Button + hrefButton that renders as a link
Inputsize, placeholder, disabled, invalidText input field
Textareasize, autoGrow, minRows, maxRowsMulti-line text input
FloatingLabelInputlabel, sizeInput with animated floating label
Selectsize, placeholder, value, onChangeDropdown select
SelectControlsize, value, optionsSimplified select with options array
Checkboxsize, checked, onChange, indeterminateCheckbox control
RadioGroupsize, value, onChangeRadio button group
Switchsize, checked, onChangeToggle switch
SegmentedControlsize, value, onChange, optionsTab-like option selector
Slidersize, min, max, value, onChangeRange slider
TagInputsize, value, onChangeMulti-value tag input
OTPInputsize, length, value, onChangeOne-time password input
DatePickersize, value, onChangeDate selection
DateRangePickersize, startDate, endDate, onChangeDate range selection

Display

ComponentKey PropsDescription
Badgecolor, variant, sizeStatus indicator label
Avatarsrc, name, sizeUser avatar with fallback
AvatarGroupmax, sizeStacked avatar group
Indicator—Loading indicators (LoadingIndicator, LoadingDots, CircularProgress)
Skeletonwidth, height, circleLoading placeholder
EmptyMessagetitle, description, iconEmpty state component
StatCardtitle, value, trendStatistics display card
ShimmerTextchildrenAnimated shimmer text effect

Navigation & Layout

ComponentKey PropsDescription
Sidebarvariant, collapsible, sideApp sidebar with multiple collapse modes
MenusizeDropdown/context menu system
Tabsvalue, onChangeTab navigation
ProgressStepssteps, currentStep progress indicator
TextLinkhref, colorStyled text hyperlink

Overlay & Feedback

ComponentKey PropsDescription
Dialogopen, onOpenChangeModal dialog
Popoveropen, onOpenChangeFloating popover
TooltipcontentHover tooltip
Alertcolor, variant, titleInline alert message

Content

ComponentKey PropsDescription
MarkdownchildrenRender markdown content
CodeBlocklanguage, codeSyntax-highlighted code
CopyTooltiptextCopy-to-clipboard with tooltip
IconNamed exports460+ icons
Imagesrc, altOptimized image component

Form Helpers

ComponentKey PropsDescription
FieldchildrenForm field wrapper
FieldErrormessageValidation error display

Animation

ComponentKey PropsDescription
Animateshow, typeEnter/exit transitions
AnimateLayoutchildrenLayout animation wrapper
AnimateLayoutGroupchildrenGrouped layout animations
TransitionGroupchildrenList transition management

Hooks

All hooks: import { useX } from "@plexui/ui/hooks/useX"

HookPurpose
useBreakpointsResponsive breakpoint detection
useScrollableScroll state and overflow detection
useAutoGrowTextareaAuto-growing textarea height
useDocumentVisibleDocument visibility state
useEscCloseStackStacked ESC-to-close behavior
useIsMountedComponent mount state
useLatestValueLatest ref value without re-renders
usePreviousPrevious render value
useSimulatedProgressFake progress bar animation
useStableCallbackStable callback reference
useTextSelectionText selection state
useTrailingValueDelayed value updates
useAnimatedScrollToSmooth scroll animation
useCharactersPerSecondTyping speed measurement

Size Scale

All key controls share a unified height scale via the size prop:

SizeHeightUse case
3xs22pxUltra-compact UI, dense tables
2xs24pxCompact toolbars
xs26pxSmall controls
sm28pxCompact forms
md32pxDefault — most UI
lg36pxProminent actions
xl40pxHero sections
2xl44pxLarge touch targets
3xl48pxMarketing CTAs

Color System

Semantic colors (for color prop)

primary, secondary, danger, success, warning, caution, discovery, info

Tailwind utility classes (from Plex UI tokens)

text-primary, text-secondary, text-tertiary, text-disabled
bg-surface, bg-surface-secondary, bg-surface-tertiary
border-default, border-subtle

Dark Mode

Plex UI uses CSS light-dark() — no dark: prefixes needed.

:root { color-scheme: light; }       /* light theme */
:root { color-scheme: dark; }        /* dark theme */
:root { color-scheme: light dark; }  /* follows OS preference */

Key Patterns

// Correct: subpath imports
import { Button } from "@plexui/ui/components/Button";
import { Input } from "@plexui/ui/components/Input";
import { IconSearch } from "@plexui/ui/components/Icon";

// Correct: semantic color + variant
<Button color="primary" variant="solid" size="md">Save</Button>
<Button color="danger" variant="ghost" size="sm">Delete</Button>

// Correct: icon inside button (auto-sized)
<Button color="primary">
  <IconSearch />
  Search
</Button>

// Correct: consistent size across form
<Input size="lg" placeholder="Email" />
<Select size="lg" placeholder="Role" />
<Button size="lg" color="primary">Submit</Button>

// Correct: dark mode via color-scheme
<html style={{ colorScheme: isDark ? "dark" : "light" }}>

// Wrong: raw Tailwind colors
<Button className="bg-blue-500 text-white">Save</Button>  // WRONG
// Wrong: root import
import { Button } from "@plexui/ui";  // WRONG
// Wrong: manual icon sizing inside components
<Button><IconSearch className="w-4 h-4" />Search</Button>  // WRONG

Detailed References

Full Documentation

Keep looking

Skills are one crate of 609,689. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.