OpenParable
Skip to content
← Back to skills

Gp UI

Design
gp-ui

Gp UI is an Agent Skill for design published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when building React UIs for TheGP applications, migrating existing UIs to @gp/ui components, integrating Tailwind v4 with @gp/ui theme, or answering questions about available components, design tokens, icons, or setup. Activate when user mentions @gp/ui, TheGP design system, or asks about GP-specific UI patterns and components.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/gp-ui/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gp-ui, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

@gp/ui Design System

TheGP's shared React component library with Tailwind theme integration.

Quick Reference

Import: import { Button, Card, Layout } from '@gp/ui' Theme: @import "@gp/ui/theme"; in CSS Icons: import { SearchIcon, UserIcon } from '@gp/ui'

Available Components

ComponentPurpose
ButtonPrimary actions with variants: primary, secondary, ghost, destructive
BadgeStatus indicators: success, warning, error, info, neutral
CardContainer with Card.Header, Card.Body, Card.Footer
StatCardMetric display with optional trend indicator
StatGridKey-value grid with formatting and copy support
AlertNotifications: info, warning, error, success
InputText input with label, icons, validation states
TextAreaMulti-line input with auto-resize
ModalDialog overlays (Radix-based) with sizes, controlled/uncontrolled state
DropdownMenu system (Radix-based) with items, checkboxes, submenus
TooltipHover hints (Radix-based)
TabBarHorizontal tab navigation
LayoutApp shell with header, sidebar, user menu
SidebarCollapsible navigation with responsive behavior
SkeletonLoading placeholders
LoginPageFull-screen login with branding
GPLogoTheGP logo SVG

Resources

Load these as needed:

Key Patterns

Class Merging

Always use cn() for combining classes:

import { cn } from '@gp/ui'
<div className={cn('base-class', condition && 'conditional-class', className)} />

Compound Components

Card, Dropdown, Tooltip use dot notation:

<Card>
  <Card.Header>Title</Card.Header>
  <Card.Body>Content</Card.Body>
</Card>

Semantic Icons

Icons named by purpose, not appearance:

import { BackIcon, SpinnerIcon, DeleteIcon } from '@gp/ui'

Theme Tokens

Custom Tailwind colors available after importing theme:

  • orange-50 to orange-900 (brand orange)
  • navy-50 to navy-950 (dark navy)
  • cream (off-white background)

Peer Dependencies

Apps must install: react, react-dom, lucide-react, @radix-ui/react-dialog, @radix-ui/react-dropdown-menu, @radix-ui/react-tooltip, @radix-ui/react-label