Installatie
1
Het pakket installeren
Het pakket
@whop/react bevat Frosted UI en alle benodigde dependencies.2
De WhopApp-provider instellen
Omhul je applicatie met de component
WhopApp in je root-layout. Dit stelt het thema en de iframe-SDK in.3
Next.js configureren (optioneel)
Gebruik de wrapper
withWhopAppConfig in je Next.js-configuratie:Dit configureert server actions en optimaliseert de imports van Frosted UI.
4
Tailwind instellen (optioneel)
Als je Tailwind CSS gebruikt, voeg dan de Frosted UI-plugin toe om toegang te krijgen tot design tokens:
Frosted UI is nu ingesteld en klaar voor gebruik.
Typografie
Frosted UI biedt een uitgebreid typografiesysteem met twee hoofdcomponenten:Heading en Text.
Typeschaal
Beide componenten gebruiken een groottenschaal van 10 stappen (0-9):Text-component
size:"0"through"9"(default:"3")weight:"light"|"regular"|"medium"|"bold"align:"left"|"center"|"right"color: elke accentkleur of"gray"highContrast: verhoogt het contrast voor toegankelijkheidas:"span"|"div"|"p"|"label"
Heading-component
size:"0"through"9"(default:"6")weight:"light"|"regular"|"medium"|"bold"align:"left"|"center"|"right"as:"h1"|"h2"|"h3"|"h4"|"h5"|"h6"color: elke accentkleur of"gray"highContrast: verhoogt het contrast voor toegankelijkheid
Andere typografiecomponenten
Kleuren
Frosted UI gebruikt de kleurschalen van Radix, met kleurpaletten van 12 stappen in zowel effen als alfavarianten.Accentkleuren
Er zijn 27 accentkleuren beschikbaar: Gewone kleuren:tomato, red, ruby, crimson, pink, plum, purple, violet, iris, indigo, blue, cyan, teal, jade, green, grass, brown, orange
Felle kleuren: sky, mint, lime, yellow, amber, lemon, magenta
Metallic kleuren: gold, bronze
Grijstinten
6 grijsschalen met verschillende kleurtemperaturen:gray- Puur neutraal grijsmauve- Licht paarsgetintslate- Koel blauwgetintsage- Subtiel groengetintolive- Warm olijfgetintsand- Warm zandgetintauto- Past zich automatisch aan de accentkleur aan
Semantische kleuren
Vooraf geconfigureerde kleuren voor veelvoorkomende toepassingen:- Danger:
red(standaard),tomato,ruby - Warning:
amber(standaard),yellow - Success:
green(standaard),teal,jade,grass - Info:
sky(standaard),blue
Kleuren gebruiken
Tailwind-kleurklassen
Met de Tailwind-plugin kun je de kleuren van Frosted UI direct gebruiken:- Stappen 1-3: achtergronden en subtiele vullingen
- Stappen 4-6: randen en scheidingslijnen
- Stappen 7-9: interactieve elementen
- Stappen 10-12: tekst en elementen met hoog contrast
- Gebruik
{color}-a1tot en met{color}-a12voor transparantie
Donkere modus
Frosted UI bevat automatische ondersteuning voor de donkere modus, die systeemvoorkeuren en gebruikerskeuzes respecteert.Hoe het werkt
Beheer de donkere modus via drie weergavemodi:"inherit"(standaard) - Respecteert de systeemvoorkeur"light"- Dwingt de lichte modus af"dark"- Dwingt de donkere modus af
whop-frosted-theme) en valt terug op de systeemvoorkeur als die er niet is.
Configuratie
Configureer de weergave in jeWhopApp-component:
Tailwind-klassen voor de donkere modus
Gebruik het voorvoegseldark: voor stijlen in de donkere modus:
Breakpoints
Frosted UI gebruikt een mobile-first responsief systeem met 5 breakpoints.Breakpointschaal
Responsieve props
Veel componenten ondersteunen responsieve waarden met een objectsyntaxis:Responsieve Tailwind-klassen
Iconen
Frosted UI bevat een iconensysteem via het pakket@frosted-ui/icons.
Iconen gebruiken
Veelgebruikte iconen
Frosted UI gebruikt Radix Icons, met onder meer iconen zoals:- Navigatie:
ChevronRightIcon,ChevronDownIcon,ArrowRightIcon - Acties:
Cross2Icon,CheckIcon,PlusIcon,MinusIcon - UI:
MagnifyingGlassIcon,GearIcon,PersonIcon - Meer iconen zijn beschikbaar in de bibliotheek.
Tailwind-plugin
De Tailwind-plugin van Frosted UI biedt design tokens als Tailwind-utilities.Wat is inbegrepen
Typografie:Belangrijkste verschillen met standaard Tailwind
- Lettergrootteschaal: gebruikt 0-9 in plaats van xs/sm/base/lg
- Regelhoogteschaal: komt overeen met de lettergrootteschaal (0-9)
- Kleursysteem: Radix-kleurschalen van 12 stappen met alfavarianten
- Semantische kleuren: ingebouwde kleuren voor danger, warning, success en info
- Design tokens: alle waarden gebruiken CSS-variabelen voor consistentie in het thema
Veelgebruikte componenten
Button
size:"1"|"2"|"3"|"4"variant:"solid"|"soft"|"surface"|"ghost"|"classic"color: elke accentkleurhighContrast: verhoogd contrastloading: toont een laadspinnerdisabled: schakelt interactie uit
Input
Card
Badge
Dialog
Select
Checkbox en radio
Geavanceerd gebruik
Thema aanpassen
Pas het thema aan met meerdere opties:Geneste thema’s
Maak secties met verschillende thema’s:Toegang tot de themacontext
Componentenbibliotheek
Frosted UI bevat meer dan 60 componenten, ingedeeld per categorie: Layout:Box, Flex, Grid, Container, Section, AspectRatio, Inset
Typografie: Heading, Text, Code, Strong, Em, Kbd, Quote, Blockquote
Formulieren: TextInput, TextArea, Checkbox, RadioGroup, Select, Switch, Slider, DatePicker, OTPField
Knoppen: Button, IconButton
Weergave: Card, Avatar, AvatarGroup, Badge, Callout, Table, DataList, Skeleton
Navigatie: Tabs, Breadcrumbs, Link, SegmentedControl
Overlay: Dialog, AlertDialog, Drawer, Sheet, Popover, HoverCard, Tooltip, DropdownMenu, ContextMenu
Feedback: Progress, CircularProgress, Spinner
Hulpmiddelen: ScrollArea, Separator, Portal, VisuallyHidden, AccessibleIcon
Alle componenten zijn gebouwd op Radix UI-primitives en volgen de best practices
voor toegankelijkheid.
Bronnen
- Radix UI-documentatie - Componentprimitives
- Radix Colors - Documentatie van het kleursysteem
- Tailwind CSS - Utility-first CSS-framework

