Web
Proyek web dapat tampilan Sosialoka lewat salah satu dari dua cara:
- React atau Vue dengan shadcn: pasang tema produkmu, lalu komponennya, dari registry Sosialoka. Sebagian besar produk mulai dari sini.
- Aplikasi web lain: muat token CSS, dengan atau tanpa Tailwind, lalu bangun di atas variable-nya.
Siapkan proyek shadcn
Section titled “Siapkan proyek shadcn”Komponen React dibangun di atas Base UI dan dipasang dengan shadcn. Komponen Vue dibangun di atas Reka UI dan dipasang dengan shadcn-vue. Keduanya menyalin kode sumber ke proyekmu, jadi kodenya milikmu.
- Mulai dari proyek yang sudah memakai shadcn (React) atau shadcn-vue (Vue).
- Pasang tema produkmu. Tema ini menulis warna Sosialoka untuk mode terang dan gelap, font, dan radius ke CSS global-mu:
# Reactnpx shadcn@latest add https://design.sosialoka.tech/r/react/theme-coverclearance.json# Vuenpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/theme-coverclearance.jsonGanti coverclearance dengan lokamusik, lokasign, mylokalink, atau neutral untuk layar yang bukan milik produk mana pun. Proyek shadcn baru meng-import font Geist; hapus import itu, karena tema sudah memakai Plus Jakarta Sans untuk teks dan judul. Pernah memasang tema sebelumnya? Pasang ulang supaya dapat token terbaru seperti overlay, yang dipakai dialog dan sheet.
- Pasang komponen dari registry Sosialoka, misalnya:
npx shadcn@latest add https://design.sosialoka.tech/r/react/button.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/button.json- Muat Plus Jakarta Sans di produkmu. Nyalakan mode gelap dengan class
.darkdi elemen root, seperti proyek shadcn biasanya; tema menulis nilai gelapnya di bawah.dark.
Semua komponen dan perintah pasangnya ada di Komponen. Pola menunjukkan layar utuh yang disusun darinya.
Pakai token tanpa shadcn
Section titled “Pakai token tanpa shadcn”Pasang produk dan mode di elemen root. data-brand wajib ada. data-theme diisi light atau dark, dan class .dark juga bisa. Tanpa penanda gelap, nilai terang yang dipakai. Sediakan Terang, Gelap, dan Auto, dengan Auto (pengaturan perangkat) sebagai awal; lihat aturan mode di Dasbor.
<html data-brand="coverclearance" data-theme="dark">| File | Dipakai untuk |
|---|---|
| /tokens/sosialoka.css | Semua aplikasi web. CSS variable untuk semua tema dan preset aksen tenant. |
| /tokens/tailwind.css | Tailwind v4. Memetakan variable ke utility seperti bg-primary, text-muted-foreground, dan rounded-md. |
| /tokens.json | Alat desain dan AI agent. Semua token dalam format DTCG 2025.10. |
| /tokens/lokasign-light.json | Nilai jadi untuk satu tema. Ganti nama file-nya untuk tema lain. |
Di proyek Tailwind v4:
@import "tailwindcss";@import "./sosialoka.css";@import "./tailwind.css";Token hanya menyebut nama font, tidak menyertakan file-nya. Muat Plus Jakarta Sans untuk antarmuka dan JetBrains Mono untuk kode di produkmu.
Aksen tenant
Section titled “Aksen tenant”Halaman yang memakai warna tenant atau artist memasang preset di elemen root-nya sendiri. Presetnya blue, orange, teal, dan red.
<main data-tenant-accent="orange">Di dalamnya, token tenant-accent berganti ke preset itu. Token lain tetap memakai warna produk.
