# Web

> Siapkan proyek React, Vue, atau web biasa dengan tema, token, dan komponen Sosialoka.

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

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:

```bash
# 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.

3. Pasang komponen dari registry Sosialoka, misalnya:

```bash
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
```

4. 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](https://design.sosialoka.tech/id/components/). [Pola](https://design.sosialoka.tech/id/patterns/login/) menunjukkan layar utuh yang disusun darinya.

## 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](https://design.sosialoka.tech/id/patterns/dashboard/#aturan).

```html
<html data-brand="coverclearance" data-theme="dark">
```

| File | Dipakai untuk |
| --- | --- |
| [/tokens/sosialoka.css](https://design.sosialoka.tech/tokens/sosialoka.css) | Semua aplikasi web. CSS variable untuk semua tema dan preset aksen tenant. |
| [/tokens/tailwind.css](https://design.sosialoka.tech/tokens/tailwind.css) | Tailwind v4. Memetakan variable ke utility seperti `bg-primary`, `text-muted-foreground`, dan `rounded-md`. |
| [/tokens.json](https://design.sosialoka.tech/tokens.json) | Alat desain dan AI agent. Semua token dalam format DTCG 2025.10. |
| [/tokens/lokasign-light.json](https://design.sosialoka.tech/tokens/lokasign-light.json) | Nilai jadi untuk satu tema. Ganti nama file-nya untuk tema lain. |

Di proyek Tailwind v4:

```css
@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

Halaman yang memakai warna tenant atau artist memasang preset di elemen root-nya sendiri. Presetnya `blue`, `orange`, `teal`, dan `red`.

```html
<main data-tenant-accent="orange">
```

Di dalamnya, token `tenant-accent` berganti ke preset itu. Token lain tetap memakai warna produk.
