Skip to main content
Frosted UI, Whop’un kapsamlı React bileşen kütüphanesi ve tasarım sistemidir. Erişilebilirlik standartlarını karşılayan 60’tan fazla bileşen sunar. Ayrıca gelişmiş bir renk sistemi, tipografi ölçeği ve sorunsuz karanlık mod desteği içerir; bunların tümü Radix UI temel yapı taşları ve Tailwind CSS üzerine kuruludur.

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

Prop’lar:
  • 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ır
  • as: "span" | "div" | "p" | "label"

Heading bileşeni

Prop’lar:
  • 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 gri
  • mauve - Hafif mor tonlu
  • slate - Soğuk mavi tonlu
  • sage - Hafif yeşil tonlu
  • olive - Sıcak zeytin tonlu
  • sand - Sıcak kum tonlu
  • auto - 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:
Renk ölçeği:
  • 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
Alfa varyantları:
  • Saydamlık için {color}-a1 ile {color}-a12 arasını kullanın
Tailwind yapılandırmanıza frostedUiPlugin() eklendiğinde, bg-blue-200 gibi varsayılan Tailwind renkleri çalışmaz. Bunun yerine yukarıdaki belgelere uygun olarak bg-blue-2 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
Tarayıcı tema tercihini bir çerezde (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:
Ya da farklı görünümlere sahip iç içe temalar oluşturun:

Tailwind karanlık mod sınıfları

Karanlık mod stilleri için dark: ö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:
Renkler:
Boşluk ve düzen:

Standart Tailwind’den temel farklar

  1. Yazı boyutu ölçeği: xs/sm/base/lg yerine 0-9 kullanır
  2. Satır yüksekliği ölçeği: Yazı boyutu ölçeğiyle (0-9) eşleşir
  3. Renk sistemi: Alfa varyantlarına sahip 12 adımlı Radix renk ölçekleri
  4. Anlamsal renkler: Yerleşik tehlike, uyarı, başarı ve bilgi renkleri
  5. Tasarım token’ları: Tema tutarlılığı için tüm değerler CSS değişkenleri kullanır

Yaygın bileşenler

Button

Prop’lar:
  • size: "1" | "2" | "3" | "4"
  • variant: "solid" | "soft" | "surface" | "ghost" | "classic"
  • color: Herhangi bir vurgu rengi
  • highContrast: Gelişmiş kontrast
  • loading: Yükleme göstergesini gösterir
  • disabled: 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