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
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
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 purmauve- Légèrement teinté de violetslate- Teinté de bleu froidsage- Subtilement teinté de vertolive- Teinté d’olive chaudsand- Teinté de sable chaudauto- 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 :- 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
- Utilisez
{color}-a1à{color}-a12pour la transparence
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
whop-frosted-theme) et se rabat sur la préférence système en l’absence de cookie.
Configuration
Configurez l’apparence dans votre composantWhopApp :
Classes Tailwind pour le mode sombre
Utilisez le préfixedark: 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 :Principales différences avec Tailwind standard
- Échelle des tailles de police : utilise 0-9 au lieu de xs/sm/base/lg
- Échelle des hauteurs de ligne : correspond à l’échelle des tailles de police (0-9)
- Système de couleurs : échelles de couleurs Radix en 12 niveaux avec variantes alpha
- Couleurs sémantiques : couleurs danger, warning, success et info intégrées
- Design tokens : toutes les valeurs utilisent des variables CSS pour la cohérence du thème
Composants courants
Button
size:"1"|"2"|"3"|"4"variant:"solid"|"soft"|"surface"|"ghost"|"classic"color: n’importe quelle couleur d’accenthighContrast: contraste renforcéloading: affiche un indicateur de chargementdisabled: 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
- Documentation Radix UI - Primitives de composants
- Radix Colors - Documentation du système de couleurs
- Tailwind CSS - Framework CSS utility-first

