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
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 accesibilidadas:"span"|"div"|"p"|"label"
Componente Heading
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 puromauve- Ligeramente teñido de moradoslate- Teñido de azul fríosage- Sutilmente teñido de verdeolive- Teñido de oliva cálidosand- Teñido de arena cálidoauto- 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:- 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
- Usa de
{color}-a1a{color}-a12para la transparencia
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
whop-frosted-theme) y recurre a la preferencia del sistema cuando no existe ninguna.
Configuración
Configura la apariencia en tu componenteWhopApp:
Clases de modo oscuro de Tailwind
Usa el prefijodark: 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:Diferencias clave con Tailwind estándar
- Escala de tamaño de fuente: usa 0-9 en lugar de xs/sm/base/lg
- Escala de altura de línea: coincide con la escala de tamaño de fuente (0-9)
- Sistema de colores: escalas de color de Radix de 12 pasos con variantes alfa
- Colores semánticos: colores integrados de peligro, advertencia, éxito e información
- Design tokens: todos los valores usan variables CSS para mantener la coherencia del tema
Componentes comunes
Button
size:"1"|"2"|"3"|"4"variant:"solid"|"soft"|"surface"|"ghost"|"classic"color: cualquier color de acentohighContrast: contraste mejoradoloading: muestra un spinner de cargadisabled: 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
- Documentación de Radix UI - Primitivas de componentes
- Radix Colors - Documentación del sistema de colores
- Tailwind CSS - Framework CSS utility-first

