Lewati ke konten

Web

Unduh .md

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.

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.

  1. Mulai dari proyek yang sudah memakai shadcn (React) atau shadcn-vue (Vue).
  2. Pasang tema produkmu. Tema ini menulis warna Sosialoka untuk mode terang dan gelap, font, dan radius ke CSS global-mu:
Terminal window
# React
npx shadcn@latest add https://design.sosialoka.tech/r/react/theme-coverclearance.json
# Vue
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/theme-coverclearance.json

Ganti 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.

  1. Pasang komponen dari registry Sosialoka, misalnya:
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/button.json
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/button.json
  1. Muat Plus Jakarta Sans di produkmu. Nyalakan mode gelap dengan class .dark di 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.

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.

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.