Kurulum
1
Paketi yükleyin
@whop/react paketi Frosted UI’ı ve gerekli tüm bağımlılıkları içerir.2
WhopApp sağlayıcısını kurun
Kök düzeninizde uygulamanızı
WhopApp bileşeniyle sarmalayın. Bu, temayı ve iframe SDK’sını kurar.3
Next.js'i yapılandırın (isteğe bağlı)
Next.js yapılandırmanızda
withWhopAppConfig sarmalayıcısını kullanın:Bu, sunucu eylemlerini yapılandırır ve Frosted UI içe aktarmalarını optimize eder.
4
Tailwind'i kurun (isteğe bağlı)
Tailwind CSS kullanıyorsanız, tasarım token’larına erişmek için Frosted UI eklentisini ekleyin:
Frosted UI artık kuruldu ve kullanıma hazır.
Tipografi
Frosted UI, iki ana bileşene sahip kapsamlı bir tipografi sistemi sunar:Heading ve Text.
Yazı ölçeği
Her iki bileşen de 10 adımlı bir boyut ölçeği (0-9) kullanır:Text bileşeni
size:"0"ile"9"arası (varsayılan:"3")weight:"light"|"regular"|"medium"|"bold"align:"left"|"center"|"right"color: Herhangi bir vurgu rengi veya"gray"highContrast: Erişilebilirlik için kontrastı artırıras:"span"|"div"|"p"|"label"
Heading bileşeni
size:"0"ile"9"arası (varsayılan:"6")weight:"light"|"regular"|"medium"|"bold"align:"left"|"center"|"right"as:"h1"|"h2"|"h3"|"h4"|"h5"|"h6"color: Herhangi bir vurgu rengi veya"gray"highContrast: Erişilebilirlik için kontrastı artırır
Diğer tipografi bileşenleri
Renkler
Frosted UI, hem düz hem de alfa varyantlarına sahip 12 adımlı renk paletleri sunan Radix renk ölçeklerini kullanır.Vurgu renkleri
27 vurgu rengi mevcuttur: Normal renkler:tomato, red, ruby, crimson, pink, plum, purple, violet, iris, indigo, blue, cyan, teal, jade, green, grass, brown, orange
Parlak renkler: sky, mint, lime, yellow, amber, lemon, magenta
Metalik renkler: gold, bronze
Gri renkler
Farklı renk sıcaklıklarına sahip 6 gri ölçeği:gray- Saf nötr grimauve- Hafif mor tonluslate- Soğuk mavi tonlusage- Hafif yeşil tonluolive- Sıcak zeytin tonlusand- Sıcak kum tonluauto- Vurgu rengiyle otomatik olarak eşleşir
Anlamsal renkler
Yaygın kullanım durumları için önceden yapılandırılmış renkler:- Tehlike:
red(varsayılan),tomato,ruby - Uyarı:
amber(varsayılan),yellow - Başarı:
green(varsayılan),teal,jade,grass - Bilgi:
sky(varsayılan),blue
Renkleri kullanma
Tailwind renk sınıfları
Tailwind eklentisiyle Frosted UI renklerini doğrudan kullanabilirsiniz:- 1-3. adımlar: Arka planlar ve hafif dolgular
- 4-6. adımlar: Kenarlıklar ve ayırıcılar
- 7-9. adımlar: Etkileşimli öğeler
- 10-12. adımlar: Metin ve yüksek kontrastlı öğeler
- Saydamlık için
{color}-a1ile{color}-a12arasını kullanın
Karanlık mod
Frosted UI, sistem tercihlerine ve kullanıcı seçimlerine uyan otomatik karanlık mod desteği içerir.Nasıl çalışır
Karanlık modu üç görünüm modu üzerinden yönetin:"inherit"(varsayılan) - Sistem tercihine uyar"light"- Açık modu zorlar"dark"- Karanlık modu zorlar
whop-frosted-theme) saklar ve çerez yoksa sistem tercihine geri döner.
Yapılandırma
GörünümüWhopApp bileşeninizde yapılandırın:
Tailwind karanlık mod sınıfları
Karanlık mod stilleri içindark: önekini kullanın:
Kesme noktaları
Frosted UI, 5 kesme noktasına sahip mobil öncelikli duyarlı bir sistem kullanır.Kesme noktası ölçeği
Duyarlı prop’lar
Birçok bileşen, nesne sözdizimi kullanarak duyarlı değerleri destekler:Tailwind duyarlı sınıfları
Simgeler
Frosted UI,@frosted-ui/icons paketi aracılığıyla bir simge sistemi içerir.
Simgeleri kullanma
Yaygın simgeler
Frosted UI, aşağıdaki gibi simgeleri içeren Radix Icons’ı kullanır:- Gezinme:
ChevronRightIcon,ChevronDownIcon,ArrowRightIcon - Eylemler:
Cross2Icon,CheckIcon,PlusIcon,MinusIcon - Arayüz:
MagnifyingGlassIcon,GearIcon,PersonIcon - Kütüphanede daha fazla simge mevcuttur.
Tailwind eklentisi
Frosted UI Tailwind eklentisi, tasarım token’larını Tailwind yardımcı sınıfları olarak sunar.Neler dahil
Tipografi:Standart Tailwind’den temel farklar
- Yazı boyutu ölçeği: xs/sm/base/lg yerine 0-9 kullanır
- Satır yüksekliği ölçeği: Yazı boyutu ölçeğiyle (0-9) eşleşir
- Renk sistemi: Alfa varyantlarına sahip 12 adımlı Radix renk ölçekleri
- Anlamsal renkler: Yerleşik tehlike, uyarı, başarı ve bilgi renkleri
- Tasarım token’ları: Tema tutarlılığı için tüm değerler CSS değişkenleri kullanır
Yaygın bileşenler
Button
size:"1"|"2"|"3"|"4"variant:"solid"|"soft"|"surface"|"ghost"|"classic"color: Herhangi bir vurgu rengihighContrast: Gelişmiş kontrastloading: Yükleme göstergesini gösterirdisabled: Etkileşimi devre dışı bırakır
Input
Card
Badge
Dialog
Select
Checkbox ve radio
Gelişmiş kullanım
Tema özelleştirme
Temayı birden fazla seçenekle özelleştirin:İç içe temalar
Farklı temalara sahip bölümler oluşturun:Tema bağlamına erişme
Bileşen kütüphanesi
Frosted UI, kategorilere göre düzenlenmiş 60’tan fazla bileşen içerir: Düzen:Box, Flex, Grid, Container, Section, AspectRatio, Inset
Tipografi: Heading, Text, Code, Strong, Em, Kbd, Quote, Blockquote
Formlar: TextInput, TextArea, Checkbox, RadioGroup, Select, Switch, Slider, DatePicker, OTPField
Düğmeler: Button, IconButton
Görüntüleme: Card, Avatar, AvatarGroup, Badge, Callout, Table, DataList, Skeleton
Gezinme: Tabs, Breadcrumbs, Link, SegmentedControl
Katman: Dialog, AlertDialog, Drawer, Sheet, Popover, HoverCard, Tooltip, DropdownMenu, ContextMenu
Geri bildirim: Progress, CircularProgress, Spinner
Yardımcılar: ScrollArea, Separator, Portal, VisuallyHidden, AccessibleIcon
Tüm bileşenler Radix UI temel yapı taşları üzerine kuruludur ve erişilebilirlik
en iyi uygulamalarını izler.
Kaynaklar
- Radix UI belgeleri - Bileşen temel yapı taşları
- Radix Colors - Renk sistemi belgeleri
- Tailwind CSS - Yardımcı sınıf öncelikli CSS çatısı

