Skip to main content
Frosted UI es la biblioteca completa de componentes de React y el sistema de diseño de Whop. Ofrece más de 60 componentes que cumplen los estándares de accesibilidad. También incluye un sofisticado sistema de colores, una escala tipográfica y compatibilidad fluida con el modo oscuro, todo construido sobre primitivas de Radix UI y Tailwind CSS.

Instalación

1

Instala el paquete

El paquete @whop/react incluye Frosted UI y todas las dependencias necesarias.
2

Configura el provider WhopApp

Envuelve tu aplicación con el componente WhopApp en tu layout raíz. Esto configura el tema y el SDK del iframe.
3

Configura Next.js (opcional)

Usa el wrapper withWhopAppConfig en tu configuración de Next.js:
Esto configura las server actions y optimiza las importaciones de Frosted UI.
4

Configura Tailwind (opcional)

Si usas Tailwind CSS, añade el plugin de Frosted UI para acceder a los design tokens:
Frosted UI ya está configurado y listo para usar.

Tipografía

Frosted UI ofrece un sistema tipográfico completo con dos componentes principales: Heading y Text.

Escala tipográfica

Ambos componentes usan una escala de tamaños de 10 pasos (0-9):

Componente Text

Props:
  • size: de "0" a "9" (predeterminado: "3")
  • weight: "light" | "regular" | "medium" | "bold"
  • align: "left" | "center" | "right"
  • color: cualquier color de acento o "gray"
  • highContrast: aumenta el contraste para la accesibilidad
  • as: "span" | "div" | "p" | "label"

Componente Heading

Props:
  • size: de "0" a "9" (predeterminado: "6")
  • weight: "light" | "regular" | "medium" | "bold"
  • align: "left" | "center" | "right"
  • as: "h1" | "h2" | "h3" | "h4" | "h5" | "h6"
  • color: cualquier color de acento o "gray"
  • highContrast: aumenta el contraste para la accesibilidad

Otros componentes tipográficos


Colores

Frosted UI usa las escalas de color de Radix, que ofrecen paletas de 12 pasos con variantes sólidas y alfa.

Colores de acento

Hay 27 colores de acento disponibles: Colores regulares: tomato, red, ruby, crimson, pink, plum, purple, violet, iris, indigo, blue, cyan, teal, jade, green, grass, brown, orange Colores brillantes: sky, mint, lime, yellow, amber, lemon, magenta Colores metálicos: gold, bronze

Colores grises

6 escalas de grises con diferentes temperaturas de color:
  • gray - Gris neutro puro
  • mauve - Ligeramente teñido de morado
  • slate - Teñido de azul frío
  • sage - Sutilmente teñido de verde
  • olive - Teñido de oliva cálido
  • sand - Teñido de arena cálido
  • auto - Se ajusta automáticamente al color de acento

Colores semánticos

Colores preconfigurados para casos de uso comunes:
  • Peligro: red (predeterminado), tomato, ruby
  • Advertencia: amber (predeterminado), yellow
  • Éxito: green (predeterminado), teal, jade, grass
  • Información: sky (predeterminado), blue

Uso de los colores

Clases de color de Tailwind

Con el plugin de Tailwind, puedes usar directamente los colores de Frosted UI:
Escala de color:
  • Pasos 1-3: fondos y rellenos sutiles
  • Pasos 4-6: bordes y separadores
  • Pasos 7-9: elementos interactivos
  • Pasos 10-12: texto y elementos de alto contraste
Variantes alfa:
  • Usa de {color}-a1 a {color}-a12 para la transparencia
Con frostedUiPlugin() añadido a tu configuración de tailwind, los colores predeterminados de tailwind como bg-blue-200 no funcionan. Usa bg-blue-2 en su lugar, según la documentación anterior.

Modo oscuro

Frosted UI incluye compatibilidad automática con el modo oscuro que respeta las preferencias del sistema y las elecciones del usuario.

Cómo funciona

Gestiona el modo oscuro mediante tres modos de apariencia:
  • "inherit" (predeterminado) - Respeta la preferencia del sistema
  • "light" - Fuerza el modo claro
  • "dark" - Fuerza el modo oscuro
El navegador guarda la preferencia de tema en una cookie (whop-frosted-theme) y recurre a la preferencia del sistema cuando no existe ninguna.

Configuración

Configura la apariencia en tu componente WhopApp:
O crea temas anidados con diferentes apariencias:

Clases de modo oscuro de Tailwind

Usa el prefijo dark: para los estilos del modo oscuro:

Breakpoints

Frosted UI usa un sistema responsivo mobile-first con 5 breakpoints.

Escala de breakpoints

Props responsivas

Muchos componentes admiten valores responsivos mediante una sintaxis de objeto:

Clases responsivas de Tailwind


Iconos

Frosted UI incluye un sistema de iconos a través del paquete @frosted-ui/icons.

Uso de los iconos

Iconos comunes

Frosted UI usa Radix Icons, que incluye iconos como:
  • Navegación: ChevronRightIcon, ChevronDownIcon, ArrowRightIcon
  • Acciones: Cross2Icon, CheckIcon, PlusIcon, MinusIcon
  • UI: MagnifyingGlassIcon, GearIcon, PersonIcon
  • Hay más iconos disponibles en la biblioteca.

Plugin de Tailwind

El plugin de Tailwind de Frosted UI ofrece los design tokens como utilidades de Tailwind.

Qué incluye

Tipografía:
Colores:
Espaciado y layout:

Diferencias clave con Tailwind estándar

  1. Escala de tamaño de fuente: usa 0-9 en lugar de xs/sm/base/lg
  2. Escala de altura de línea: coincide con la escala de tamaño de fuente (0-9)
  3. Sistema de colores: escalas de color de Radix de 12 pasos con variantes alfa
  4. Colores semánticos: colores integrados de peligro, advertencia, éxito e información
  5. Design tokens: todos los valores usan variables CSS para mantener la coherencia del tema

Componentes comunes

Button

Props:
  • size: "1" | "2" | "3" | "4"
  • variant: "solid" | "soft" | "surface" | "ghost" | "classic"
  • color: cualquier color de acento
  • highContrast: contraste mejorado
  • loading: muestra un spinner de carga
  • disabled: desactiva la interacción

Input

Card

Badge

Dialog

Select

Checkbox y radio


Uso avanzado

Personalización del tema

Personaliza el tema con varias opciones:

Temas anidados

Crea secciones con temas diferentes:

Acceso al contexto del tema


Biblioteca de componentes

Frosted UI incluye más de 60 componentes organizados por categoría: Layout: Box, Flex, Grid, Container, Section, AspectRatio, Inset Tipografía: Heading, Text, Code, Strong, Em, Kbd, Quote, Blockquote Formularios: TextInput, TextArea, Checkbox, RadioGroup, Select, Switch, Slider, DatePicker, OTPField Botones: Button, IconButton Visualización: Card, Avatar, AvatarGroup, Badge, Callout, Table, DataList, Skeleton Navegación: Tabs, Breadcrumbs, Link, SegmentedControl Superposición: Dialog, AlertDialog, Drawer, Sheet, Popover, HoverCard, Tooltip, DropdownMenu, ContextMenu Feedback: Progress, CircularProgress, Spinner Utilidades: ScrollArea, Separator, Portal, VisuallyHidden, AccessibleIcon
Todos los componentes están construidos sobre primitivas de Radix UI y siguen las buenas prácticas de accesibilidad.

Recursos