Skip to main content
Frosted UI est la bibliothèque complète de composants React et le design system de Whop. Elle fournit plus de 60 composants conformes aux normes d’accessibilité. Elle inclut également un système de couleurs sophistiqué, une échelle typographique et une prise en charge fluide du mode sombre, le tout construit sur les primitives Radix UI et Tailwind CSS.

Installation

1

Installer le package

Le package @whop/react inclut Frosted UI et toutes les dépendances nécessaires.
2

Configurer le provider WhopApp

Enveloppez votre application avec le composant WhopApp dans votre layout racine. Cela configure le thème et le SDK iframe.
3

Configurer Next.js (facultatif)

Utilisez le wrapper withWhopAppConfig dans votre configuration Next.js :
Cela configure les server actions et optimise les imports de Frosted UI.
4

Configurer Tailwind (facultatif)

Si vous utilisez Tailwind CSS, ajoutez le plugin Frosted UI pour accéder aux design tokens :
Frosted UI est maintenant configuré et prêt à l’emploi.

Typographie

Frosted UI fournit un système typographique complet avec deux composants principaux : Heading et Text.

Échelle typographique

Les deux composants utilisent une échelle de tailles en 10 niveaux (0-9) :

Composant Text

Props :
  • size : de "0" à "9" (par défaut : "3")
  • weight : "light" | "regular" | "medium" | "bold"
  • align : "left" | "center" | "right"
  • color : n’importe quelle couleur d’accent ou "gray"
  • highContrast : augmente le contraste pour l’accessibilité
  • as : "span" | "div" | "p" | "label"

Composant Heading

Props :
  • size : de "0" à "9" (par défaut : "6")
  • weight : "light" | "regular" | "medium" | "bold"
  • align : "left" | "center" | "right"
  • as : "h1" | "h2" | "h3" | "h4" | "h5" | "h6"
  • color : n’importe quelle couleur d’accent ou "gray"
  • highContrast : augmente le contraste pour l’accessibilité

Autres composants typographiques


Couleurs

Frosted UI utilise les échelles de couleurs Radix, qui fournissent des palettes de 12 niveaux avec des variantes pleines et alpha.

Couleurs d’accent

27 couleurs d’accent sont disponibles : Couleurs standard : tomato, red, ruby, crimson, pink, plum, purple, violet, iris, indigo, blue, cyan, teal, jade, green, grass, brown, orange Couleurs vives : sky, mint, lime, yellow, amber, lemon, magenta Couleurs métalliques : gold, bronze

Couleurs grises

6 échelles de gris avec différentes températures de couleur :
  • gray - Gris neutre pur
  • mauve - Légèrement teinté de violet
  • slate - Teinté de bleu froid
  • sage - Subtilement teinté de vert
  • olive - Teinté d’olive chaud
  • sand - Teinté de sable chaud
  • auto - S’adapte automatiquement à la couleur d’accent

Couleurs sémantiques

Couleurs préconfigurées pour les cas d’usage courants :
  • Danger : red (par défaut), tomato, ruby
  • Avertissement : amber (par défaut), yellow
  • Succès : green (par défaut), teal, jade, grass
  • Info : sky (par défaut), blue

Utiliser les couleurs

Classes de couleurs Tailwind

Avec le plugin Tailwind, vous pouvez utiliser directement les couleurs de Frosted UI :
Échelle de couleurs :
  • Niveaux 1-3 : arrière-plans et remplissages discrets
  • Niveaux 4-6 : bordures et séparateurs
  • Niveaux 7-9 : éléments interactifs
  • Niveaux 10-12 : texte et éléments à fort contraste
Variantes alpha :
  • Utilisez {color}-a1 à {color}-a12 pour la transparence
Lorsque frostedUiPlugin() est ajouté à votre configuration tailwind, les couleurs tailwind par défaut comme bg-blue-200 ne fonctionnent pas. Utilisez plutôt bg-blue-2 conformément à la documentation ci-dessus.

