Skip to main content
Frosted UI is de uitgebreide React-componentenbibliotheek en het designsysteem van Whop. Het biedt meer dan 60 componenten die aan toegankelijkheidsnormen voldoen. Het bevat ook een geavanceerd kleursysteem, een typografieschaal en naadloze ondersteuning voor de donkere modus, allemaal gebouwd op Radix UI-primitives en Tailwind CSS.

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

Props:
  • 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 toegankelijkheid
  • as: "span" | "div" | "p" | "label"

Heading-component

Props:
  • 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 grijs
  • mauve - Licht paarsgetint
  • slate - Koel blauwgetint
  • sage - Subtiel groengetint
  • olive - Warm olijfgetint
  • sand - Warm zandgetint
  • auto - 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:
Kleurschaal:
  • 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
Alfavarianten:
  • Gebruik {color}-a1 tot en met {color}-a12 voor transparantie
Als frostedUiPlugin() aan je Tailwind-configuratie is toegevoegd, werken de standaard Tailwind-kleuren zoals bg-blue-200 niet. Gebruik in plaats daarvan bg-blue-2, volgens de documentatie hierboven.

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
De browser slaat de themavoorkeur op in een cookie (whop-frosted-theme) en valt terug op de systeemvoorkeur als die er niet is.

Configuratie

Configureer de weergave in je WhopApp-component:
Of maak geneste thema’s met verschillende weergaven:

Tailwind-klassen voor de donkere modus

Gebruik het voorvoegsel dark: 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:
Kleuren:
Spatiëring en lay-out:

Belangrijkste verschillen met standaard Tailwind

  1. Lettergrootteschaal: gebruikt 0-9 in plaats van xs/sm/base/lg
  2. Regelhoogteschaal: komt overeen met de lettergrootteschaal (0-9)
  3. Kleursysteem: Radix-kleurschalen van 12 stappen met alfavarianten
  4. Semantische kleuren: ingebouwde kleuren voor danger, warning, success en info
  5. Design tokens: alle waarden gebruiken CSS-variabelen voor consistentie in het thema

Veelgebruikte componenten

Button

Props:
  • size: "1" | "2" | "3" | "4"
  • variant: "solid" | "soft" | "surface" | "ghost" | "classic"
  • color: elke accentkleur
  • highContrast: verhoogd contrast
  • loading: toont een laadspinner
  • disabled: 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