Mode sombre

Frosted UI inclut une prise en charge automatique du mode sombre qui respecte les préférences système et les choix de l’utilisateur.

Fonctionnement

Gérez le mode sombre grâce à trois modes d’apparence :
  • "inherit" (par défaut) - Respecte la préférence système
  • "light" - Force le mode clair
  • "dark" - Force le mode sombre
Le navigateur stocke la préférence de thème dans un cookie (whop-frosted-theme) et se rabat sur la préférence système en l’absence de cookie.

Configuration

Configurez l’apparence dans votre composant WhopApp :
Ou créez des thèmes imbriqués avec des apparences différentes :

Classes Tailwind pour le mode sombre

Utilisez le préfixe dark: pour les styles du mode sombre :

Breakpoints

Frosted UI utilise un système responsive mobile-first avec 5 breakpoints.

Échelle des breakpoints

Props responsive

De nombreux composants prennent en charge des valeurs responsive via une syntaxe objet :

Classes responsive Tailwind


Icônes

Frosted UI inclut un système d’icônes via le package @frosted-ui/icons.

Utiliser les icônes

Icônes courantes

Frosted UI utilise Radix Icons, qui comprend des icônes telles que :
  • Navigation : ChevronRightIcon, ChevronDownIcon, ArrowRightIcon
  • Actions : Cross2Icon, CheckIcon, PlusIcon, MinusIcon
  • UI : MagnifyingGlassIcon, GearIcon, PersonIcon
  • D’autres icônes sont disponibles dans la bibliothèque.

Plugin Tailwind

Le plugin Tailwind de Frosted UI fournit les design tokens sous forme d’utilitaires Tailwind.

Contenu inclus

Typographie :
Couleurs :
Espacement et mise en page :

Principales différences avec Tailwind standard

  1. Échelle des tailles de police : utilise 0-9 au lieu de xs/sm/base/lg
  2. Échelle des hauteurs de ligne : correspond à l’échelle des tailles de police (0-9)
  3. Système de couleurs : échelles de couleurs Radix en 12 niveaux avec variantes alpha
  4. Couleurs sémantiques : couleurs danger, warning, success et info intégrées
  5. Design tokens : toutes les valeurs utilisent des variables CSS pour la cohérence du thème

Composants courants

Button

Props :
  • size : "1" | "2" | "3" | "4"
  • variant : "solid" | "soft" | "surface" | "ghost" | "classic"
  • color : n’importe quelle couleur d’accent
  • highContrast : contraste renforcé
  • loading : affiche un indicateur de chargement
  • disabled : désactive l’interaction

Input

Card

Badge

Dialog

Select

Checkbox et radio


Utilisation avancée

Personnalisation du thème

Personnalisez le thème avec plusieurs options :

Thèmes imbriqués

Créez des sections avec des thèmes différents :

Accéder au contexte du thème


Bibliothèque de composants

Frosted UI inclut plus de 60 composants organisés par catégorie : Mise en page : Box, Flex, Grid, Container, Section, AspectRatio, Inset Typographie : Heading, Text, Code, Strong, Em, Kbd, Quote, Blockquote Formulaires : TextInput, TextArea, Checkbox, RadioGroup, Select, Switch, Slider, DatePicker, OTPField Boutons : Button, IconButton Affichage : Card, Avatar, AvatarGroup, Badge, Callout, Table, DataList, Skeleton Navigation : Tabs, Breadcrumbs, Link, SegmentedControl Superposition : Dialog, AlertDialog, Drawer, Sheet, Popover, HoverCard, Tooltip, DropdownMenu, ContextMenu Feedback : Progress, CircularProgress, Spinner Utilitaires : ScrollArea, Separator, Portal, VisuallyHidden, AccessibleIcon
Tous les composants sont construits sur les primitives Radix UI et suivent les bonnes pratiques d’accessibilité.

Ressources