# Sosialoka Design System

> Token, komponen, dan pola yang dipakai bersama oleh Loka Musik, Cover Clearance, Lokasign, dan My Loka Link.

Token, komponen, dan pola untuk Loka Musik, Cover Clearance, Lokasign, dan My Loka Link, di React, Vue, dan Flutter. Pilih produk untuk melihat seluruh situs dalam warnanya.

- [Lihat komponen](https://design.sosialoka.tech/id/components/)
- [Siapkan proyek](https://design.sosialoka.tech/id/web/)

- [Fondasi](https://design.sosialoka.tech/id/foundations/color/): Warna, tipografi, ikon, spasi, radius, elevasi, dan gerak, semuanya sebagai token.
- [Komponen](https://design.sosialoka.tech/id/components/): Kontrol dan permukaan untuk React dan Vue, dengan kode Flutter di sebelahnya.
- [Pola](https://design.sosialoka.tech/id/patterns/login/): Layar utuh: login, dasbor, daftar, formulir, dan state di antaranya.

## Komponen yang paling sering dipakai

- [Button](https://design.sosialoka.tech/id/components/button/): Menjalankan aksi.
- [Input](https://design.sosialoka.tech/id/components/input/): Satu baris teks.
- [Select](https://design.sosialoka.tech/id/components/select/): Memilih satu nilai dari daftar pendek.
- [Switch](https://design.sosialoka.tech/id/components/switch/): Pengaturan yang langsung berlaku.
- [Card](https://design.sosialoka.tech/id/components/card/): Mengelompokkan isi di permukaannya sendiri.
- [Table](https://design.sosialoka.tech/id/components/table/): Data dalam baris dan kolom, dengan paginasi.
- [Dialog](https://design.sosialoka.tech/id/components/dialog/): Keputusan atau form singkat di atas halaman.
- [Toast](https://design.sosialoka.tech/id/components/toast/): Memberi tahu aksi yang berhasil.

## Produk

- **Loka Musik**: distribusi musik dan royalti.
- **Cover Clearance**: lisensi lagu cover.
- **Lokasign**: tanda tangan elektronik.
- **My Loka Link**: halaman link untuk artist musik.

Layar yang bukan milik produk mana pun, seperti tool internal atau prototipe awal partner, memakai [tema netral](https://design.sosialoka.tech/id/add-a-product/#tema-netral). Produk baru dapat temanya sendiri dengan [satu perintah](https://design.sosialoka.tech/id/add-a-product/).

## Mulai membangun

Pilih platformmu. Tiap panduan memasang tema produkmu dan menunjukkan komponennya.

| Platform | Yang kamu dapat |
| --- | --- |
| [Web](https://design.sosialoka.tech/id/web/) | Komponen React dan Vue dari registry Sosialoka, atau token CSS untuk aplikasi web apa pun, dengan utility Tailwind v4. |
| [Flutter](https://design.sosialoka.tech/id/flutter/) | Paket `sosialoka_ui`: tema untuk widget `shadcn_ui` dan Material. |
| [Pakai dengan AI agent](https://design.sosialoka.tech/id/ai-agents/) | Server MCP, llms.txt, dan potongan AGENTS.md, supaya agent membangun dengan sistem ini. |

## Pakai pola

[Pola](https://design.sosialoka.tech/id/patterns/login/) menunjukkan layar utuh yang disusun dari komponen: login, kerangka dasbor, halaman list, detail, dan form, state kosong, memuat, dan error, serta halaman artist My Loka Link. Login dan kerangka dasbor dipasang sebagai blok; sisanya panduan dengan kode yang bisa kamu salin. [Konten](https://design.sosialoka.tech/id/content/) mengatur gaya bahasa di layar-layar itu.

## Untuk AI agent

Setiap halaman juga tersedia sebagai Markdown: tambahkan `.md` di alamatnya, atau pakai tombol di bawah judul halaman. [/id/llms.txt](https://design.sosialoka.tech/id/llms.txt) berisi daftar semua halaman beserta ringkasannya, dan [/id/llms-full.txt](https://design.sosialoka.tech/id/llms-full.txt) berisi seluruh dokumentasi dalam satu file. Versi bahasa Inggris ada tanpa awalan `/id/`.


---

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


---

# Flutter

> Paket sosialoka_ui memberi aplikasi Flutter tema Sosialoka untuk shadcn_ui dan Material.

Paket `sosialoka_ui` memberi aplikasi Flutter tema Sosialoka sesuai produknya, untuk widget `shadcn_ui` dan widget Material, di mode terang dan gelap.

## Pasang

Paket ini dipasang dari repositori design system:

```yaml
dependencies:
  shadcn_ui: ^0.59.0
  sosialoka_ui:
    git:
      url: https://gitlab.com/sosialoka/design-system.git
      path: flutter
```

## Pasang tema

Pilih produkmu dengan `SosialokaBrand`, atau `SosialokaBrand.neutral` untuk aplikasi yang bukan milik produk mana pun. `SosialokaTheme.shad` membuat tema `shadcn_ui`, dan `SosialokaTheme.material` membuat tema Material yang sepadan untuk layar yang masih memakai widget Material.

```dart
import 'package:flutter/material.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

class App extends StatelessWidget {
  const App({super.key});

  @override
  Widget build(BuildContext context) {
    const brand = SosialokaBrand.coverclearance;
    return ShadApp.custom(
      theme: SosialokaTheme.shad(brand, Brightness.light),
      darkTheme: SosialokaTheme.shad(brand, Brightness.dark),
      appBuilder: (context) => MaterialApp(
        theme: SosialokaTheme.material(brand, Brightness.light),
        darkTheme: SosialokaTheme.material(brand, Brightness.dark),
        builder: (context, child) => ShadAppBuilder(child: child!),
        home: const HomeScreen(),
      ),
    );
  }
}
```

Layar bisa dipindahkan satu per satu: layar Material dan layar `shadcn_ui` memakai warna dan radius yang sama.

## Warna tambahan

`shadcn_ui` tidak punya field untuk warna status, warna lembut, aksen tenant, atau warna brand. Baca dari tema dengan `context.sosialoka`:

```dart
ShadBadge(
  backgroundColor: context.sosialoka.successSoft,
  foregroundColor: context.sosialoka.success,
  child: const Text('Selesai'),
);
```

Nilai mentah, radius, spasi, dan ukuran teks juga tersedia sebagai konstanta: `SosialokaColors`, `SosialokaRadius`, `SosialokaSpace`, dan `SosialokaText`. Konstanta yang sama ada dalam satu file, [/tokens/sosialoka_tokens.dart](https://design.sosialoka.tech/tokens/sosialoka_tokens.dart), untuk aplikasi tanpa paket ini.

## Font

Tema memasang Plus Jakarta Sans lewat paket `google_fonts`, yang mengunduh font saat pertama dipakai. Aplikasi yang harus jalan offline sebaiknya menyertakan file font-nya dan mendaftarkannya di `pubspec.yaml`.

## Contoh

Setiap halaman komponen menampilkan kode Flutter-nya di tab Flutter. Kode yang sama jalan di aplikasi galeri di `flutter/example` dalam repositori, tempat `flutter analyze` dan tes render di setiap brand dan mode memeriksanya.


---

# Pakai dengan AI agent

> Sambungkan Claude Code, Cursor, VS Code, Codex, atau Gemini CLI ke design system lewat MCP server, llms.txt, registry, dan cuplikan AGENTS.md.

AI agent bisa membaca seluruh design system dalam format terbuka, jadi agent apa pun, Claude atau bukan, membangun UI dengan token, komponen, dan pola yang sama dengan dokumentasi ini.

## Yang bisa dibaca agent

| Sumber | Kegunaan |
| --- | --- |
| URL halaman + `.md`, misalnya [/id/components/button.md](https://design.sosialoka.tech/id/components/button.md) | Satu halaman dalam Markdown. Setiap halaman juga punya tombol **Salin sebagai Markdown** dan **Unduh .md**. |
| [/id/llms.txt](https://design.sosialoka.tech/id/llms.txt) dan [/llms.txt](https://design.sosialoka.tech/llms.txt) | Indeks semua halaman beserta ringkasan satu kalimat ([llmstxt.org](https://llmstxt.org)). |
| [/id/llms-full.txt](https://design.sosialoka.tech/id/llms-full.txt) dan [/llms-full.txt](https://design.sosialoka.tech/llms-full.txt) | Semua halaman dalam satu file. |
| [/tokens.json](https://design.sosialoka.tech/tokens.json) dan `/tokens/<theme>.json` | Semua token dalam format DTCG, dan nilai jadi satu tema. |
| [/r/react/registry.json](https://design.sosialoka.tech/r/react/registry.json) dan [/r/vue/registry.json](https://design.sosialoka.tech/r/vue/registry.json) | Registry shadcn untuk komponen React dan Vue. |
| [/sosialoka-design-system-docs.zip](https://design.sosialoka.tech/sosialoka-design-system-docs.zip) | Semua yang di atas dalam satu unduhan. |
| `https://design.sosialoka.tech/mcp` | MCP server: pencarian, halaman, komponen, pola, dan token sebagai tool. |

## Sambungkan MCP server

Server ini memakai MCP lewat Streamable HTTP di `https://design.sosialoka.tech/mcp`. Tidak perlu login, karena semua isinya publik. Beri nama `sosialoka-design` supaya cuplikan AGENTS.md di bawah bisa menemukannya.

### Claude Code

```bash
claude mcp add --transport http sosialoka-design https://design.sosialoka.tech/mcp
```

Tambahkan `--scope project` supaya tersimpan di `.mcp.json` repositori dan dipakai seluruh tim.

### Cursor

Di `.cursor/mcp.json` proyek, atau `~/.cursor/mcp.json` untuk semua proyek:

```json
{
  "mcpServers": {
    "sosialoka-design": { "url": "https://design.sosialoka.tech/mcp" }
  }
}
```

### VS Code

Di `.vscode/mcp.json`:

```json
{
  "servers": {
    "sosialoka-design": { "type": "http", "url": "https://design.sosialoka.tech/mcp" }
  }
}
```

### Codex

Di `~/.codex/config.toml`:

```toml
[mcp_servers.sosialoka-design]
url = "https://design.sosialoka.tech/mcp"
```

### Gemini CLI

Di `~/.gemini/settings.json`, atau `.gemini/settings.json` proyek:

```json
{
  "mcpServers": {
    "sosialoka-design": { "httpUrl": "https://design.sosialoka.tech/mcp" }
  }
}
```

## Tool

Setiap tool mengembalikan Markdown. Tool yang menerima `locale` memakai `en` (bawaan) atau `id`.

| Tool | Argumen | Hasil |
| --- | --- | --- |
| `search_docs` | `query`, `locale`, `limit` | Halaman yang cocok, beserta path untuk `get_page`. |
| `get_page` | `path`, `locale` | Satu halaman. Path bisa berupa `foundations/color`, `/id/content/`, atau URL halaman lengkap. |
| `list_components` | tidak ada | Semua komponen beserta framework-nya, dan semua pola halaman. |
| `get_component` | `name`, `platform`, `locale` | Panduan komponen beserta perintah pasang dan kodenya. `platform` (`react`, `vue`, atau `flutter`) menyisakan kode satu platform saja. |
| `get_tokens` | `theme` | Nilai jadi satu tema. Tanpa `theme`, hasilnya daftar tema dan tautan ke file DTCG lengkap. |
| `list_themes` | tidak ada | Daftar tema dan cara menggantinya. |
| `get_pattern` | `name`, `locale` | Satu pola halaman, misalnya `login`, `dashboard`, `list`, atau `form`, beserta kodenya. |

## Pasang komponen lewat MCP shadcn

Registry React juga bisa dipakai lewat MCP server resmi shadcn, jadi agent bisa mencari komponen Sosialoka dan memasangnya berdasarkan nama. Tambahkan registry-nya ke `components.json`:

```json
{
  "registries": {
    "@sosialoka": "https://design.sosialoka.tech/r/react/{name}.json"
  }
}
```

Lalu siapkan MCP server shadcn untuk agent-mu (`claude`, `cursor`, atau `vscode`):

```bash
npx shadcn@latest mcp init --client claude
```

`mcp init` belum bisa menulis konfigurasi Codex. Untuk Codex, tambahkan ini ke `~/.codex/config.toml`:

```toml
[mcp_servers.shadcn]
command = "npx"
args = ["shadcn@latest", "mcp"]
```

Minta item berdasarkan nama registry-nya, misalnya "add @sosialoka/button". MCP shadcn melayani registry React. Di proyek Vue, agent mengambil perintah pasang `shadcn-vue` dari `get_component` atau dari halaman komponen.

## Tambahkan aturannya ke repo-mu

Tempel cuplikan ini ke file `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, atau `.cursor/rules` di repositori produk. File yang sama ada di [/AGENTS.md](https://design.sosialoka.tech/AGENTS.md).

````markdown
## Sosialoka Design System

This product uses the Sosialoka Design System (https://design.sosialoka.tech). Follow it for every UI change.

- **Read before you build.** Index: https://design.sosialoka.tech/llms.txt (Indonesian: https://design.sosialoka.tech/id/llms.txt). Every page is Markdown at its URL + `.md`.
- **Use the MCP server when it is connected** (`sosialoka-design`, https://design.sosialoka.tech/mcp): `search_docs`, `get_component` with `platform`, `get_pattern`, `get_tokens` with a theme.
- **Install components from the registry; don't rewrite them.**
  - React: `npx shadcn@latest add https://design.sosialoka.tech/r/react/<name>.json`
  - Vue: `npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/<name>.json`
  - Install your product's theme first: https://design.sosialoka.tech/web.md
  - Flutter: the `sosialoka_ui` package (https://design.sosialoka.tech/flutter.md).
- **Use tokens, never raw values:** `bg-primary`, `text-muted-foreground`, `border-input`, `rounded-md`. No hex colors, no pixel radius.
- **Set the theme on the root element:** `data-brand` = your product (`lokamusik`, `coverclearance`, `lokasign`, `mylokalink`), or `neutral` when the screen belongs to no product; `data-theme` = `light` or `dark`.
- **Icons:** Lucide. **UI font:** Plus Jakarta Sans.
- **Labels sit above inputs.** One primary action per screen.
- **Copy** (https://design.sosialoka.tech/content.md): Indonesian uses "kamu", never "Anda". Short, active sentences. Error messages come from the backend; the client only disables the button.
````

## Unduh semuanya

[sosialoka-design-system-docs.zip](https://design.sosialoka.tech/sosialoka-design-system-docs.zip) berisi setiap halaman dalam Markdown berbahasa Inggris dan Indonesia, file `llms.txt` dan `llms-full.txt`, `tokens.json`, satu file `tokens/<theme>.json` per tema, dan `AGENTS.md`. Paket ini dibangun ulang setiap kali situs dirilis.


---

# Menambah produk

> Buat tema terang dan gelap untuk produk Sosialoka baru dari warna logonya dengan satu perintah, dan pakai tema netral untuk layar yang bukan milik produk mana pun.

Setiap brand tercatat satu kali, di `tokens/brands.json`. Build token, registry, paket Flutter, dan situs ini membaca daftar itu, jadi produk baru cukup butuh satu perintah, logonya, dan beberapa baris dokumentasi.

## Sebelum mulai

- **Warna logo** dalam format `#RRGGBB`. Warna ini langsung jadi `primary` di mode terang: primary sebuah produk selalu warna logonya.
- **File logo**, satu untuk latar terang dan satu untuk latar gelap, dalam SVG atau PNG.
- **Id**: huruf kecil dan angka, misalnya `lokaticket`. Id ini jadi nilai `data-brand`, nama file tema, dan nilai enum Flutter, jadi tentukan sekali saja.

## 1. Buat temanya

Di repositori design system:

```bash
pnpm new-brand lokaticket --name "Loka Ticket" --logo "#B83A0B" --summary "Ticketing for music events."
```

Perintah ini menulis `tokens/themes/lokaticket-light.tokens.json` dan `lokaticket-dark.tokens.json`, menambahkan produknya ke `tokens/brands.json`, lalu menjalankan cek kontras untuk dua tema baru itu.

| Opsi | Untuk |
| --- | --- |
| `--name` | Nama produk seperti yang dibaca orang. Wajib. |
| `--logo` | Warna logo. Wajib. |
| `--summary` | Satu baris berbahasa Inggris tentang fungsi produknya. Wajib. |
| `--secondary` | Warna logo kedua, untuk gradien dan hero login. |
| `--dark-primary` | `primary` di mode gelap, kalau hasil turunannya kurang cocok dengan logonya. |
| `--font` | Font display untuk momen brand. Default-nya Plus Jakarta Sans. |
| `--fallback` | `sans-serif` atau `serif`, setelah font display. |
| `--sample` | Kalimat contoh dalam font display di halaman Brand. Tulis seperti kalimat di hero login. |

## Cara warnanya dibuat

| Token | Terang | Gelap |
| --- | --- | --- |
| `primary` | Warna logo | Warna logo, dicerahkan sampai teks gelap terbaca di atasnya |
| `primary-foreground` | Putih atau tinta gelap, mana yang terbaca di warna logo dan di hover-nya | Tinta gelap |
| `background`, `card`, `muted`, `border` | Hampir putih, dengan sedikit rona logo | Hampir hitam, dengan sedikit rona logo |
| `foreground`, `muted-foreground`, `input` | Digeser sampai mencapai 4.5:1, atau 3:1 untuk `input` | Sama |
| `primary-soft`, `primary-text` | Rona pucat, dan warna logo yang digelapkan sampai terbaca sebagai teks | Rona gelap, dan versi terang warna logo |
| `chart-1` | Warna logo, digelapkan hanya kalau perlu untuk mencapai 3:1 | Warna logo, dicerahkan hanya kalau perlu |
| `brand-*` | Warna logo, sama di kedua mode | Sama |

Logo abu-abu menghasilkan neutral abu-abu, karena ronanya tidak pernah lebih berwarna dari logonya. Hasilnya titik awal: buka file temanya, ubah yang terasa kurang pas dengan produknya, lalu jalankan `pnpm check`, yang menjaga setiap pasangan warna di kontras yang dibutuhkan.

### Kalau cek kontras melaporkan pasangan

Beberapa warna logo, seperti pink atau jingga terang, tidak bisa memuat teks putih maupun gelap di 4.5:1. Perintahnya tetap memakai warna logo dan menampilkan pasangan itu. Jangan ganti `primary` sendiri: tanyakan ke pemilik design system. Pasangan itu bisa diterima sebagai pengecualian di `packages/tokens/src/contrast.ts`, seperti jingga Cover Clearance, atau primary-nya diganti.

## 2. Tambahkan logonya

Simpan file-nya di `site/public/brand/` dan daftarkan di entri produknya di `tokens/brands.json`:

```json
"logos": [
  { "variant": "light-ground", "file": "lokaticket.svg", "alt": "Loka Ticket logo, for light grounds" },
  { "variant": "dark-ground", "file": "lokaticket-white.svg", "alt": "Loka Ticket logo, white, for dark grounds" }
]
```

Halaman Brand menampilkannya di grid logo, dan contoh font ikut memakai font display serta kalimat contohnya.

## 3. Muat font display baru

Kalau font display-nya belum dimuat situs, tambahkan paket `@fontsource-variable`-nya ke `site/` dan impor di `FontSpecimen.astro` serta `block-preview.css`. Produk memuat font-nya sendiri.

## 4. Tambahkan produknya ke dokumentasi

- Di halaman [Brand](https://design.sosialoka.tech/id/brand/), satu bagian berisi token brand produknya: `<TokenTable group="brand" theme="lokaticket-light" />`.
- Di beranda, satu baris di daftar produk.
- Di `site/public/AGENTS.md`, id-nya di daftar `data-brand`.

Tulis setiap perubahan dalam bahasa Inggris dan bahasa Indonesia, di bawah `id/`.

## 5. Cek dan commit

Jalankan `pnpm check`. Perintah ini membangun ulang semua yang membaca daftar brand:

- `sosialoka.css` dengan `[data-brand="lokaticket"]` untuk mode terang dan gelap
- tema registry `theme-lokaticket.json` untuk React dan Vue
- nilai enum Flutter `SosialokaBrand.lokaticket` di `tokens.g.dart`
- pemilih brand di situs ini dan daftar tema di server MCP

Commit file tema, `tokens/brands.json`, logo, dan `flutter/lib/src/generated/tokens.g.dart`. Setelah itu produknya memasang tema seperti produk lain:

```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/theme-lokaticket.json
```

```dart
ShadApp(theme: SosialokaTheme.shad(SosialokaBrand.lokaticket, Brightness.light));
```

## Tema netral

`neutral` adalah tema grafit: permukaan abu-abu, `primary` hampir hitam di mode terang dan abu-abu terang di mode gelap. Tema ini bukan milik produk mana pun. Pakai untuk:

- pekerjaan vendor atau partner yang dimulai sebelum brand produknya ditetapkan
- tool internal dan prototipe
- layar yang melayani beberapa produk sekaligus

Produk yang sudah punya logo pakai temanya sendiri. Tema netral dipasang dan diganti seperti tema lain:

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

```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/theme-neutral.json
```

```dart
ShadApp(theme: SosialokaTheme.shad(SosialokaBrand.neutral, Brightness.light));
```


---

# Brand

> Cara produk Sosialoka tampil sebagai satu keluarga, sementara tiap produk tetap memakai nama, logo, dan warnanya sendiri.

Produk Sosialoka memakai model brand endorsed: tiap produk punya nama, logo, dan warnanya sendiri, dan Sosialoka berdiri di belakang semuanya. Untuk menambah produk baru, lihat [Menambah produk](https://design.sosialoka.tech/id/add-a-product/).

## Penanda produk

Layar login dan footer produk memuat baris **from [mark Sosialoka] Sosialoka**: kata "from", mark Sosialoka, lalu namanya. "from" menyatakan Sosialoka pemilik produknya. Jangan tulis "Powered by", karena kesannya Sosialoka hanya penyedia teknologi.

## Logo

- Sosialoka mark: [sosialoka.png](https://design.sosialoka.tech/brand/sosialoka.png)
- Loka Musik logo, for light grounds: [lokamusik.svg](https://design.sosialoka.tech/brand/lokamusik.svg)
- Loka Musik logo, white text, for dark grounds: [lokamusik-white.svg](https://design.sosialoka.tech/brand/lokamusik-white.svg)
- Cover Clearance logo, color: [coverclearance.svg](https://design.sosialoka.tech/brand/coverclearance.svg)
- Cover Clearance logo, white, for dark grounds: [coverclearance-white.svg](https://design.sosialoka.tech/brand/coverclearance-white.svg)
- Lokasign logo, for light grounds: [lokasign.png](https://design.sosialoka.tech/brand/lokasign.png)
- Lokasign logo, for dark grounds: [lokasign-dark.png](https://design.sosialoka.tech/brand/lokasign-dark.png)
- My Loka Link lockup, for light grounds: [mylokalink.svg](https://design.sosialoka.tech/brand/mylokalink.svg)
- My Loka Link lockup, for dark grounds: [mylokalink-white.svg](https://design.sosialoka.tech/brand/mylokalink-white.svg)

- Pakai file-nya apa adanya. Jangan digambar ulang, diganti warna, diregangkan, diputar, atau diberi efek.
- Di latar gelap, pakai versi putih atau versi untuk latar gelap.
- Versi terang dan gelap sebuah logo hanya berbeda di warna tulisannya; warna mark-nya tetap.

## Warna brand

`primary` tiap produk adalah warna logonya. Token `brand-*` menyimpan warna logo itu sendiri dan sama di mode terang maupun gelap. Pakai hanya di momen brand seperti hero login.

### Loka Musik

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| brand-primary | `--brand-primary` | #660032 | Warna logo, sama di mode terang dan gelap; hanya untuk momen brand. |
| brand-secondary | `--brand-secondary` | #FF8FC6 | Warna logo kedua, untuk gradasi dan momen brand saja. |
| brand-ground | `--brand-ground` | #660032 | Warna latar hero login dan momen brand lainnya. |
| brand-ground-foreground | `--brand-ground-foreground` | #FFFFFF | Teks di atas brand-ground, seperti di hero login. |
| font-brand | `--font-brand` | Poppins, sans-serif | Font display untuk momen brand saja, misalnya hero login. |
| font-brand-weight | `--font-brand-weight` | 600 | Ketebalan font display di momen brand. |
| font-brand-stretch | `--font-brand-stretch` | 100% | Lebar (font-stretch) font display di momen brand. |
| font-brand-tracking | `--font-brand-tracking` | -0.02em | Jarak huruf (letter-spacing) font display di momen brand. |

### Cover Clearance

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| brand-primary | `--brand-primary` | #E48725 | Warna logo, sama di mode terang dan gelap; hanya untuk momen brand. |
| brand-secondary | `--brand-secondary` | #0576BB | Warna logo kedua, untuk gradasi dan momen brand saja. |
| brand-ground | `--brand-ground` | #E48725 | Warna latar hero login dan momen brand lainnya. |
| brand-ground-foreground | `--brand-ground-foreground` | #1A1F2E | Teks di atas brand-ground, seperti di hero login. |
| font-brand | `--font-brand` | "Rethink Sans Variable", "Rethink Sans", sans-serif | Font display untuk momen brand saja, misalnya hero login. |
| font-brand-weight | `--font-brand-weight` | 800 | Ketebalan font display di momen brand. |
| font-brand-stretch | `--font-brand-stretch` | 100% | Lebar (font-stretch) font display di momen brand. |
| font-brand-tracking | `--font-brand-tracking` | -0.02em | Jarak huruf (letter-spacing) font display di momen brand. |

### Lokasign

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| brand-primary | `--brand-primary` | #0060EF | Warna logo, sama di mode terang dan gelap; hanya untuk momen brand. |
| brand-secondary | `--brand-secondary` | #7DAEFF | Warna logo kedua, untuk gradasi dan momen brand saja. |
| brand-ground | `--brand-ground` | #001D43 | Warna latar hero login dan momen brand lainnya. |
| brand-ground-foreground | `--brand-ground-foreground` | #FFFFFF | Teks di atas brand-ground, seperti di hero login. |
| font-brand | `--font-brand` | "Newsreader Variable", Newsreader, Georgia, serif | Font display untuk momen brand saja, misalnya hero login. |
| font-brand-weight | `--font-brand-weight` | 500 | Ketebalan font display di momen brand. |
| font-brand-stretch | `--font-brand-stretch` | 100% | Lebar (font-stretch) font display di momen brand. |
| font-brand-tracking | `--font-brand-tracking` | -0.01em | Jarak huruf (letter-spacing) font display di momen brand. |

### My Loka Link

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| brand-primary | `--brand-primary` | #0A66C2 | Warna logo, sama di mode terang dan gelap; hanya untuk momen brand. |
| brand-secondary | `--brand-secondary` | #00B8C8 | Warna logo kedua, untuk gradasi dan momen brand saja. |
| brand-ground | `--brand-ground` | #0A66C2 | Warna latar hero login dan momen brand lainnya. |
| brand-ground-foreground | `--brand-ground-foreground` | #FFFFFF | Teks di atas brand-ground, seperti di hero login. |
| font-brand | `--font-brand` | "Plus Jakarta Sans Variable", "Plus Jakarta Sans", sans-serif | Font display untuk momen brand saja, misalnya hero login. |
| font-brand-weight | `--font-brand-weight` | 800 | Ketebalan font display di momen brand. |
| font-brand-stretch | `--font-brand-stretch` | 100% | Lebar (font-stretch) font display di momen brand. |
| font-brand-tracking | `--font-brand-tracking` | -0.035em | Jarak huruf (letter-spacing) font display di momen brand. |

## Tiga lapis font

| Lapis | Di mana | Font |
| --- | --- | --- |
| Logo | Hanya di logo | Milik tiap produk. Jangan ketik ulang logo. |
| Display | Hanya di [momen brand](#momen-brand) | Satu per produk, lihat di bawah |
| UI | Semua yang lain: tabel, form, tombol, teks | Plus Jakarta Sans di semua produk |

| Produk | Font display | Tebal | Lebar | Contoh |
| --- | --- | --- | --- | --- |
| Loka Musik | Poppins | 600 | 100% | Rilis musikmu ke semua platform. |
| Cover Clearance | Rethink Sans | 800 | 100% | Pilih lagu yang ingin kamu cover. |
| Lokasign | Newsreader | 500 | 100% | Tanda tangan sah, *dari mana saja.* |
| My Loka Link | Plus Jakarta Sans | 800 | 100% | Semua link musikmu di satu tempat. |

## Momen brand

Momen brand adalah tempat produk bicara dengan suaranya sendiri. Ada tiga:

- **Hero login:** separuh kiri layar login.
- **Layar sambutan:** onboarding dan layar pertama akun yang masih kosong.
- **Bagian atas beranda:** layar pertama setelah masuk, di ponsel maupun di web.

Di beranda, `font-brand` hanya boleh dipakai untuk:

- sapaan, misalnya "Halo, Bayu.";
- judul satu kartu unggulan di bagian atas;
- angka utama, misalnya total pemasukan atau jumlah di kartu ringkasan.

Kartu unggulan boleh berlatar `brand-ground`, warna logo. Di atasnya:

- teks dan ikon memakai `brand-ground-foreground`;
- aksi utama memakai tombol `secondary`, dan aksi lain memakai tombol `ghost` dengan warna `brand-ground-foreground`;
- badge memakai varian `outline`, dengan teks dan garis tepi berwarna `brand-ground-foreground`.

Hanya satu kartu itu yang berlatar `brand-ground`; kartu lain di beranda tetap memakai `card`.

Judul seksi, list, tabel, form, tombol, badge, top bar, dan navigasi tetap memakai `font-sans`, di beranda juga. Pakai `font-brand` bersama token weight dan tracking-nya, di ukuran `text-2xl` atau lebih besar; lebih kecil dari itu, ia terbaca seperti teks biasa dengan font yang salah.


---

# Warna

> Token warna semantik untuk semua tema, tiap produk dan tema netral dalam mode terang dan gelap.

Komponen meminta peran seperti `primary` atau `muted-foreground`, bukan kode hex, jadi komponen yang sama jalan di semua tema.

## Peran

- `background`: latar halaman di belakang kartu.
- `foreground`: teks utama.
- `card` dan `popover`: kartu, menu, dan permukaan form.
- `muted` dan `muted-foreground`: permukaan tenang dan teks sekunder.
- `border` dan `input`: garis pemisah dan garis tepi kontrol.
- `primary` dan `primary-foreground`: aksi utama, dengan warna logo produk.
- `primary-soft` dan `primary-text`: permukaan berwarna lembut dan teks kecil berwarna primary, misalnya link.
- `ring`: cincin fokus keyboard.
- `sidebar-*`: sidebar dasbor.

`secondary` dan `accent` tetap memakai arti dari shadcn: isi tombol yang tenang dan latar saat hover. Keduanya bukan warna brand.

## Semua tema

| Token | lokamusik-light | lokamusik-dark | coverclearance-light | coverclearance-dark | lokasign-light | lokasign-dark | mylokalink-light | mylokalink-dark | neutral-light | neutral-dark |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| background | #FDF9FA | #1C0F16 | #F9F8F6 | #0A0D14 | #F3F6FB | #001D43 | #FFFFFF | #0B1620 | #FAFAFD | #0E0E11 |
| foreground | #1C0F16 | #F5F5F5 | #181B1F | #DBDEE3 | #001D43 | #EEF3FB | #1C3B4E | #F2F6F8 | #1A1A1D | #E6E6EA |
| card | #FFFFFF | #26181F | #FFFFFF | #12161E | #FFFFFF | #0A2A57 | #FFFFFF | #13212B | #FFFFFF | #17171A |
| muted | #F5F5F5 | #2E2028 | #F2F0EC | #1B1F29 | #EAF0F8 | #0F3466 | #ECF6FC | #1A2B36 | #F2F2F6 | #1F1F22 |
| muted-foreground | #4A3A42 | #B4A7AA | #625D56 | #A0A5AE | #4A5B78 | #A9BAD6 | #657078 | #87939B | #636366 | #AAAAAE |
| border | #ECE4E6 | #3A2B33 | #ECE9E3 | #262B36 | #D5DEEC | #1D4478 | #DCE8F1 | #23343F | #E6E6EA | #2B2B2E |
| input | #998D90 | #7A6871 | #908F8D | #5F646D | #7D8FA9 | #5376A6 | #8A969E | #606B72 | #909093 | #68686C |
| primary | #660032 | #FF8FC6 | #E48725 | #E87F34 | #0060EF | #7DAEFF | #0A66C2 | #65A7F9 | #27272A | #E4E4E7 |
| primary-foreground | #FFFFFF | #660032 | #FFFFFF | #180600 | #FFFFFF | #001D43 | #FFFFFF | #0B1620 | #FFFFFF | #0D0D10 |
| primary-soft | #FFEEF6 | #3D001E | #FFEEE1 | #371C0B | #E6EFFE | #0F3466 | #ECF4FF | #162C47 | #F3F3F4 | #29292A |
| primary-text | #660032 | #FF8FC6 | #A8530A | #EF9F67 | #0050C8 | #7DAEFF | #0A66C2 | #72A7EB | #27272A | #E4E4E7 |
| ring | #660032 | #FF8FC6 | #A8530A | #E87F34 | #0060EF | #7DAEFF | #0A66C2 | #65A7F9 | #27272A | #E4E4E7 |
| card-foreground | #1C0F16 | #F5F5F5 | #181B1F | #DBDEE3 | #001D43 | #EEF3FB | #1C3B4E | #F2F6F8 | #1A1A1D | #E6E6EA |
| popover | #FFFFFF | #26181F | #FFFFFF | #12161E | #FFFFFF | #0A2A57 | #FFFFFF | #13212B | #FFFFFF | #17171A |
| popover-foreground | #1C0F16 | #F5F5F5 | #181B1F | #DBDEE3 | #001D43 | #EEF3FB | #1C3B4E | #F2F6F8 | #1A1A1D | #E6E6EA |
| secondary | #F5F5F5 | #2E2028 | #F2F0EC | #1B1F29 | #EAF0F8 | #0F3466 | #ECF6FC | #1A2B36 | #F2F2F6 | #1F1F22 |
| secondary-foreground | #1C0F16 | #F5F5F5 | #181B1F | #DBDEE3 | #001D43 | #EEF3FB | #1C3B4E | #F2F6F8 | #1A1A1D | #E6E6EA |
| accent | #F5F5F5 | #2E2028 | #F2F0EC | #1B1F29 | #EAF0F8 | #0F3466 | #ECF6FC | #1A2B36 | #F2F2F6 | #1F1F22 |
| accent-foreground | #1C0F16 | #F5F5F5 | #181B1F | #DBDEE3 | #001D43 | #EEF3FB | #1C3B4E | #F2F6F8 | #1A1A1D | #E6E6EA |
| sidebar | #FFFFFF | #26181F | #FFFFFF | #12161E | #FFFFFF | #0A2A57 | #FFFFFF | #13212B | #FFFFFF | #17171A |
| sidebar-foreground | #1C0F16 | #F5F5F5 | #181B1F | #DBDEE3 | #001D43 | #EEF3FB | #1C3B4E | #F2F6F8 | #1A1A1D | #E6E6EA |
| sidebar-border | #ECE4E6 | #3A2B33 | #ECE9E3 | #262B36 | #D5DEEC | #1D4478 | #DCE8F1 | #23343F | #E6E6EA | #2B2B2E |
| sidebar-accent | #FFEEF6 | #3D001E | #FFEEE1 | #371C0B | #E6EFFE | #0F3466 | #ECF4FF | #162C47 | #F3F3F4 | #29292A |
| sidebar-accent-foreground | #660032 | #FF8FC6 | #A8530A | #EF9F67 | #0050C8 | #7DAEFF | #0A66C2 | #72A7EB | #27272A | #E4E4E7 |
| sidebar-primary | #660032 | #FF8FC6 | #E48725 | #E87F34 | #0060EF | #7DAEFF | #0A66C2 | #65A7F9 | #27272A | #E4E4E7 |
| sidebar-primary-foreground | #FFFFFF | #660032 | #FFFFFF | #180600 | #FFFFFF | #001D43 | #FFFFFF | #0B1620 | #FFFFFF | #0D0D10 |
| sidebar-ring | #660032 | #FF8FC6 | #A8530A | #E87F34 | #0060EF | #7DAEFF | #0A66C2 | #65A7F9 | #27272A | #E4E4E7 |
| tenant-accent | #660032 | #FF8FC6 | #E48725 | #E87F34 | #0060EF | #7DAEFF | #0A66C2 | #65A7F9 | #27272A | #E4E4E7 |
| tenant-accent-foreground | #FFFFFF | #660032 | #FFFFFF | #180600 | #FFFFFF | #001D43 | #FFFFFF | #0B1620 | #FFFFFF | #0D0D10 |
| tenant-accent-soft | #FFEEF6 | #3D001E | #FFEEE1 | #371C0B | #E6EFFE | #0F3466 | #ECF4FF | #162C47 | #F3F3F4 | #29292A |
| tenant-accent-text | #660032 | #FF8FC6 | #A8530A | #EF9F67 | #0050C8 | #7DAEFF | #0A66C2 | #72A7EB | #27272A | #E4E4E7 |

## Status

Warna status sama di semua produk. `success`, `warning`, dan `destructive` berwarna, sedangkan `info` memakai abu-biru netral supaya tidak terlihat seperti aksi biru Lokasign atau My Loka Link. Status tidak boleh ditandai dengan warna saja: selalu pasangkan dengan kata atau ikon.

### Terang

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| success | `--success` | #0B6B5E | Warna status untuk selesai, disetujui, terbit; teks dan ikon di atas background, card, dan success-soft. |
| success-foreground | `--success-foreground` | #FFFFFF | Teks di atas isi success yang solid. |
| success-soft | `--success-soft` | #DDF3EF | Latar badge dan banner success; teks di atasnya memakai success. |
| warning | `--warning` | #8A4B00 | Warna status untuk menunggu dan sedang ditinjau; teks dan ikon di atas background, card, dan warning-soft. |
| warning-foreground | `--warning-foreground` | #FFFFFF | Teks di atas isi warning yang solid. |
| warning-soft | `--warning-soft` | #FFF1D6 | Latar badge dan banner warning; teks di atasnya memakai warning. |
| destructive | `--destructive` | #B42318 | Warna status untuk error, ditolak, dan aksi hapus; teks dan ikon di atas background, card, dan destructive-soft. |
| destructive-foreground | `--destructive-foreground` | #FFFFFF | Teks di atas isi destructive yang solid. |
| destructive-soft | `--destructive-soft` | #FDE7E4 | Latar badge dan banner destructive; teks di atasnya memakai destructive. |
| info | `--info` | #475467 | Status netral untuk informasi dan tips; abu-biru supaya tidak terbaca sebagai aksi brand. |
| info-foreground | `--info-foreground` | #FFFFFF | Teks di atas isi info yang solid. |
| info-soft | `--info-soft` | #EEF1F5 | Latar badge dan banner info; teks di atasnya memakai info. |

### Gelap

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| success | `--success` | #4FD1B5 | Warna status untuk selesai, disetujui, terbit; teks dan ikon di atas background, card, dan success-soft. |
| success-foreground | `--success-foreground` | #0B1620 | Teks di atas isi success yang solid. |
| success-soft | `--success-soft` | #12302B | Latar badge dan banner success; teks di atasnya memakai success. |
| warning | `--warning` | #F5B544 | Warna status untuk menunggu dan sedang ditinjau; teks dan ikon di atas background, card, dan warning-soft. |
| warning-foreground | `--warning-foreground` | #0B1620 | Teks di atas isi warning yang solid. |
| warning-soft | `--warning-soft` | #3A2C0F | Latar badge dan banner warning; teks di atasnya memakai warning. |
| destructive | `--destructive` | #FF8A75 | Warna status untuk error, ditolak, dan aksi hapus; teks dan ikon di atas background, card, dan destructive-soft. |
| destructive-foreground | `--destructive-foreground` | #0B1620 | Teks di atas isi destructive yang solid. |
| destructive-soft | `--destructive-soft` | #3A1A16 | Latar badge dan banner destructive; teks di atasnya memakai destructive. |
| info | `--info` | #B4BFCC | Status netral untuk informasi dan tips; abu-biru supaya tidak terbaca sebagai aksi brand. |
| info-foreground | `--info-foreground` | #0B1620 | Teks di atas isi info yang solid. |
| info-soft | `--info-soft` | #1E2733 | Latar badge dan banner info; teks di atasnya memakai info. |

## Palet grafik

Grafik memakai lima warna seri, `chart-1` sampai `chart-5`, dengan urutan itu. `chart-1` adalah hue produk sendiri; `chart-2` sampai `chart-5` (magenta, teal, zaitun, indigo) sama di semua produk dan tidak pernah memakai warna status. Setiap seri mencapai 3:1 di `background` dan `card`, dan urutannya lolos pemeriksaan buta warna untuk seri yang bersebelahan. Cover Clearance terang menggelapkan oranyenya menjadi `#C2620E` untuk `chart-1`, karena `#E48725` masih di bawah 3:1 di latarnya. Lebih dari lima seri digabung ke "Lainnya". Lihat [Chart](https://design.sosialoka.tech/id/components/chart/).

### Terang

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| chart-2 | `--chart-2` | #C2185B | Seri grafik kedua (magenta); sama di semua produk, bukan warna status. |
| chart-3 | `--chart-3` | #0087A3 | Seri grafik ketiga (teal); sama di semua produk, bukan warna status. |
| chart-4 | `--chart-4` | #6B7A00 | Seri grafik keempat (zaitun); sama di semua produk, bukan warna status. |
| chart-5 | `--chart-5` | #5B4FCF | Seri grafik kelima (indigo); sama di semua produk, bukan warna status. |
| chart-1 | `--chart-1` | #C2620E | Seri grafik pertama: hue brand, digelapkan bila perlu supaya mencapai 3:1 di background dan card. |

### Gelap

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| chart-2 | `--chart-2` | #D94E85 | Seri grafik kedua (magenta); sama di semua produk, bukan warna status. |
| chart-3 | `--chart-3` | #14A3B8 | Seri grafik ketiga (teal); sama di semua produk, bukan warna status. |
| chart-4 | `--chart-4` | #8C9A17 | Seri grafik keempat (zaitun); sama di semua produk, bukan warna status. |
| chart-5 | `--chart-5` | #7B6FE0 | Seri grafik kelima (indigo); sama di semua produk, bukan warna status. |
| chart-1 | `--chart-1` | #C9701F | Seri grafik pertama: hue brand, digelapkan bila perlu supaya mencapai 3:1 di background dan card. |

## Preset aksen tenant

Halaman artist My Loka Link dan tenant Ruang Loka Musik memakai warna aksennya sendiri. Pasang `data-tenant-accent` di root halaman dengan salah satu preset di bawah. Keempat token `tenant-accent` berganti, dan yang lain tidak berubah. Tanpa preset, token tenant mengikuti `primary`.

### Terang

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| blue · tenant-accent | `--tenant-accent` | #0A66C2 | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| blue · tenant-accent-foreground | `--tenant-accent-foreground` | #FFFFFF | Teks di atas tenant-accent. |
| blue · tenant-accent-soft | `--tenant-accent-soft` | #ECF4FF | Permukaan lembut dengan aksen tenant. |
| blue · tenant-accent-text | `--tenant-accent-text` | #0A66C2 | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |
| orange · tenant-accent | `--tenant-accent` | #C4530F | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| orange · tenant-accent-foreground | `--tenant-accent-foreground` | #FFFFFF | Teks di atas tenant-accent. |
| orange · tenant-accent-soft | `--tenant-accent-soft` | #FFEDE0 | Permukaan lembut dengan aksen tenant. |
| orange · tenant-accent-text | `--tenant-accent-text` | #AB4400 | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |
| teal · tenant-accent | `--tenant-accent` | #007B76 | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| teal · tenant-accent-foreground | `--tenant-accent-foreground` | #FFFFFF | Teks di atas tenant-accent. |
| teal · tenant-accent-soft | `--tenant-accent-soft` | #DCF9F6 | Permukaan lembut dengan aksen tenant. |
| teal · tenant-accent-text | `--tenant-accent-text` | #006D69 | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |
| red · tenant-accent | `--tenant-accent` | #BE222A | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| red · tenant-accent-foreground | `--tenant-accent-foreground` | #FFFFFF | Teks di atas tenant-accent. |
| red · tenant-accent-soft | `--tenant-accent-soft` | #FFECEB | Permukaan lembut dengan aksen tenant. |
| red · tenant-accent-text | `--tenant-accent-text` | #B32228 | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |

### Gelap

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| blue · tenant-accent | `--tenant-accent` | #65A7F9 | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| blue · tenant-accent-foreground | `--tenant-accent-foreground` | #1C3B4E | Teks di atas tenant-accent. |
| blue · tenant-accent-soft | `--tenant-accent-soft` | #162C47 | Permukaan lembut dengan aksen tenant. |
| blue · tenant-accent-text | `--tenant-accent-text` | #72A7EB | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |
| orange · tenant-accent | `--tenant-accent` | #F49752 | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| orange · tenant-accent-foreground | `--tenant-accent-foreground` | #241005 | Teks di atas tenant-accent. |
| orange · tenant-accent-soft | `--tenant-accent-soft` | #3A1E0E | Permukaan lembut dengan aksen tenant. |
| orange · tenant-accent-text | `--tenant-accent-text` | #F9A870 | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |
| teal · tenant-accent | `--tenant-accent` | #55CEC0 | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| teal · tenant-accent-foreground | `--tenant-accent-foreground` | #001C1A | Teks di atas tenant-accent. |
| teal · tenant-accent-soft | `--tenant-accent-soft` | #092D2B | Permukaan lembut dengan aksen tenant. |
| teal · tenant-accent-text | `--tenant-accent-text` | #69D3C6 | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |
| red · tenant-accent | `--tenant-accent` | #F68482 | Isi aksen tenant atau artis; mengikuti primary sampai ada preset. |
| red · tenant-accent-foreground | `--tenant-accent-foreground` | #250E0D | Teks di atas tenant-accent. |
| red · tenant-accent-soft | `--tenant-accent-soft` | #3B1C1B | Permukaan lembut dengan aksen tenant. |
| red · tenant-accent-text | `--tenant-accent-text` | #F99E9B | Teks beraksen tenant di atas background, card, dan tenant-accent-soft. |

## Kontras

- Teks minimal 4.5:1 terhadap permukaan di bawahnya, di semua tema dan semua preset tenant.
- Cincin fokus dan garis tepi input, select, serta checkbox (`input`) minimal 3:1.
- Tes memeriksa setiap pasangan di tiap build, jadi perubahan token yang merusak kontras membuat build gagal.

Ada satu pengecualian yang disengaja: teks putih di atas oranye Cover Clearance di mode terang hanya 2.7:1. Cover Clearance tetap memakai warna logonya sebagai isi tombol utama, sesuai keputusan pemilik. Buat label di atas warna itu pendek dan tebal.


---

# Tipografi

> Tiga lapis font dan skala teks UI.

Semua produk memakai Plus Jakarta Sans untuk antarmuka. Font display hanya muncul di momen brand, dan logo tetap memakai hurufnya sendiri.

## Font

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| font-sans | `--font-sans` | "Plus Jakarta Sans Variable", "Plus Jakarta Sans", ui-sans-serif, system-ui, sans-serif | Font UI bersama untuk semua produk: tabel, form, tombol, dan teks. |
| font-mono | `--font-mono` | "JetBrains Mono Variable", "JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, monospace | Kode, ID, timestamp, dan data tabel. |

- Pakai `font-sans` untuk semua teks antarmuka.
- Pakai `font-mono` untuk kode, ID, timestamp, dan data yang harus sejajar.
- Pakai `font-brand` hanya di momen brand: hero login, layar sambutan, dan bagian atas beranda. Lihat [Momen brand](https://design.sosialoka.tech/id/brand/#momen-brand).

## Skala



| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| text-xs | `--text-xs` | 0.75rem | Ukuran teks untuk keterangan, badge, dan info kecil di tabel. |
| text-xs--line-height | `--text-xs--line-height` | 1rem | Tinggi baris pasangan text-xs. |
| text-sm | `--text-sm` | 0.875rem | Ukuran teks UI bawaan: sel tabel, input, tombol. |
| text-sm--line-height | `--text-sm--line-height` | 1.25rem | Tinggi baris pasangan text-sm. |
| text-base | `--text-base` | 1rem | Ukuran teks isi dan form di layar lebar. |
| text-base--line-height | `--text-base--line-height` | 1.5rem | Tinggi baris pasangan text-base. |
| text-lg | `--text-lg` | 1.125rem | Ukuran teks paragraf pembuka dan judul kartu. |
| text-lg--line-height | `--text-lg--line-height` | 1.75rem | Tinggi baris pasangan text-lg. |
| text-xl | `--text-xl` | 1.25rem | Ukuran teks judul bagian di dalam halaman. |
| text-xl--line-height | `--text-xl--line-height` | 1.75rem | Tinggi baris pasangan text-xl. |
| text-2xl | `--text-2xl` | 1.5rem | Ukuran teks judul halaman di dasbor. |
| text-2xl--line-height | `--text-2xl--line-height` | 2rem | Tinggi baris pasangan text-2xl. |
| text-3xl | `--text-3xl` | 1.875rem | Ukuran teks judul halaman besar dan judul empty state. |
| text-3xl--line-height | `--text-3xl--line-height` | 2.25rem | Tinggi baris pasangan text-3xl. |
| text-4xl | `--text-4xl` | 2.25rem | Ukuran teks angka besar di hero dan judul pemasaran. |
| text-4xl--line-height | `--text-4xl--line-height` | 2.5rem | Tinggi baris pasangan text-4xl. |

- Pakai huruf kapital hanya di awal kalimat untuk judul, tombol, dan label.
- Pakai `font-variant-numeric: tabular-nums` di mana pun angka disusun sejajar dalam kolom.


---

# Ikon

> Satu set ikon untuk semua produk, dengan ukuran, stroke, dan kamus aksi yang tetap.

Semua produk memakai [Lucide](https://lucide.dev). Cover Clearance dan Lokasign masih memakai Tabler di beberapa layar; ikon itu pindah ke Lucide saat layarnya pindah ke design system ini.

| Paket | Impor |
| --- | --- |
| React | `import { Trash2Icon } from "lucide-react"` |
| Vue | `import { Trash2 } from "@lucide/vue"` |
| Flutter | `Icon(LucideIcons.trash2)`, dari `shadcn_ui` |

## Ukuran

- **16px** (`size-4`) di dalam kontrol dan di samping teks: tombol, input, badge, item menu.
- **20px** (`size-5`) di navigasi: sidebar, bottom nav, dan top bar.
- **24px** (`size-6`) di empty state.

## Stroke dan warna

- Stroke tetap di bawaan Lucide, yaitu 2, di semua produk. Jangan ditipiskan atau ditebalkan per brand.
- Ikon memakai `currentColor`, jadi warnanya ikut warna teks kontrolnya. Warnai ikon lewat warna teksnya, jangan lewat fill.

## Aksesibilitas

- Ikon dekoratif di samping label diberi `aria-hidden="true"`.
- Tombol yang hanya berisi ikon wajib punya `aria-label` dan [Tooltip](https://design.sosialoka.tech/id/components/tooltip/) dengan kata yang sama.
- Ikon status (sukses, peringatan, error) selalu disertai teks. Ikon tidak pernah membawa arti sendirian.

## Kamus ikon

Pakai ikon yang sama untuk aksi yang sama di semua produk. Kalau aksinya belum ada, pilih dari Lucide lalu tambahkan di sini.

| Aksi | Lucide | React | Vue | Flutter |
| --- | --- | --- | --- | --- |
| Tambah | plus | PlusIcon | Plus | LucideIcons.plus |
| Ubah | pencil | PencilIcon | Pencil | LucideIcons.pencil |
| Hapus | trash-2 | Trash2Icon | Trash2 | LucideIcons.trash2 |
| Cari | search | SearchIcon | Search | LucideIcons.search |
| Filter | list-filter | ListFilterIcon | ListFilter | LucideIcons.listFilter |
| Urutkan | arrow-up-down | ArrowUpDownIcon | ArrowUpDown | LucideIcons.arrowUpDown |
| Unduh | download | DownloadIcon | Download | LucideIcons.download |
| Unggah | upload | UploadIcon | Upload | LucideIcons.upload |
| Notifikasi | bell | BellIcon | Bell | LucideIcons.bell |
| Pengaturan | settings | SettingsIcon | Settings | LucideIcons.settings |
| Akun | user | UserIcon | User | LucideIcons.user |
| Keluar | log-out | LogOutIcon | LogOut | LucideIcons.logOut |
| Rilis | disc | DiscIcon | Disc | LucideIcons.disc |
| Royalti | chart-column | ChartColumnIcon | ChartColumn | LucideIcons.chartColumn |
| Dokumen | file-text | FileTextIcon | FileText | LucideIcons.fileText |
| Lagu | music | MusicIcon | Music | LucideIcons.music |
| Artis | mic-vocal | MicVocalIcon | MicVocal | LucideIcons.micVocal |
| Tautan | link | LinkIcon | Link | LucideIcons.link |
| Salin | copy | CopyIcon | Copy | LucideIcons.copy |
| Tutup | x | XIcon | X | LucideIcons.x |
| Kembali | chevron-left | ChevronLeftIcon | ChevronLeft | LucideIcons.chevronLeft |
| Info | info | InfoIcon | Info | LucideIcons.info |
| Sukses | circle-check | CircleCheckIcon | CircleCheck | LucideIcons.circleCheck |
| Peringatan | triangle-alert | TriangleAlertIcon | TriangleAlert | LucideIcons.triangleAlert |
| Error | circle-alert | CircleAlertIcon | CircleAlert | LucideIcons.circleAlert |


---

# Spasi

> Skala spasi 4px untuk padding, jarak antarelemen, dan tata letak halaman.

Semua spasi berasal dari satu skala 4px, jadi padding dan jarak sejajar di semua produk.



| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| space-1 | `--space-1` | 4px | Jarak antara ikon dan labelnya. |
| space-2 | `--space-2` | 8px | Padding di dalam kontrol kecil; jarak antaritem yang terkait. |
| space-3 | `--space-3` | 12px | Jarak antarkolom form dalam satu baris. |
| space-4 | `--space-4` | 16px | Padding kartu di mobile; jarak antarkolom form. |
| space-5 | `--space-5` | 20px | Jarak tepi halaman di mobile. |
| space-6 | `--space-6` | 24px | Padding kartu di desktop. |
| space-8 | `--space-8` | 32px | Jarak antarbagian halaman. |
| space-10 | `--space-10` | 40px | Jarak antarbagian besar di dasbor. |
| space-12 | `--space-12` | 48px | Jarak atas header halaman. |
| space-16 | `--space-16` | 64px | Jarak di sekitar blok hero. |

Di Tailwind v4 satuan dasarnya `--spacing: 4px`, jadi `p-4` sama dengan 16px, sama dengan `space-4`.


---

# Radius

> Kelengkungan sudut untuk kontrol, kartu, dan dialog.

Sudut makin lembut seiring besarnya permukaan: kontrol paling rapat, dialog paling lembut.



| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| radius | `--radius` | 12px | Radius dasar shadcn; sama dengan radius-lg. |
| radius-sm | `--radius-sm` | 6px | Badge, checkbox, dan chip kecil. |
| radius-md | `--radius-md` | 8px | Input dan tombol. |
| radius-lg | `--radius-lg` | 12px | Kartu, termasuk kartu pencarian yang melayang. |
| radius-xl | `--radius-xl` | 16px | Dialog dan sheet. |
| radius-full | `--radius-full` | 9999px | Kontrol yang memang bulat: avatar, switch, radio, progress bar, lingkaran stepper, titik carousel, dan pegangan drawer. Tombol tidak pernah berbentuk pil, kecuali pemilih bahasa di header dasbor. |

- Input dan tombol: `radius-md`.
- Kartu, termasuk kartu header dasbor yang melayang: `radius-lg`.
- Dialog dan sheet: `radius-xl`.
- Tombol mengikuti radius input dan tidak pernah berbentuk pil. `radius-full` untuk kontrol yang memang bulat (avatar, switch, radio, progress, titik carousel) dan untuk pill bahasa di header dasbor.


---

# Elevasi

> Tiga tingkat bayangan; kartu dipisahkan oleh garis tepi lebih dulu.

Kartu dipisahkan oleh garis tepi lebih dulu. Bayangan menandai sesuatu yang melayang di atas halaman.



## Terang

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| elevation-sm | `--elevation-sm` | 0 1px 2px 0 #1018280D | Tab terpilih dan kontrol yang sedikit terangkat. |
| elevation-md | `--elevation-md` | 0 1px 2px 0 #1018280A, 0 12px 32px -8px #10182814 | Kartu yang melayang, misalnya kartu pencarian di dasbor. |
| elevation-lg | `--elevation-lg` | 0 12px 30px -6px #10182838 | Menu, popover, toast, dan dialog. |

## Gelap

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| elevation-sm | `--elevation-sm` | 0 1px 3px 0 #00000059 | Tab terpilih dan kontrol yang sedikit terangkat. |
| elevation-md | `--elevation-md` | 0 1px 3px 0 #00000059, 0 12px 32px -8px #00000080 | Kartu yang melayang, misalnya kartu pencarian di dasbor. |
| elevation-lg | `--elevation-lg` | 0 12px 32px -4px #000000CC | Menu, popover, toast, dan dialog. |

## Overlay

Dialog dan sheet meredupkan halaman di belakangnya dengan token `overlay`, lapisan tembus pandang yang lebih tipis di mode terang dan lebih pekat di mode gelap.

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| overlay | `--overlay` | #10182866 | Lapisan tembus pandang di belakang dialog dan sheet. |

| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| overlay | `--overlay` | #000000A3 | Lapisan tembus pandang di belakang dialog dan sheet. |

## Pemakaian

- Kartu header dasbor yang melayang memakai `elevation-md`.
- Menu, popover, toast, dan dialog memakai `elevation-lg`.
- Di Tailwind v4 ketiga tingkat ini menjadi `shadow-sm`, `shadow-md`, dan `shadow-lg`.


---

# Gerak

> Durasi, kurva easing, dan animasi hero login.

Gerak di antarmuka dibuat tenang, dan disimpan untuk satu momen yang dirancang khusus: hero login.



| Token | Variabel CSS | Nilai | Kegunaan |
| --- | --- | --- | --- |
| duration-fast | `--duration-fast` | 160ms | Respons hover dan tekan. |
| duration-base | `--duration-base` | 300ms | Fade, perubahan warna, dan kemunculan kecil. |
| duration-slow | `--duration-slow` | 700ms | Teks pembuka yang masuk di hero login. |
| duration-sheet | `--duration-sheet` | 1050ms | Lembar bab hero login yang naik dan turun. |
| duration-chapter | `--duration-chapter` | 7000ms | Lama setiap bab hero login tampil. |
| ease-standard | `--ease-standard` | cubic-bezier(0.22, 1, 0.36, 1) | Easing bawaan untuk elemen yang masuk. |
| ease-expo | `--ease-expo` | cubic-bezier(0.16, 1, 0.3, 1) | Kata yang naik dan ilustrasi yang masuk di hero login. |
| ease-in-out | `--ease-in-out` | cubic-bezier(0.76, 0, 0.24, 1) | Pergantian lembar antarbab hero login. |

## Hero login

Separuh kiri setiap layar login adalah momen brand yang berganti dari satu bab ke bab berikutnya.

- Setiap bab tampil selama `duration-chapter` (7 detik).
- Lembar bab baru naik selama `duration-sheet` (1050ms) dengan `ease-in-out`.
- Kata-kata judul naik satu per satu dalam 900ms dengan `ease-expo`, mulai di 420ms dengan jeda 40ms antarkata.
- Ilustrasi masuk ke posisinya dalam 1300ms dengan `ease-expo`.
- Progress bar menunjukkan bab yang sedang tampil, dan tombol jeda menghentikan pergantian.
- Pergantian berhenti saat hover, saat fokus keyboard, dan saat tab tidak terlihat.
- Dengan `prefers-reduced-motion: reduce`, bab berganti tanpa gerakan.
- Di bawah breakpoint `lg`, hero disembunyikan dan form mengisi layar.


---

# Komponen

> Komponen Sosialoka untuk React dan Vue, dipasang dari registry Sosialoka dengan CLI shadcn.

Komponen Sosialoka adalah komponen shadcn yang sudah membawa token, radius, dan warna status Sosialoka, untuk React dan Vue.

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.

## Siapkan proyek

Pasang tema produkmu dulu, lalu komponen yang kamu butuhkan. Langkah untuk React dan Vue ada di [Web](https://design.sosialoka.tech/id/web/#siapkan-proyek-shadcn); satu komponen dipasang seperti ini:

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

Untuk Flutter, siapkan paket `sosialoka_ui` di [Flutter](https://design.sosialoka.tech/id/flutter/) lalu salin kode dari tab Flutter di setiap komponen.

## Komponen

### Aksi

| Komponen | Untuk |
| --- | --- |
| [Button](https://design.sosialoka.tech/id/components/button/) | Menjalankan aksi. |
| [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/) | Beberapa aksi di balik satu tombol. |
| [Command](https://design.sosialoka.tech/id/components/command/) | Pencarian dari keyboard, dan kartu pencarian di header. |

### Formulir

| Komponen | Untuk |
| --- | --- |
| [Input](https://design.sosialoka.tech/id/components/input/) | Satu baris teks. |
| [Input Group](https://design.sosialoka.tech/id/components/input-group/) | Input dengan ikon, teks, atau tombol yang menempel, misalnya pencarian atau kata sandi. |
| [Textarea](https://design.sosialoka.tech/id/components/textarea/) | Teks beberapa baris. |
| [Label](https://design.sosialoka.tech/id/components/label/) | Memberi nama kontrol form. |
| [Field](https://design.sosialoka.tech/id/components/field/) | Label, hint, dan error dari backend di sekitar satu kontrol. |
| [Checkbox](https://design.sosialoka.tech/id/components/checkbox/) | Menyalakan atau mematikan satu pilihan. |
| [Radio Group](https://design.sosialoka.tech/id/components/radio-group/) | Memilih satu dari beberapa pilihan yang terlihat. |
| [Switch](https://design.sosialoka.tech/id/components/switch/) | Pengaturan yang langsung berlaku. |
| [Slider](https://design.sosialoka.tech/id/components/slider/) | Memilih nilai atau rentang di sebuah lintasan, misalnya potongan preview. |
| [Toggle Group](https://design.sosialoka.tech/id/components/toggle-group/) | Chip filter di atas daftar, misalnya status. |
| [Select](https://design.sosialoka.tech/id/components/select/) | Memilih satu nilai dari daftar pendek. |
| [Combobox](https://design.sosialoka.tech/id/components/combobox/) | Memilih dari daftar panjang dengan mengetik. |
| [Calendar](https://design.sosialoka.tech/id/components/calendar/) | Satu bulan untuk memilih hari, langsung di halaman. |
| [Date Picker](https://design.sosialoka.tech/id/components/date-picker/) | Kolom tanggal yang membuka kalender. |
| [Input OTP](https://design.sosialoka.tech/id/components/input-otp/) | Kode sekali pakai di enam kotak. |
| [File Upload](https://design.sosialoka.tech/id/components/file-upload/) | Menarik atau memilih file, dengan ukuran dan progresnya. |

### Tampilan

| Komponen | Untuk |
| --- | --- |
| [Badge](https://design.sosialoka.tech/id/components/badge/) | Menampilkan status atau label singkat. |
| [Alert](https://design.sosialoka.tech/id/components/alert/) | Pesan yang menetap di halaman, dengan warna status. |
| [Card](https://design.sosialoka.tech/id/components/card/) | Mengelompokkan isi di permukaannya sendiri. |
| [Carousel](https://design.sosialoka.tech/id/components/carousel/) | Deretan kartu yang bisa digeser, misalnya rilis terbaru. |
| [Item](https://design.sosialoka.tech/id/components/item/) | Baris daftar di HP dan di panel. |
| [Accordion](https://design.sosialoka.tech/id/components/accordion/) | Bagian yang terbuka satu per satu. |
| [Separator](https://design.sosialoka.tech/id/components/separator/) | Garis tipis di antara kelompok. |
| [Avatar](https://design.sosialoka.tech/id/components/avatar/) | Orang atau artis sebagai foto atau inisial. |
| [Timeline](https://design.sosialoka.tech/id/components/timeline/) | Apa saja yang terjadi pada sebuah data, terbaru di atas. |

### Navigasi

| Komponen | Untuk |
| --- | --- |
| [Tabs](https://design.sosialoka.tech/id/components/tabs/) | Berpindah antartampilan dari isi yang sama. |
| [Breadcrumb](https://design.sosialoka.tech/id/components/breadcrumb/) | Jalur kembali dari halaman yang dalam. |
| [Stepper](https://design.sosialoka.tech/id/components/stepper/) | Langkah-langkah alur dan posisimu. |
| [Sidebar](https://design.sosialoka.tech/id/components/sidebar/) | Navigasi utama dasbor. |

### Data

| Komponen | Untuk |
| --- | --- |
| [Table](https://design.sosialoka.tech/id/components/table/) | Data dalam baris dan kolom, dengan paginasi. |
| [Chart](https://design.sosialoka.tech/id/components/chart/) | Angka dari waktu ke waktu atau antarkategori, dengan tabel berisi angka yang sama. |

### Lapisan

| Komponen | Untuk |
| --- | --- |
| [Dialog](https://design.sosialoka.tech/id/components/dialog/) | Keputusan atau form singkat di atas halaman. |
| [Alert Dialog](https://design.sosialoka.tech/id/components/alert-dialog/) | Memastikan aksi yang tidak bisa dibatalkan. |
| [Sheet](https://design.sosialoka.tech/id/components/sheet/) | Filter atau detail di panel dari tepi layar. |
| [Drawer](https://design.sosialoka.tech/id/components/drawer/) | Bottom sheet di HP. |
| [Popover](https://design.sosialoka.tech/id/components/popover/) | Konten tambahan atau tugas singkat di samping pemicunya. |
| [Tooltip](https://design.sosialoka.tech/id/components/tooltip/) | Memberi nama kontrol berisi ikon saja. |

### Umpan balik

| Komponen | Untuk |
| --- | --- |
| [Toast](https://design.sosialoka.tech/id/components/toast/) | Memberi tahu aksi yang berhasil. |
| [Progress](https://design.sosialoka.tech/id/components/progress/) | Kemajuan unggahan atau impor. |
| [Spinner](https://design.sosialoka.tech/id/components/spinner/) | Tunggu sebentar, atau tombol yang sedang menyimpan. |
| [Skeleton](https://design.sosialoka.tech/id/components/skeleton/) | Placeholder selama konten dimuat. |

## Item pendukung

Beberapa komponen ikut memasang item Sosialoka yang lebih kecil: `toggle` ikut bersama Toggle Group, `pagination` bersama Table, `native-select` bersama Calendar Vue (untuk pemilih bulan dan tahunnya), dan komponen React memakai hook `use-mobile`. Semuanya mengikuti token yang sama, jadi bisa juga dipakai sendiri.


---

# Button

> Menjalankan aksi, misalnya menyimpan form atau membuka dialog.

Tombol menjalankan aksi di halaman yang sedang dibuka. Kalau aksinya membawa orang ke halaman lain, pakai link.

## Kapan dipakai

- Pakai satu tombol `default` untuk aksi utama di form, kartu, atau dialog.
- Pakai `secondary` atau `outline` untuk aksi lain di sebelahnya.
- Pakai `ghost` di toolbar dan baris yang padat, dan `link` di dalam kalimat.
- Pakai `destructive` hanya untuk aksi yang menghapus atau membatalkan.
- Jangan pakai tombol untuk pindah halaman; pakai link.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/button/_

### Lakukan dan jangan

- **Lakukan:** Pakai satu tombol default untuk aksi utama; aksi lain outline atau secondary.
- **Jangan:** Jangan beri dua aksi bobot yang sama; orang tidak tahu mana yang melanjutkan.

## Anatomi

1. Wadah, dengan radius kontrol
2. Label
3. Varian outline untuk aksi kedua

Tombol berisi label, dengan ikon opsional di depan atau di belakangnya. Sudutnya memakai radius kontrol (`radius-md`, 8px) dan tidak pernah berbentuk pil.

## Varian

| Varian | Tampilan | Dipakai untuk |
| --- | --- | --- |
| `default` | Isi `primary`, teks `primary-foreground` | Aksi utama. Satu per area. |
| `secondary` | Isi `secondary` | Aksi kedua yang lebih ringan. |
| `outline` | Garis `border` di atas `background` | Aksi netral di samping aksi utama. |
| `ghost` | Tanpa isi sampai di-hover | Toolbar, baris tabel, tombol ikon. |
| `destructive` | Teks `destructive` di atas isi destructive yang lembut | Hapus, tolak, atau batalkan. |
| `link` | Teks `primary`, bergaris bawah saat di-hover | Aksi di dalam kalimat. |

Ukuran: `xs`, `sm`, `default`, `lg`, serta `icon`, `icon-xs`, `icon-sm`, `icon-lg` yang persegi untuk tombol berisi ikon saja.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | named constructor (`ShadButton.outline`) | lihat Varian | `default` | Bobot visual. |
| `size` | `size` | `size` (`ShadButtonSize`) | lihat Varian | `default` | Tinggi dan padding. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mematikan aksi. |
| `onClick` | `@click` | `onPressed` | function | tidak ada | Menjalankan aksi. |

## Kode

**React**
```tsx
import { Button } from "@/components/ui/button"

export default function ButtonDemo() {
  return (
    <div className="flex flex-wrap items-center gap-2">
      <Button>Simpan</Button>
      <Button variant="secondary">Simpan draf</Button>
      <Button variant="outline">Lihat detail</Button>
      <Button variant="ghost">Batal</Button>
      <Button variant="destructive">Hapus</Button>
      <Button variant="link">Pelajari lebih lanjut</Button>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Button } from "@/components/ui/button"
</script>

<template>
  <div class="flex flex-wrap items-center gap-2">
    <Button>Simpan</Button>
    <Button variant="secondary">Simpan draf</Button>
    <Button variant="outline">Lihat detail</Button>
    <Button variant="ghost">Batal</Button>
    <Button variant="destructive">Hapus</Button>
    <Button variant="link">Pelajari lebih lanjut</Button>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class ButtonDemo extends StatelessWidget {
  const ButtonDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return Wrap(
      spacing: 8,
      runSpacing: 8,
      children: [
        ShadButton(onPressed: () {}, child: const Text('Simpan')),
        ShadButton.secondary(onPressed: () {}, child: const Text('Simpan draf')),
        ShadButton.outline(onPressed: () {}, child: const Text('Lihat detail')),
        ShadButton.ghost(onPressed: () {}, child: const Text('Batal')),
        ShadButton.destructive(onPressed: () {}, child: const Text('Hapus')),
        ShadButton.link(onPressed: () {}, child: const Text('Pelajari lebih lanjut')),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/button.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/button.json
```

## Aksesibilitas

- Dirender sebagai `button` asli, jadi bisa ditekan dengan Enter dan Spasi.
- Setiap tombol berisi ikon saja wajib punya `aria-label`.
- Cincin fokus memakai `ring` dan hanya muncul saat fokus keyboard.
- Label cukup menyebut aksinya: "Simpan", bukan "Klik di sini".


---

# Input

> Kolom teks satu baris.

Input menerima satu baris teks, misalnya nama, alamat email, atau kata pencarian.

## Kapan dipakai

- Pakai untuk teks bebas yang pendek.
- Pakai [Select](https://design.sosialoka.tech/id/components/select/) kalau jawabannya dipilih dari daftar pendek.
- Selalu pasangkan dengan [Label](https://design.sosialoka.tech/id/components/label/). Placeholder bukan label.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/input/_

### Lakukan dan jangan

- **Lakukan:** Taruh label di atas kolom, supaya tetap terlihat saat orang mengetik.
- **Jangan:** Jangan pakai placeholder sebagai label; teksnya hilang begitu orang mengetik.

## Anatomi

1. Label di atas kolom
2. Kolom dengan garis input
3. Nilai
4. Kursor

Label di atas kolom, kolomnya sendiri, lalu hint opsional di bawahnya. Kolom memakai `input` untuk garis tepi, `radius-md` untuk sudut, dan `ring` untuk fokus.

## Varian

Hanya ada satu gaya. Kolom yang tidak valid memasang `aria-invalid`, sehingga garis tepi dan cincin fokusnya berubah `destructive`.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` / `defaultValue` | `v-model` / `default-value` | `controller` / `initialValue` | string | tidak ada | Isi teks. |
| `type` | `type` | `keyboardType` | string | `text` | Petunjuk keyboard dan validasi. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mematikan pengetikan. |
| `aria-invalid` | `aria-invalid` | `validator` | boolean | `false` | Menandai nilai yang salah. |

## Kode

**React**
```tsx
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

export default function InputDemo() {
  return (
    <div className="grid w-full max-w-sm gap-2">
      <Label htmlFor="input-demo-email">Email</Label>
      <Input id="input-demo-email" type="email" aria-describedby="input-demo-hint" />
      <p id="input-demo-hint" className="text-sm text-muted-foreground">
        Ke sini kami kirim kabar penting untukmu.
      </p>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
</script>

<template>
  <div class="grid w-full max-w-sm gap-2">
    <Label for="input-demo-email-vue">Email</Label>
    <Input id="input-demo-email-vue" type="email" aria-describedby="input-demo-hint-vue" />
    <p id="input-demo-hint-vue" class="text-sm text-muted-foreground">
      Ke sini kami kirim kabar penting untukmu.
    </p>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class InputDemo extends StatelessWidget {
  const InputDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: ShadInputFormField(
        id: 'email',
        label: const Text('Email'),
        keyboardType: TextInputType.emailAddress,
        description: const Text('Ke sini kami kirim kabar penting untukmu.'),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/input.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/input.json
```

## Aksesibilitas

- Hubungkan label dengan `htmlFor` (React) atau `for` (Vue) ke `id` kolom.
- Hubungkan hint dengan `aria-describedby` supaya dibacakan screen reader.
- Pesan error datang dari backend. Tampilkan di bawah kolom dan pasang `aria-invalid`.


---

# Input Group

> Input dengan tombol, ikon, atau teks yang menempel.

Input Group menempelkan ikon, teks, atau tombol kecil ke sebuah input, di dalam satu border.

## Kapan dipakai

- **Pencarian:** ikon cari di depan input.
- **Kata sandi:** tombol di belakang input untuk menampilkan atau menyembunyikan kata sandi. Inilah kolom kata sandi Sosialoka; tidak ada komponen kata sandi tersendiri.
- **Satuan dan awalan:** teks seperti `Rp` atau `.id` sebelum atau sesudah nilai.
- Jangan taruh aksi utama form di dalam grup; tempatnya di footer form.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/input-group/_

## Anatomi

1. Ikon di depan
2. Input
3. Tombol yang menempel

1. **Grup** (`InputGroup`): satu border `input` dengan `radius-md`, tinggi `h-9`. Fokus pada input memberi ring ke seluruh grup.
2. **Addon** (`InputGroupAddon`): ikon, teks, atau tombol, di `inline-start` (depan) atau `inline-end` (belakang).
3. **Kontrol** (`InputGroupInput` atau `InputGroupTextarea`): kolomnya sendiri, tanpa border sendiri.

## Varian

| Posisi addon | Pakai untuk |
| --- | --- |
| `inline-start` | Ikon cari, mata uang seperti `Rp`. |
| `inline-end` | Tombol tampilkan kata sandi, satuan, tombol hapus. |
| `block-start` / `block-end` | Label atau aksi di atas atau di bawah `InputGroupTextarea`. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `InputGroupAddon align` | `InputGroupAddon align` | `leading` / `trailing` di `ShadInput` | `inline-start`, `inline-end`, `block-start`, `block-end` | `inline-start` | Posisi addon. |
| `InputGroupButton size` | `InputGroupButton size` | `ShadIconButton` di `trailing` | `xs`, `sm`, `icon-xs`, `icon-sm` | `xs` | Tombol kecil di dalam grup. |
| `type` di `InputGroupInput` | `type` di `InputGroupInput` | `obscureText` | teks | `text` | `password` menyembunyikan teks; `search` membuat kolom cari. |

## Kode

**React**
```tsx
import { useId, useState } from "react"
import { EyeIcon, EyeOffIcon, SearchIcon } from "lucide-react"
import { Field, FieldLabel } from "@/components/ui/field"
import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@/components/ui/input-group"

export default function InputGroupDemo() {
  const id = useId()
  const [visible, setVisible] = useState(false)
  return (
    <div className="grid w-full max-w-sm gap-6">
      <InputGroup>
        <InputGroupAddon>
          <SearchIcon />
        </InputGroupAddon>
        <InputGroupInput type="search" placeholder="Cari rilis" aria-label="Cari rilis" />
      </InputGroup>
      <Field>
        <FieldLabel htmlFor={`${id}-password`}>Kata sandi</FieldLabel>
        <InputGroup>
          <InputGroupInput id={`${id}-password`} type={visible ? "text" : "password"} autoComplete="current-password" />
          <InputGroupAddon align="inline-end">
            <InputGroupButton
              size="icon-xs"
              aria-label={visible ? "Sembunyikan kata sandi" : "Tampilkan kata sandi"}
              aria-pressed={visible}
              onClick={() => setVisible((v) => !v)}
            >
              {visible ? <EyeOffIcon /> : <EyeIcon />}
            </InputGroupButton>
          </InputGroupAddon>
        </InputGroup>
      </Field>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref, useId } from "vue"
import { EyeIcon, EyeOffIcon, SearchIcon } from "@lucide/vue"
import { Field, FieldLabel } from "@/components/ui/field"
import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@/components/ui/input-group"

const id = useId()
const visible = ref(false)
</script>

<template>
  <div class="grid w-full max-w-sm gap-6">
    <InputGroup>
      <InputGroupAddon>
        <SearchIcon />
      </InputGroupAddon>
      <InputGroupInput type="search" placeholder="Cari rilis" aria-label="Cari rilis" />
    </InputGroup>
    <Field>
      <FieldLabel :for="`${id}-password`">Kata sandi</FieldLabel>
      <InputGroup>
        <InputGroupInput :id="`${id}-password`" :type="visible ? 'text' : 'password'" autocomplete="current-password" />
        <InputGroupAddon align="inline-end">
          <InputGroupButton
            size="icon-xs"
            :aria-label="visible ? 'Sembunyikan kata sandi' : 'Tampilkan kata sandi'"
            :aria-pressed="visible"
            @click="visible = !visible"
          >
            <EyeOffIcon v-if="visible" />
            <EyeIcon v-else />
          </InputGroupButton>
        </InputGroupAddon>
      </InputGroup>
    </Field>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class InputGroupDemo extends StatefulWidget {
  const InputGroupDemo({super.key});

  @override
  State<InputGroupDemo> createState() => _InputGroupDemoState();
}

class _InputGroupDemoState extends State<InputGroupDemo> {
  bool visible = false;

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        spacing: 24,
        children: [
          const ShadInput(
            placeholder: Text('Cari rilis'),
            leading: Icon(LucideIcons.search, size: 16),
          ),
          ShadInputFormField(
            id: 'password',
            label: const Text('Kata sandi'),
            obscureText: !visible,
            trailing: Semantics(
              label: visible ? 'Sembunyikan kata sandi' : 'Tampilkan kata sandi',
              toggled: visible,
              child: ShadIconButton.ghost(
                width: 24,
                height: 24,
                icon: Icon(visible ? LucideIcons.eyeOff : LucideIcons.eye, size: 16),
                onPressed: () => setState(() => visible = !visible),
              ),
            ),
          ),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/input-group.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/input-group.json
```

## Aksesibilitas

- Input tetap punya label sendiri: label yang terlihat di dalam Field, atau `aria-label` seperti "Cari rilis" untuk kolom cari yang hanya berikon.
- Tombol tampilkan kata sandi menyebut fungsinya: `aria-label` "Tampilkan kata sandi" / "Sembunyikan kata sandi", dengan `aria-pressed` selama kata sandi terlihat.
- Ikon di addon bersifat dekoratif dan tidak perlu label.


---

# Textarea

> Kolom teks beberapa baris.

Textarea menerima teks yang lebih dari satu baris, misalnya catatan atau deskripsi, dan tingginya ikut bertambah sesuai isi.

## Kapan dipakai

- Pakai untuk catatan, deskripsi, dan pesan.
- Pakai Input untuk satu baris, misalnya nama atau judul.
- Taruh di dalam Field, dengan hint yang menyebut batasnya, misalnya "Paling banyak 500 karakter."

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/textarea/_

## Anatomi

1. Label
2. Kolom yang tumbuh mengikuti teks
3. Pegangan ubah ukuran

Kotak dengan `radius-md` dan border `input`, tinggi minimal `min-h-16`, yang memanjang sesuai isi (`field-sizing-content`). Saat fokus muncul `ring`; nilai yang tidak valid membuat bordernya `destructive`.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` / `defaultValue` | `v-model` / `default-value` | `controller` / `initialValue` | teks | tidak ada | Isi teks. |
| `maxLength` | `maxlength` | `maxLength` | angka | tidak ada | Panjang maksimal. Sebutkan juga di hint. |
| `rows` | `rows` | `minHeight` | angka | ikut isi | Tinggi awal. |
| `aria-invalid` | `aria-invalid` | `forceErrorText` di `ShadTextareaFormField` | boolean | `false` | Menandai nilai yang ditolak. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mencegah pengetikan. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Field, FieldDescription, FieldLabel } from "@/components/ui/field"
import { Textarea } from "@/components/ui/textarea"

export default function TextareaDemo() {
  const id = useId()
  return (
    <Field className="w-full max-w-sm">
      <FieldLabel htmlFor={`${id}-notes`}>Catatan untuk tim</FieldLabel>
      <Textarea id={`${id}-notes`} maxLength={500} aria-describedby={`${id}-notes-hint`} />
      <FieldDescription id={`${id}-notes-hint`}>Paling banyak 500 karakter.</FieldDescription>
    </Field>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Field, FieldDescription, FieldLabel } from "@/components/ui/field"
import { Textarea } from "@/components/ui/textarea"

const id = useId()
</script>

<template>
  <Field class="w-full max-w-sm">
    <FieldLabel :for="`${id}-notes`">Catatan untuk tim</FieldLabel>
    <Textarea :id="`${id}-notes`" :maxlength="500" :aria-describedby="`${id}-notes-hint`" />
    <FieldDescription :id="`${id}-notes-hint`">Paling banyak 500 karakter.</FieldDescription>
  </Field>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class TextareaDemo extends StatelessWidget {
  const TextareaDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    // ShadTextareaFormField does not pass maxLength on, so the label and hint sit around a ShadTextarea.
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.start,
        spacing: 8,
        children: [
          Text('Catatan untuk tim', style: theme.textTheme.small),
          const ShadTextarea(maxLength: 500),
          Text('Paling banyak 500 karakter.', style: theme.textTheme.muted),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/textarea.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/textarea.json
```

## Aksesibilitas

- Beri label yang terlihat di dalam Field.
- Hubungkan hint dan error ke textarea lewat `aria-describedby`.
- Perilaku keyboard `textarea` bawaan tetap: Enter menambah baris, Tab berpindah ke kontrol berikutnya.


---

# Label

> Memberi nama kontrol form dan memfokuskannya saat diklik.

Label memberi nama kontrol form, dan mengekliknya memindahkan fokus ke kontrol itu.

## Kapan dipakai

- Beri label yang terlihat di setiap input, select, dan checkbox.
- Taruh label di atas input dan select, dan di samping checkbox.
- Buat label singkat. Taruh panduan di hint di bawah kolom.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/label/_

## Anatomi

1. Teks label
2. Tanda wajib
3. Kontrol yang dinamainya

Satu baris teks `text-sm` medium berwarna `foreground`. Kontrol yang dimatikan ikut meredupkan labelnya.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `htmlFor` | `for` | `label` di form field | string | tidak ada | `id` kontrol yang diberi nama. |

## Kode

**React**
```tsx
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

export default function LabelDemo() {
  return (
    <div className="grid w-full max-w-sm gap-2">
      <Label htmlFor="label-demo-name">Nama lengkap</Label>
      <Input id="label-demo-name" />
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
</script>

<template>
  <div class="grid w-full max-w-sm gap-2">
    <Label for="label-demo-name-vue">Nama lengkap</Label>
    <Input id="label-demo-name-vue" />
  </div>
</template>
```

**Flutter**
```dart
// Flutter has no separate label widget: form fields take a `label`.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class LabelDemo extends StatelessWidget {
  const LabelDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: ShadInputFormField(
        id: 'name',
        label: const Text('Nama lengkap'),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/label.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/label.json
```

## Aksesibilitas

- Dirender sebagai `label` asli, jadi mengekliknya memfokuskan kontrol.
- Flutter tidak punya widget label terpisah. Isi `label` di form field.


---

# Field

> Membungkus satu kontrol form dengan label, hint, dan pesan error.

Field menaruh label di atas kontrol form, hint satu kalimat di bawahnya, dan pesan error dari backend saat nilainya ditolak.

## Kapan dipakai

- Bungkus setiap kontrol form yang diisi orang: Input, Textarea, Select, Combobox, Input OTP.
- Pakai `FieldSet` dengan `FieldLegend` untuk mengelompokkan kontrol yang menjawab satu pertanyaan, misalnya Radio Group.
- Pakai orientasi `horizontal` hanya untuk Switch atau Checkbox, dengan kontrol di depan labelnya.
- Jangan tulis pesan error di klien. Backend memeriksa setiap field dan mengirim pesannya; klien hanya menonaktifkan tombol kirim sampai field wajib terisi.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/field/_

## Anatomi

1. Label
2. Kontrol, garis merah saat tidak valid
3. Petunjuk
4. Pesan error dari backend

1. **Label** (`FieldLabel`): di atas kontrol, warna `foreground`. Berubah `destructive` saat field tidak valid.
2. **Kontrol**: input, textarea, atau kontrol lain, dengan `aria-invalid` selama nilainya ditolak.
3. **Hint** (`FieldDescription`): satu kalimat praktis berwarna `muted-foreground`.
4. **Error** (`FieldError`): pesan dari backend berwarna `destructive`, dengan `role="alert"`.

Hubungkan kontrol ke hint dan error lewat `aria-describedby`, supaya pembaca layar membacakan keduanya. Field tidak menambahkan id-nya otomatis.

## Varian

| Orientasi | Pakai untuk |
| --- | --- |
| `vertical` (bawaan) | Semua kontrol teks: label di atas, hint dan error di bawah. |
| `horizontal` | Switch atau Checkbox: kontrol di kiri, label dan hint di kanan. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `orientation` di `Field` | `orientation` di `Field` | widget terpisah (`ShadSwitch` punya `label` sendiri) | `vertical` / `horizontal` | `vertical` | Menaruh label di atas atau di samping kontrol. |
| `data-invalid` di `Field` | `data-invalid="true"` di `Field` (`data-invalid` tanpa nilai dirender kosong dan tidak cocok) | `forceErrorText` | boolean / teks | tidak ada | Menandai field yang ditolak. |
| `FieldLabel htmlFor` | `FieldLabel for` | `label` | teks | tidak ada | Nama kontrol. |
| `FieldDescription` | `FieldDescription` | `description` | teks | tidak ada | Hint satu kalimat. |
| `FieldError` | `FieldError` | `forceErrorText` | teks | tidak ada | Pesan error dari backend. |
| `FieldSet`, `FieldLegend` | `FieldSet`, `FieldLegend` | judul `Text` di atas kelompok | tidak ada | tidak ada | Mengelompokkan kontrol yang menjawab satu pertanyaan. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Field, FieldDescription, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"
import { Textarea } from "@/components/ui/textarea"

export default function FieldDemo() {
  const id = useId()
  return (
    <FieldGroup className="w-full max-w-sm">
      {/* The error comes from the backend; the client only shows it. */}
      <Field data-invalid>
        <FieldLabel htmlFor={`${id}-title`}>Judul lagu</FieldLabel>
        <Input
          id={`${id}-title`}
          aria-invalid
          aria-describedby={`${id}-title-hint ${id}-title-error`}
        />
        <FieldDescription id={`${id}-title-hint`}>Tulis sesuai sampul rilis.</FieldDescription>
        <FieldError id={`${id}-title-error`}>Judul lagunya belum diisi.</FieldError>
      </Field>
      <Field>
        <FieldLabel htmlFor={`${id}-notes`}>Catatan</FieldLabel>
        <Textarea id={`${id}-notes`} aria-describedby={`${id}-notes-hint`} />
        <FieldDescription id={`${id}-notes-hint`}>Opsional, untuk tim rilis.</FieldDescription>
      </Field>
    </FieldGroup>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Field, FieldDescription, FieldError, FieldGroup, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"
import { Textarea } from "@/components/ui/textarea"

const id = useId()
</script>

<template>
  <FieldGroup class="w-full max-w-sm">
    <!-- The error comes from the backend; the client only shows it. -->
    <Field data-invalid="true">
      <FieldLabel :for="`${id}-title`">Judul lagu</FieldLabel>
      <Input :id="`${id}-title`" aria-invalid="true" :aria-describedby="`${id}-title-hint ${id}-title-error`" />
      <FieldDescription :id="`${id}-title-hint`">Tulis sesuai sampul rilis.</FieldDescription>
      <FieldError :id="`${id}-title-error`">Judul lagunya belum diisi.</FieldError>
    </Field>
    <Field>
      <FieldLabel :for="`${id}-notes`">Catatan</FieldLabel>
      <Textarea :id="`${id}-notes`" :aria-describedby="`${id}-notes-hint`" />
      <FieldDescription :id="`${id}-notes-hint`">Opsional, untuk tim rilis.</FieldDescription>
    </Field>
  </FieldGroup>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class FieldDemo extends StatelessWidget {
  const FieldDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        spacing: 24,
        children: [
          // The error comes from the backend; the field only shows it.
          ShadInputFormField(
            id: 'title',
            label: const Text('Judul lagu'),
            description: const Text('Tulis sesuai sampul rilis.'),
            forceErrorText: 'Judul lagunya belum diisi.',
          ),
          ShadTextareaFormField(
            id: 'notes',
            label: const Text('Catatan'),
            description: const Text('Opsional, untuk tim rilis.'),
          ),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/field.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/field.json
```

## Aksesibilitas

- Setiap kontrol punya label yang terlihat dan terhubung lewat `htmlFor` / `for`.
- Kontrol yang tidak valid punya `aria-invalid="true"` dan `aria-describedby` berisi id hint dan id error.
- Error punya `role="alert"`, jadi langsung dibacakan saat muncul.
- `FieldSet` diberi nama oleh `FieldLegend`-nya.


---

# Checkbox

> Menyalakan atau mematikan satu pilihan.

Checkbox menyalakan atau mematikan satu pilihan, atau memilih beberapa pilihan dari daftar.

## Kapan dipakai

- Pakai untuk persetujuan dan untuk memilih beberapa item.
- Pakai radio group atau [Select](https://design.sosialoka.tech/id/components/select/) kalau hanya boleh satu pilihan.
- Jangan pakai untuk pengaturan yang langsung berlaku; pakai switch.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/checkbox/_

## Anatomi

1. Kotak tercentang di primary
2. Kotak belum dicentang
3. Label, ikut bisa diklik

Kotak 16px dengan `radius-sm` (6px) dan ikon centang, dengan label di sampingnya. Kotak yang dicentang terisi `primary`.

## Varian

Hanya ada satu gaya. Checkbox bisa tercentang, tidak tercentang, atau sebagian (indeterminate).

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `checked` / `defaultChecked` | `v-model` / `default-value` | `value` | boolean | `false` | Status. |
| `onCheckedChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat status berubah. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mematikan perubahan. |
| `id` | `id` | `label` | string | tidak ada | Menghubungkan label. |

## Kode

**React**
```tsx
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"

export default function CheckboxDemo() {
  return (
    <div className="flex items-center gap-2">
      <Checkbox id="checkbox-demo-terms" />
      <Label htmlFor="checkbox-demo-terms">Saya setuju dengan syarat penggunaan</Label>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"
</script>

<template>
  <div class="flex items-center gap-2">
    <Checkbox id="checkbox-demo-terms-vue" />
    <Label for="checkbox-demo-terms-vue">Saya setuju dengan syarat penggunaan</Label>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class CheckboxDemo extends StatefulWidget {
  const CheckboxDemo({super.key});

  @override
  State<CheckboxDemo> createState() => _CheckboxDemoState();
}

class _CheckboxDemoState extends State<CheckboxDemo> {
  bool agreed = false;

  @override
  Widget build(BuildContext context) {
    return ShadCheckbox(
      value: agreed,
      onChanged: (value) => setState(() => agreed = value),
      label: const Text('Saya setuju dengan syarat penggunaan'),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/checkbox.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/checkbox.json
```

## Aksesibilitas

- Dirender dengan `role="checkbox"` dan `aria-checked`. Spasi mengubah statusnya.
- Setiap checkbox wajib punya label yang terhubung lewat `id`.


---

# Radio Group

> Memilih satu dari beberapa pilihan yang semuanya terlihat.

Radio Group menampilkan dua sampai lima pilihan sekaligus dan membiarkan orang memilih tepat satu.

## Kapan dipakai

- Pakai untuk 2 sampai 5 pilihan yang perlu dibandingkan sebelum memilih, misalnya jenis rilis.
- Pakai [Select](https://design.sosialoka.tech/id/components/select/) untuk pilihan yang lebih banyak, dan [Switch](https://design.sosialoka.tech/id/components/switch/) atau [Checkbox](https://design.sosialoka.tech/id/components/checkbox/) untuk satu pengaturan ya atau tidak.
- Selalu pilihkan nilai bawaan yang masuk akal.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/radio-group/_

## Anatomi

1. Pilihan
2. Pilihan terpilih
3. Label

`FieldSet` dengan `FieldLegend` yang berisi pertanyaannya, dan satu baris per pilihan: item bulat berborder `input` yang terisi `primary` saat dipilih, labelnya, dan deskripsi satu kalimat bila perlu.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` / `defaultValue` | `v-model` / `default-value` | `initialValue` | teks | tidak ada | Pilihan terpilih. |
| `onValueChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat pilihan berubah. |
| `RadioGroupItem value` | `RadioGroupItem value` | `ShadRadio value` | teks | tidak ada | Satu pilihan. |
| label di `FieldLabel` | label di `FieldLabel` | `label`, `sublabel` | teks | tidak ada | Nama pilihan. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Menonaktifkan grup atau satu item. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Field, FieldContent, FieldDescription, FieldLabel, FieldLegend, FieldSet } from "@/components/ui/field"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const types = [
  { value: "single", label: "Single", hint: "Satu sampai tiga lagu." },
  { value: "ep", label: "EP", hint: "Empat sampai enam lagu." },
  { value: "album", label: "Album", hint: "Tujuh lagu atau lebih." },
]

export default function RadioGroupDemo() {
  const id = useId()
  return (
    <FieldSet className="w-full max-w-sm">
      <FieldLegend id={`${id}-legend`}>Jenis rilis</FieldLegend>
      <RadioGroup defaultValue="single" aria-labelledby={`${id}-legend`}>
        {types.map((t) => (
          <Field key={t.value} orientation="horizontal">
            <RadioGroupItem value={t.value} id={`${id}-${t.value}`} aria-describedby={`${id}-${t.value}-hint`} />
            <FieldContent>
              <FieldLabel htmlFor={`${id}-${t.value}`}>{t.label}</FieldLabel>
              <FieldDescription id={`${id}-${t.value}-hint`}>{t.hint}</FieldDescription>
            </FieldContent>
          </Field>
        ))}
      </RadioGroup>
    </FieldSet>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Field, FieldContent, FieldDescription, FieldLabel, FieldLegend, FieldSet } from "@/components/ui/field"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const types = [
  { value: "single", label: "Single", hint: "Satu sampai tiga lagu." },
  { value: "ep", label: "EP", hint: "Empat sampai enam lagu." },
  { value: "album", label: "Album", hint: "Tujuh lagu atau lebih." },
]
const id = useId()
</script>

<template>
  <FieldSet class="w-full max-w-sm">
    <FieldLegend :id="`${id}-legend`">Jenis rilis</FieldLegend>
    <RadioGroup default-value="single" :aria-labelledby="`${id}-legend`">
      <Field v-for="t in types" :key="t.value" orientation="horizontal">
        <RadioGroupItem :id="`${id}-${t.value}`" :value="t.value" :aria-describedby="`${id}-${t.value}-hint`" />
        <FieldContent>
          <FieldLabel :for="`${id}-${t.value}`">{{ t.label }}</FieldLabel>
          <FieldDescription :id="`${id}-${t.value}-hint`">{{ t.hint }}</FieldDescription>
        </FieldContent>
      </Field>
    </RadioGroup>
  </FieldSet>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const releaseTypes = {
  'single': ('Single', 'Satu sampai tiga lagu.'),
  'ep': ('EP', 'Empat sampai enam lagu.'),
  'album': ('Album', 'Tujuh lagu atau lebih.'),
};

class RadioGroupDemo extends StatelessWidget {
  const RadioGroupDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return Semantics(
      label: 'Jenis rilis',
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.start,
        spacing: 12,
        children: [
          Text('Jenis rilis', style: ShadTheme.of(context).textTheme.small),
          ShadRadioGroup<String>(
            initialValue: 'single',
            items: [
              for (final MapEntry(key: value, value: (label, hint)) in releaseTypes.entries)
                ShadRadio(value: value, label: Text(label), sublabel: Text(hint)),
            ],
          ),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/radio-group.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/radio-group.json
```

## Aksesibilitas

- Grup punya `role="radiogroup"` yang dinamai legendanya; setiap pilihan punya `role="radio"`.
- Tab masuk ke grup pada pilihan yang terpilih; tombol panah memindahkan pilihan.
- Hubungkan setiap deskripsi ke pilihannya lewat `aria-describedby`.


---

# Switch

> Menyalakan atau mematikan pengaturan saat itu juga.

Switch menyalakan atau mematikan satu pengaturan, dan perubahannya langsung berlaku tanpa tombol simpan.

## Kapan dipakai

- Pakai untuk pengaturan yang langsung berlaku, misalnya notifikasi email.
- Pakai [Checkbox](https://design.sosialoka.tech/id/components/checkbox/) untuk pilihan yang disimpan bersama form, atau untuk persetujuan syarat.
- Tulis labelnya sebagai pengaturan, bukan pertanyaan: "Kirim notifikasi email".

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/switch/_

### Lakukan dan jangan

- **Lakukan:** Pakai switch untuk pengaturan yang langsung berlaku saat diubah.
- **Jangan:** Jangan taruh switch di form yang menunggu tombol simpan; pakai checkbox di sana.

## Anatomi

1. Track, primary saat aktif
2. Thumb
3. Label
4. Kondisi mati

Track berbentuk pil yang berwarna `input` saat mati dan `primary` saat menyala, dengan thumb `background`. Letaknya di depan label dan deskripsi satu kalimat, di dalam Field berorientasi `horizontal`.

## Varian

Dua ukuran: `default` dan `sm`.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `checked` / `defaultChecked` | `v-model` / `default-value` | `value` | boolean | `false` | Menyala atau mati. |
| `onCheckedChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat berubah. |
| `size` | `size` | `width` / `height` | `default`, `sm` | `default` | Ukuran. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mencegah perubahan. |
| label di `FieldLabel` | label di `FieldLabel` | `label`, `sublabel` | teks | tidak ada | Nama pengaturan. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Field, FieldContent, FieldDescription, FieldLabel } from "@/components/ui/field"
import { Switch } from "@/components/ui/switch"

export default function SwitchDemo() {
  const id = useId()
  return (
    <Field orientation="horizontal" className="w-full max-w-sm">
      <Switch id={`${id}-email`} aria-describedby={`${id}-email-hint`} />
      <FieldContent>
        <FieldLabel htmlFor={`${id}-email`}>Kirim notifikasi email</FieldLabel>
        <FieldDescription id={`${id}-email-hint`}>Kabar rilis dan royalti masuk ke inbox kamu.</FieldDescription>
      </FieldContent>
    </Field>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Field, FieldContent, FieldDescription, FieldLabel } from "@/components/ui/field"
import { Switch } from "@/components/ui/switch"

const id = useId()
</script>

<template>
  <Field orientation="horizontal" class="w-full max-w-sm">
    <Switch :id="`${id}-email`" :aria-describedby="`${id}-email-hint`" />
    <FieldContent>
      <FieldLabel :for="`${id}-email`">Kirim notifikasi email</FieldLabel>
      <FieldDescription :id="`${id}-email-hint`">Kabar rilis dan royalti masuk ke inbox kamu.</FieldDescription>
    </FieldContent>
  </Field>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class SwitchDemo extends StatefulWidget {
  const SwitchDemo({super.key});

  @override
  State<SwitchDemo> createState() => _SwitchDemoState();
}

class _SwitchDemoState extends State<SwitchDemo> {
  bool email = false;

  @override
  Widget build(BuildContext context) {
    return ShadSwitch(
      value: email,
      onChanged: (value) => setState(() => email = value),
      label: const Text('Kirim notifikasi email'),
      sublabel: const Text('Kabar rilis dan royalti masuk ke inbox kamu.'),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/switch.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/switch.json
```

## Aksesibilitas

- Punya `role="switch"` dan `aria-checked`.
- Spasi mengubah statusnya; klik label juga mengubahnya.
- Hubungkan deskripsi lewat `aria-describedby`.


---

# Slider

> Memilih nilai atau rentang di sebuah lintasan, misalnya awal dan akhir preview.

Slider memilih sebuah nilai, atau rentang dengan dua pegangan, dengan menggeser di sepanjang lintasan, misalnya bagian lagu yang dipakai sebagai preview.

## Kapan dipakai

- Pakai saat posisi kira-kira lebih penting daripada angka pastinya: jendela preview, volume.
- Selalu tampilkan nilainya sebagai teks di dekatnya, misalnya "0:30–1:00 dari 3:20".
- Kalau angkanya harus tepat, misalnya harga atau persentase di kontrak, pakai [Input](https://design.sosialoka.tech/id/components/input/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/slider/_

## Anatomi

1. Track
2. Rentang terpilih
3. Thumb
4. Nilai

| Bagian | Gaya |
| --- | --- |
| Lintasan | 6px (`h-1.5`), `rounded-full`, `bg-muted` |
| Rentang | `bg-primary` |
| Pegangan | 16px (`size-4`), `rounded-full`, border `primary` di atas `background` |

Dengan dua pegangan, keduanya tidak pernah saling melewati.

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value`, `onValueChange` | `v-model` | `ShadSlider initialValue`, `onChanged` | number[] / number | tidak ada | Nilainya, atau awal dan akhir rentang. |
| `min`, `max`, `step` | sama | `min`, `max`, `divisions` | number | 0, 100, 1 | Batas dan langkahnya. |
| `getAriaLabel` | `get-aria-label` | `Semantics label` | fungsi | tidak ada | Nama tiap pegangan, misalnya "Awal" dan "Akhir". |
| `getAriaValueText` | `get-aria-value-text` | `semanticFormatterCallback` | fungsi | angkanya | Yang dibacakan pembaca layar, misalnya "1:05". |

`shadcn_ui` hanya punya satu pegangan; untuk rentang di Flutter, pakai `RangeSlider` Material di dalam `SosialokaTheme.material`.

## Kode

**React**
```tsx
import { useState } from "react"
import { Slider } from "@/components/ui/slider"

const time = (seconds: number) => `${Math.floor(seconds / 60)}:${String(seconds % 60).padStart(2, "0")}`

export default function SliderDemo() {
  const [range, setRange] = useState([30, 60])
  return (
    <div className="flex w-full max-w-sm flex-col gap-3">
      <div className="flex items-baseline justify-between text-sm">
        <p id="preview-label" className="font-medium">
          Potong preview
        </p>
        <p className="text-muted-foreground tabular-nums">
          {time(range[0])}–{time(range[1])} dari 3:20
        </p>
      </div>
      <Slider
        aria-labelledby="preview-label"
        value={range}
        onValueChange={(value) => setRange(value as number[])}
        max={200}
        getAriaLabel={(index) => (index === 0 ? "Awal" : "Akhir")}
        getAriaValueText={(_, value) => time(value)}
      />
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import { Slider } from "@/components/ui/slider"

const range = ref([30, 60])
const time = (seconds: number) => `${Math.floor(seconds / 60)}:${String(seconds % 60).padStart(2, "0")}`
</script>

<template>
  <div class="flex w-full max-w-sm flex-col gap-3">
    <div class="flex items-baseline justify-between text-sm">
      <p id="preview-label" class="font-medium">
        Potong preview
      </p>
      <p class="text-muted-foreground tabular-nums">
        {{ time(range[0]) }}–{{ time(range[1]) }} dari 3:20
      </p>
    </div>
    <Slider
      v-model="range"
      aria-labelledby="preview-label"
      :max="200"
      :get-aria-label="(index) => (index === 0 ? 'Awal' : 'Akhir')"
      :get-aria-value-text="(value) => time(value)"
    />
  </div>
</template>
```

**Flutter**
```dart
// ShadSlider has one thumb. For a range (start and end of a preview), use Material's RangeSlider inside
// SosialokaTheme.material, whose slider colors come from the same tokens.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

String _time(double seconds) => '${seconds ~/ 60}:${(seconds % 60).toInt().toString().padLeft(2, '0')}';

class SliderDemo extends StatefulWidget {
  const SliderDemo({super.key});

  @override
  State<SliderDemo> createState() => _SliderDemoState();
}

class _SliderDemoState extends State<SliderDemo> {
  double start = 30;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          Row(
            children: [
              const Expanded(child: Text('Awal preview', style: TextStyle(fontWeight: FontWeight.w500))),
              Text('${_time(start)} dari 3:20', style: theme.textTheme.muted),
            ],
          ),
          const SizedBox(height: 12),
          ShadSlider(
            initialValue: start,
            max: 200,
            divisions: 200,
            semanticFormatterCallback: _time,
            onChanged: (value) => setState(() => start = value),
          ),
        ],
      ),
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/slider.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/slider.json
```

## Aksesibilitas

- Setiap pegangan adalah `slider` dengan nama dan nilai yang dibacakan, misalnya "Awal, 0:30".
- Tombol panah bergeser satu langkah, Page Up dan Page Down sepuluh, Home dan End ke ujung.
- Nilainya juga tampil sebagai teks, jadi tidak perlu menggeser untuk membacanya.


---

# Toggle Group

> Chip yang menyaring atau mengganti tampilan; satu atau beberapa bisa aktif.

Toggle Group adalah deretan chip yang menyaring isi halaman, misalnya status rilis, atau mengganti cara isinya ditampilkan.

## Kapan dipakai

- Pakai untuk filter cepat di atas daftar, dengan jumlah di setiap chip: "Terbit 12".
- Filter status **selalu punya satu nilai**: "Semua" sebagai bawaan, dan klik pada chip yang aktif tetap membuatnya aktif.
- Pakai [Tabs](https://design.sosialoka.tech/id/components/tabs/) kalau setiap pilihan menampilkan isi yang berbeda, dan [Select](https://design.sosialoka.tech/id/components/select/) untuk lebih dari lima pilihan.
- Pakai mode beberapa aktif untuk filter yang bisa digabung, misalnya genre.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/toggle-group/_

## Anatomi

1. Chip terpilih
2. Chip
3. Grup, satu nilai sekaligus

Chip `h-8` dengan `radius-md` dan `border`, berjarak 8px, tidak pernah berbentuk pil. Chip aktif berwarna `primary-soft` dengan `primary-text` dan border bernuansa `primary`. Jumlah opsional ada setelah label, berwarna `muted-foreground`.

## Varian

| Mode | Pakai untuk |
| --- | --- |
| Satu aktif | Filter status, pengganti tampilan. |
| Beberapa aktif (`multiple`) | Filter yang bisa digabung. |

**Toggle** tunggal (satu tombol yang tetap tertekan) ikut terpasang bersama grupnya dan tidak punya halaman sendiri.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `multiple` | `type="single"` / `"multiple"` | `ShadToggleGroup` / `ShadToggleGroup.multiple` | mode | satu aktif | Berapa chip yang boleh aktif. |
| `value` (array) / `onValueChange` | `v-model` | `initialValue` / `onChanged` | nilai | tidak ada | Chip yang aktif. |
| jaga satu aktif: abaikan nilai kosong | jaga satu aktif: abaikan nilai kosong | `allowDeselection: false` | boolean | bisa dikosongkan | Mencegah filter status menjadi kosong. |
| `variant="outline"` | `variant="outline"` | `ShadToggleVariant.outline` | teks | `default` | Tampilan chip. |
| `spacing` | `spacing` | `spacing` | angka | `2` (React), `0` (Vue) | Jarak antarchip; `0` menyambungkannya. Pakai `2`. |

## Kode

**React**
```tsx
import { useState } from "react"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"

const statuses = [
  { value: "all", label: "Semua", count: 24 },
  { value: "published", label: "Terbit", count: 12 },
  { value: "pending", label: "Menunggu", count: 8 },
  { value: "rejected", label: "Ditolak", count: 4 },
]

export default function ToggleGroupDemo() {
  const [status, setStatus] = useState("all")
  return (
    <ToggleGroup
      variant="outline"
      spacing={2}
      aria-label="Filter status"
      value={[status]}
      // A status filter always has one value: clicking the active chip keeps it on.
      onValueChange={(value) => value.length > 0 && setStatus(value[value.length - 1])}
    >
      {statuses.map((s) => (
        <ToggleGroupItem key={s.value} value={s.value}>
          {s.label}
          <span className="tabular-nums text-muted-foreground">{s.count}</span>
        </ToggleGroupItem>
      ))}
    </ToggleGroup>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"

const statuses = [
  { value: "all", label: "Semua", count: 24 },
  { value: "published", label: "Terbit", count: 12 },
  { value: "pending", label: "Menunggu", count: 8 },
  { value: "rejected", label: "Ditolak", count: 4 },
]
const status = ref("all")

// A status filter always has one value: clicking the active chip keeps it on.
function pick(value: unknown) {
  if (typeof value === "string" && value) status.value = value
}
</script>

<template>
  <ToggleGroup type="single" variant="outline" :spacing="2" aria-label="Filter status" :model-value="status" @update:model-value="pick">
    <ToggleGroupItem v-for="s in statuses" :key="s.value" :value="s.value">
      {{ s.label }}
      <span class="tabular-nums text-muted-foreground">{{ s.count }}</span>
    </ToggleGroupItem>
  </ToggleGroup>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const releaseStatuses = [('all', 'Semua', 24), ('published', 'Terbit', 12), ('pending', 'Menunggu', 8), ('rejected', 'Ditolak', 4)];

class ToggleGroupDemo extends StatelessWidget {
  const ToggleGroupDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    // A status filter always has one value: allowDeselection keeps the active chip on.
    return ShadToggleGroup<String>(
      initialValue: 'all',
      allowDeselection: false,
      variant: ShadToggleVariant.outline,
      spacing: 8,
      items: [
        for (final (value, label, count) in releaseStatuses)
          ShadToggleGroupItem(
            value: value,
            child: Row(
              mainAxisSize: MainAxisSize.min,
              spacing: 6,
              children: [Text(label), Text('$count', style: theme.textTheme.muted)],
            ),
          ),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/toggle-group.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/toggle-group.json
```

## Aksesibilitas

- Beri nama grupnya lewat `aria-label`, misalnya "Filter status".
- Setiap chip memberi tahu apakah sedang aktif lewat `aria-pressed`.
- Tombol panah berpindah antarchip; Spasi dan Enter mengaktifkannya.
- Taruh jumlah di dalam chip, supaya ikut dibacakan bersama labelnya.


---

# Select

> Memilih satu nilai dari daftar pendek.

Select memilih satu nilai dari daftar pendek yang terbuka di popup.

## Kapan dipakai

- Pakai untuk 4 sampai 15 pilihan.
- Pakai radio button untuk 2 atau 3 pilihan, supaya semuanya langsung terlihat.
- Pakai [Combobox](https://design.sosialoka.tech/id/components/combobox/) kalau daftarnya panjang atau perlu dicari.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/select/_

## Anatomi

1. Pemicu yang menampilkan nilai
2. Chevron
3. Daftar pilihan
4. Pilihan terpilih dengan centang

Trigger dengan `radius-md` yang menampilkan nilai terpilih atau placeholder, dan popup berlatar `popover` dengan `radius-lg` dan bayangan `shadow-md`. Popup dirender di luar alur halaman, jadi tidak pernah terpotong oleh kartu.

## Varian

Hanya ada satu gaya, dengan dua ukuran trigger: `default` dan `sm`.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `items` | children (`SelectItem`) | `options` | list | tidak ada | Pilihan. Di React, Base UI butuh `items` di root. |
| `value` / `defaultValue` | `v-model` / `default-value` | `initialValue` | string | tidak ada | Nilai terpilih. |
| `onValueChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat nilai berubah. |
| item placeholder (`value: null`) | `placeholder` di `SelectValue` | `placeholder` | teks | tidak ada | Tampil sebelum ada pilihan. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mencegah popup terbuka. |

## Kode

**React**
```tsx
import {
  Select,
  SelectContent,
  SelectGroup,
  SelectItem,
  SelectTrigger,
  SelectValue,
} from "@/components/ui/select"

const products = [
  { label: "Pilih produk", value: null },
  { label: "Loka Musik", value: "lokamusik" },
  { label: "Cover Clearance", value: "coverclearance" },
  { label: "Lokasign", value: "lokasign" },
  { label: "My Loka Link", value: "mylokalink" },
]

export default function SelectDemo() {
  return (
    <Select items={products}>
      <SelectTrigger className="w-56" aria-label="Produk">
        <SelectValue />
      </SelectTrigger>
      <SelectContent>
        <SelectGroup>
          {products
            .filter((p) => p.value !== null)
            .map((p) => (
              <SelectItem key={p.value} value={p.value}>
                {p.label}
              </SelectItem>
            ))}
        </SelectGroup>
      </SelectContent>
    </Select>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import {
  Select,
  SelectContent,
  SelectGroup,
  SelectItem,
  SelectTrigger,
  SelectValue,
} from "@/components/ui/select"

const products = [
  { label: "Loka Musik", value: "lokamusik" },
  { label: "Cover Clearance", value: "coverclearance" },
  { label: "Lokasign", value: "lokasign" },
  { label: "My Loka Link", value: "mylokalink" },
]
</script>

<template>
  <Select>
    <SelectTrigger class="w-56" aria-label="Produk">
      <SelectValue placeholder="Pilih produk" />
    </SelectTrigger>
    <SelectContent>
      <SelectGroup>
        <SelectItem v-for="p in products" :key="p.value" :value="p.value">
          {{ p.label }}
        </SelectItem>
      </SelectGroup>
    </SelectContent>
  </Select>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const products = {
  'lokamusik': 'Loka Musik',
  'coverclearance': 'Cover Clearance',
  'lokasign': 'Lokasign',
  'mylokalink': 'My Loka Link',
};

class SelectDemo extends StatelessWidget {
  const SelectDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(minWidth: 224),
      child: ShadSelect<String>(
        placeholder: const Text('Pilih produk'),
        options: products.entries
            .map((e) => ShadOption(value: e.key, child: Text(e.value)))
            .toList(),
        selectedOptionBuilder: (context, value) => Text(products[value]!),
        onChanged: (value) {},
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/select.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/select.json
```

## Aksesibilitas

- Trigger punya `role="combobox"` dan terbuka dengan Enter, Spasi, atau tombol panah.
- Tombol panah berpindah antarpilihan, mengetik melompat ke pilihan yang cocok, dan Escape menutup.
- Beri trigger label, atau `aria-label` kalau tidak ada tempat untuk label yang terlihat.


---

# Combobox

> Memilih satu nilai dari daftar panjang dengan mengetik untuk mencarinya.

Combobox adalah kolom teks dengan daftar: orang mengetik untuk menyaring daftar, lalu memilih satu nilai dengan mouse atau keyboard.

## Kapan dipakai

- Pakai untuk lebih dari 15 pilihan, atau saat orang tahu apa yang dicarinya, misalnya artis, lagu, atau perusahaan.
- Pakai [Select](https://design.sosialoka.tech/id/components/select/) untuk 4 sampai 15 pilihan, dan [Radio Group](https://design.sosialoka.tech/id/components/radio-group/) untuk 2 atau 3.
- Tulis teks kosong untuk daftarnya, misalnya "Artis tidak ditemukan.", supaya orang tahu pencariannya sudah jalan.

**Mencari di server.** Kalau daftarnya ada di backend, cari sambil orang mengetik: tunggu sekitar 300ms setelah ketikan terakhir, biarkan hasil sebelumnya tampil selama hasil berikutnya dimuat, dan tampilkan [Spinner](https://design.sosialoka.tech/id/components/spinner/) di daftar. Backend yang menentukan apa yang cocok.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/combobox/_

## Anatomi

1. Input untuk mengetik
2. Teks yang diketik dan kursor
3. Pilihan yang cocok
4. Daftar

1. **Input**: kolom teks dengan `radius-md` dan border `input`, tinggi `h-9`.
2. **Daftar**: popup berlatar `popover` dengan `border`, `radius-lg`, dan `shadow-lg`, selebar input.
3. **Item**: `radius-md`; item yang disorot berlatar `accent` dan yang terpilih bertanda centang.
4. **Teks kosong**: tampil saat tidak ada yang cocok.

## Varian

Hanya ada satu gaya. React juga punya chip (`ComboboxChips`) untuk memilih beberapa nilai.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `items` di `Combobox` | children `ComboboxItem` | `options` di `ShadSelect.withSearch` | list | tidak ada | Daftar pilihan. |
| `value` / `defaultValue` | `v-model` | `initialValue` | nilai | tidak ada | Nilai terpilih. |
| `onValueChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat nilai dipilih. |
| `placeholder` di `ComboboxInput` | `placeholder` di `ComboboxInput` | `placeholder` | teks | tidak ada | Tampil sebelum ada pilihan. |
| `ComboboxEmpty` | `ComboboxEmpty` | baris kosong di `options` | teks | tidak ada | Memberi tahu bahwa tidak ada yang cocok. |
| `onInputValueChange` | `@update:model-value` di `ComboboxInput` | `onSearchChanged` | function | tidak ada | Jalan saat orang mengetik, untuk pencarian di server. |

## Kode

**React**
```tsx
import { useId } from "react"
import {
  Combobox,
  ComboboxContent,
  ComboboxEmpty,
  ComboboxInput,
  ComboboxItem,
  ComboboxList,
} from "@/components/ui/combobox"
import { Field, FieldLabel } from "@/components/ui/field"

const artists = ["Rara Senandika", "Bima Laras", "Nada Kirana", "Arka Wening", "Sinta Maharani", "Raka Pratama"]

export default function ComboboxDemo() {
  const id = useId()
  return (
    <Field className="w-full max-w-xs">
      <FieldLabel htmlFor={`${id}-artist`}>Artis</FieldLabel>
      <Combobox items={artists}>
        <ComboboxInput id={`${id}-artist`} placeholder="Pilih artis" />
        <ComboboxContent>
          <ComboboxEmpty>Artis tidak ditemukan.</ComboboxEmpty>
          <ComboboxList>
            {(artist: string) => (
              <ComboboxItem key={artist} value={artist}>
                {artist}
              </ComboboxItem>
            )}
          </ComboboxList>
        </ComboboxContent>
      </Combobox>
    </Field>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref, useId } from "vue"
import { CheckIcon } from "@lucide/vue"
import {
  Combobox,
  ComboboxAnchor,
  ComboboxEmpty,
  ComboboxInput,
  ComboboxItem,
  ComboboxItemIndicator,
  ComboboxList,
} from "@/components/ui/combobox"
import { Field, FieldLabel } from "@/components/ui/field"

const artists = ["Rara Senandika", "Bima Laras", "Nada Kirana", "Arka Wening", "Sinta Maharani", "Raka Pratama"]
const id = useId()
const artist = ref<string>()
</script>

<template>
  <Field class="w-full max-w-xs">
    <FieldLabel :for="`${id}-artist`">Artis</FieldLabel>
    <Combobox v-model="artist">
      <ComboboxAnchor>
        <ComboboxInput :id="`${id}-artist`" placeholder="Pilih artis" :display-value="(value: string) => value ?? ''" />
      </ComboboxAnchor>
      <ComboboxList>
        <ComboboxEmpty>Artis tidak ditemukan.</ComboboxEmpty>
        <ComboboxItem v-for="name in artists" :key="name" :value="name">
          {{ name }}
          <ComboboxItemIndicator>
            <CheckIcon />
          </ComboboxItemIndicator>
        </ComboboxItem>
      </ComboboxList>
    </Combobox>
  </Field>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const artists = ['Rara Senandika', 'Bima Laras', 'Nada Kirana', 'Arka Wening', 'Sinta Maharani', 'Raka Pratama'];

class ComboboxDemo extends StatefulWidget {
  const ComboboxDemo({super.key});

  @override
  State<ComboboxDemo> createState() => _ComboboxDemoState();
}

class _ComboboxDemoState extends State<ComboboxDemo> {
  String search = '';

  @override
  Widget build(BuildContext context) {
    final matches = artists.where((a) => a.toLowerCase().contains(search.toLowerCase())).toList();
    return Column(
      mainAxisSize: MainAxisSize.min,
      crossAxisAlignment: CrossAxisAlignment.start,
      spacing: 8,
      children: [
        Text('Artis', style: ShadTheme.of(context).textTheme.small),
        ShadSelect<String>.withSearch(
          minWidth: 280,
          placeholder: const Text('Pilih artis'),
          searchPlaceholder: const Text('Cari artis'),
          onSearchChanged: (value) => setState(() => search = value),
          options: [
            if (matches.isEmpty)
              const Padding(padding: EdgeInsets.symmetric(vertical: 24), child: Text('Artis tidak ditemukan.')),
            for (final artist in matches) ShadOption(value: artist, child: Text(artist)),
          ],
          selectedOptionBuilder: (context, value) => Text(value),
        ),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/combobox.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/combobox.json
```

## Aksesibilitas

- Input punya `role="combobox"` dan label yang terlihat; daftarnya `role="listbox"` dan itemnya `role="option"`.
- Mengetik menyaring daftar. Tombol panah berpindah antaritem, Enter memilih, dan Escape menutup daftar tanpa mengubah nilai.
- Teks kosong dibacakan saat tidak ada yang cocok.


---

# Calendar

> Satu bulan berisi hari untuk memilih tanggal.

Calendar menampilkan satu bulan langsung di halaman untuk memilih hari, misalnya tanggal rilis saat memilih tanggal adalah tugas utama layar itu. Di dalam form, pakai [Date Picker](https://design.sosialoka.tech/id/components/date-picker/) yang membuka kalender ini di popover.

## Kapan dipakai

- Pakai langsung di halaman kalau memilih tanggal adalah tugasnya, misalnya menjadwalkan rilis.
- Di form, pakai Date Picker supaya kalender hanya memakan tempat saat dibuka.
- Untuk tanggal yang jauh di masa lalu, misalnya tanggal lahir, pakai pemilih bulan dan tahun (`captionLayout="dropdown"` di React, `layout="month-and-year"` di Vue).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/calendar/_

## Anatomi

1. Judul bulan
2. Nama hari, mulai Senin
3. Hari terpilih
4. Hari ini

Judul berisi bulan dan tahun, tombol sebelumnya dan berikutnya, baris nama hari singkat, lalu hari-harinya.

| Hari | Gaya |
| --- | --- |
| Hari biasa | 36px (`size-9`), `rounded-md` |
| Hari ini | `ring` |
| Terpilih | `bg-primary`, `text-primary-foreground` |
| Di luar bulan | `muted-foreground` |

Bawaannya berbahasa Inggris (en-GB): "November 2026", "Mo Tu We Th Fr Sa Su", dan minggu dimulai hari Senin. Untuk bahasa Indonesia, isi `id` dari `react-day-picker/locale` di React atau `locale="id-ID"` di Vue, seperti contohnya; Flutter mengikuti locale aplikasi.

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `mode="single"` | tunggal bawaannya | `ShadCalendar` | | tunggal | Memilih satu hari, rentang, atau beberapa hari. |
| `selected`, `onSelect` | `v-model` | `selected`, `onChanged` | `Date` / `DateValue` / `DateTime` | tidak ada | Hari yang dipilih. |
| `locale` | `locale` | `locale` aplikasi | lokal | Inggris (en-GB) | Nama bulan dan hari, serta hari pertama dalam minggu. |
| `defaultMonth` | `default-placeholder` | `initialMonth` | tanggal | hari ini | Bulan yang tampil pertama. |
| `captionLayout` | `layout` | `captionLayout` | teks | label | Pemilih bulan dan tahun sebagai ganti judul. |

## Kode

**React**
```tsx
import { useState } from "react"
import { id } from "react-day-picker/locale"
import { Calendar } from "@/components/ui/calendar"

export default function CalendarDemo() {
  const [date, setDate] = useState<Date | undefined>(new Date(2026, 10, 14))
  return <Calendar locale={id} mode="single" selected={date} onSelect={setDate} defaultMonth={date} className="rounded-lg border border-border" />
}
```

**Vue**
```vue
<script setup lang="ts">
import type { DateValue } from "@internationalized/date"
import { CalendarDate } from "@internationalized/date"
import { shallowRef } from "vue"
import { Calendar } from "@/components/ui/calendar"

const date = shallowRef<DateValue>(new CalendarDate(2026, 11, 14))
</script>

<template>
  <Calendar v-model="date" locale="id-ID" :default-placeholder="date" class="rounded-lg border border-border" />
</template>
```

**Flutter**
```dart
// ShadCalendar reads month and weekday names from the app locale: run the app with
// locale: Locale('id') and GlobalMaterialLocalizations.delegates (flutter_localizations).
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class CalendarDemo extends StatelessWidget {
  const CalendarDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadCalendar(
      selected: DateTime(2026, 11, 14),
      initialMonth: DateTime(2026, 11),
      weekStartsOn: 1,
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/calendar.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/calendar.json
```

## Aksesibilitas

- Tombol panah berpindah antarhari, Page Up dan Page Down antarbulan, dan Enter atau Spasi memilih hari.
- Setiap tombol hari menyebut tanggal lengkapnya, misalnya "Sabtu, 14 November 2026", serta apakah itu hari ini atau sudah dipilih.
- Tombol sebelumnya dan berikutnya bernama "Ke bulan sebelumnya" dan "Ke bulan berikutnya".


---

# Date Picker

> Tombol yang membuka kalender dan menampilkan tanggal yang dipilih.

Date Picker adalah kolom form yang membuka [Calendar](https://design.sosialoka.tech/id/components/calendar/) di popover dan menampilkan tanggal yang dipilih, misalnya tanggal rilis.

## Kapan dipakai

- Pakai untuk satu tanggal di form yang dekat dengan hari ini: tanggal rilis, tenggat.
- Di form panjang yang tanggalnya sudah diketahui pasti, misalnya tanggal lahir atau tanggal kontrak bertahun-tahun lalu, input tanggal native (`<input type="date">`) lebih cepat diketik.
- Tampilkan tanggal sebagai `14 Nov 2026`. Kirim ke backend dalam format ISO `2026-11-14`, jangan teks yang tampil.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/date-picker/_

## Anatomi

1. Pemicu yang menampilkan tanggal
2. Ikon kalender
3. Kalender di popover
4. Hari terpilih

[Button](https://design.sosialoka.tech/id/components/button/) `outline` dengan ikon kalender dan tanggalnya, atau placeholder "Pilih tanggal" berwarna `muted-foreground`. Klik membuka kalender di [Popover](https://design.sosialoka.tech/id/components/popover/); memilih hari menutupnya.

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value`, `onValueChange` | `v-model` | `ShadDatePicker onChanged` | `Date` / `DateValue` / `DateTime` | tidak ada | Tanggal yang dipilih. |
| `placeholder` | `placeholder` | `placeholder` | teks | `Pick a date` | Tampil sebelum tanggal dipilih, misalnya "Pilih tanggal". |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Menonaktifkan kolom. |
| `locale` | `locale` | `locale` aplikasi | lokal | Inggris (en-GB) | Nama bulan, dan cara tanggal ditulis. Untuk bahasa Indonesia, `id` dari `react-day-picker/locale` atau `"id-ID"`. |
| `dateFormat` | | `formatDate` | teks / fungsi | tanggal pendek lokal (`14 Aug 2026`; `14 Agu 2026` dalam bahasa Indonesia) | Pola date-fns, kalau tanggal perlu bentuk lain. |

## Kode

**React**
```tsx
import { useState } from "react"
import { id } from "react-day-picker/locale"
import { DatePicker } from "@/components/ui/date-picker"

export default function DatePickerDemo() {
  const [date, setDate] = useState<Date>()
  return <DatePicker locale={id} value={date} onValueChange={setDate} placeholder="Pilih tanggal" className="w-56" />
}
```

**Vue**
```vue
<script setup lang="ts">
import type { DateValue } from "@internationalized/date"
import { shallowRef } from "vue"
import { DatePicker } from "@/components/ui/date-picker"

const date = shallowRef<DateValue>()
</script>

<template>
  <DatePicker v-model="date" locale="id-ID" placeholder="Pilih tanggal" class="w-56" />
</template>
```

**Flutter**
```dart
// A date field that opens a calendar. Dates read "15 Nov 2026"; the app runs with locale: Locale('id').
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class DatePickerDemo extends StatelessWidget {
  const DatePickerDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadDatePicker(
      width: 256,
      placeholder: const Text('Pilih tanggal'),
      initialMonth: DateTime(2026, 11),
      weekStartsOn: 1,
      formatDate: (date) => DateFormat('d MMM yyyy', 'id').format(date),
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/date-picker.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/date-picker.json
```

## Aksesibilitas

- Saat dibuka, fokus langsung di hari yang dipilih, atau hari ini, jadi tombol panah bisa langsung dipakai.
- Enter memilih hari dan menutup popover; Escape menutupnya. Keduanya mengembalikan fokus ke tombol.
- Beri kolom ini label yang terlihat dengan [Field](https://design.sosialoka.tech/id/components/field/), misalnya "Tanggal rilis".


---

# Input OTP

> Memasukkan kode sekali pakai di enam kotak.

Input OTP menerima kode sekali pakai, misalnya verifikasi email atau kode masuk, di enam kotak terpisah.

## Kapan dipakai

Pakai untuk setiap kode sekali pakai di semua produk Sosialoka, dengan aturan ini:

- **Enam kotak terpisah**, tidak pernah satu kolom teks.
- **Hanya angka.** Menempel kode utuh dari email langsung mengisi semua kotak.
- **Kirim saat lengkap.** Begitu angka keenam masuk, kirim kodenya tanpa perlu diklik. Tombol kirim tetap ada, nonaktif sampai kode lengkap, dan fungsi kirimnya dijaga supaya hanya jalan sekali.
- **Kosongkan saat backend menolak kodenya**, supaya kursor kembali ke kotak pertama; tampilkan pesan dari backend di bawahnya.
- **Fokuskan kotak pertama** saat layar atau langkahnya muncul.
- Taruh label di atas kotak sebagai elemen `p`, rata tengah bersama hint-nya.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/input-otp/_

## Anatomi

1. Kotak terisi
2. Kotak yang aktif
3. Kotak kosong

Enam kotak 48px (`size-12`) dengan `radius-md` dan border `input`, berjarak 8px, teks `text-lg`. Kotak aktif menampilkan `ring`; kode yang ditolak membuat semua border `destructive`. Satu input sungguhan ada di balik kotak-kotak itu, dan itulah yang membuat mengetik, menghapus, dan menempel bisa jalan.

## Varian

Hanya ada satu gaya, untuk enam angka.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `maxLength` | `maxlength` | `maxLength` | angka | tidak ada | Jumlah angka: `6`. |
| `pattern={REGEXP_ONLY_DIGITS}` | `:pattern="REGEXP_ONLY_DIGITS"` | `FilteringTextInputFormatter.digitsOnly` | pola | semua karakter | Hanya menerima angka. |
| `value` / `onChange` | `v-model` | `onChanged` | teks | `""` | Kode yang sudah diketik. |
| `onComplete` | `@complete` | cek panjangnya di `onChanged` | function | tidak ada | Jalan saat kotak terakhir terisi: kirim di sini. |
| `aria-invalid` | `aria-invalid` | error di bawahnya | boolean | `false` | Menandai kode yang ditolak. |

## Kode

**React**
```tsx
import { useId } from "react"
import { REGEXP_ONLY_DIGITS } from "input-otp"
import { InputOTP, InputOTPGroup, InputOTPSlot } from "@/components/ui/input-otp"

export default function InputOtpDemo() {
  const id = useId()
  return (
    <div className="grid justify-items-center gap-2 text-center">
      {/* One real input sits behind the six boxes, so the label points at it through aria-labelledby. */}
      <p id={`${id}-label`} className="text-sm font-medium">Kode verifikasi</p>
      <InputOTP maxLength={6} pattern={REGEXP_ONLY_DIGITS} autoFocus aria-labelledby={`${id}-label`} aria-describedby={`${id}-hint`}>
        <InputOTPGroup>
          {[0, 1, 2, 3, 4, 5].map((index) => (
            <InputOTPSlot key={index} index={index} />
          ))}
        </InputOTPGroup>
      </InputOTP>
      <p id={`${id}-hint`} className="text-sm text-muted-foreground">Kami kirim kodenya ke email kamu.</p>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { REGEXP_ONLY_DIGITS } from "vue-input-otp"
import { InputOTP, InputOTPGroup, InputOTPSlot } from "@/components/ui/input-otp"

const id = useId()
</script>

<template>
  <div class="grid justify-items-center gap-2 text-center">
    <!-- One real input sits behind the six boxes, so the label points at it through aria-labelledby. -->
    <p :id="`${id}-label`" class="text-sm font-medium">Kode verifikasi</p>
    <InputOTP :maxlength="6" :pattern="REGEXP_ONLY_DIGITS" autofocus :aria-labelledby="`${id}-label`" :aria-describedby="`${id}-hint`">
      <InputOTPGroup>
        <InputOTPSlot v-for="index in 6" :key="index" :index="index - 1" />
      </InputOTPGroup>
    </InputOTP>
    <p :id="`${id}-hint`" class="text-sm text-muted-foreground">Kami kirim kodenya ke email kamu.</p>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/services.dart';
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class InputOtpDemo extends StatelessWidget {
  const InputOtpDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Column(
      mainAxisSize: MainAxisSize.min,
      spacing: 8,
      children: [
        Text('Kode verifikasi', style: theme.textTheme.small),
        // Six separate 48px boxes: one slot per group, 8px apart.
        ShadInputOTP(
          maxLength: 6,
          gap: 8,
          keyboardType: TextInputType.number,
          inputFormatters: [FilteringTextInputFormatter.digitsOnly],
          onChanged: (code) {},
          children: [
            for (var i = 0; i < 6; i++)
              const ShadInputOTPGroup(children: [ShadInputOTPSlot(width: 48, height: 48)]),
          ],
        ),
        Text('Kami kirim kodenya ke email kamu.', style: theme.textTheme.muted),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/input-otp.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/input-otp.json
```

## Aksesibilitas

- Input sungguhan di balik kotak diberi nama oleh label lewat `aria-labelledby` dan dihubungkan ke hint lewat `aria-describedby`.
- Input memakai `autocomplete="one-time-code"`, jadi HP bisa menawarkan kode dari pesan.
- Backspace menghapus kotak sebelumnya; tombol panah berpindah antarkotak.


---

# File Upload

> Menarik atau memilih file, lalu menampilkannya dengan ukuran dan progres unggahnya.

File Upload menerima file lewat tarik-lepas atau pemilih file, lalu menampilkan setiap file dengan ukuran, progres, dan error-nya, misalnya file master audio.

## Kapan dipakai

- Pakai saat form butuh file: master, surat pengantar, kontrak.
- Tulis jenis file dan batas ukuran di hint: "WAV atau FLAC, maks. 200 MB."
- Klien hanya membatasi pemilih file dengan `accept`. Backend yang memeriksa isi file, dan pesannya tampil di bawah file itu.
- Di HP tidak ada yang bisa ditarik: area ini menjadi tombol yang membuka pemilih file.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/file-upload/_

## Anatomi

1. Area taruh file, sekaligus tombol
2. Ikon unggah
3. Baris file
4. Progres unggahan

| Bagian | Gaya |
| --- | --- |
| Area unggah | `rounded-lg`, border putus-putus `input`, `bg-muted/30`, padding 24px, rata tengah. Saat hover dan saat file ditarik ke atasnya: `border-primary` dan `bg-primary-soft`. |
| Teks | "Tarik file ke sini atau pilih file", lalu hint dengan `text-xs muted-foreground`. |
| Baris file | Satu baris per file di `card` dengan `border`: nama, ukuran, bar [Progress](https://design.sosialoka.tech/id/components/progress/) saat mengunggah, dan tombol hapus. |
| Error | Pesan dari backend di bawah file dengan warna `destructive`; border barisnya ikut `destructive`. |

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `accept` | `accept` | `allowedExtensions` di `file_picker` | teks | semua | Membatasi pemilih file, misalnya `.wav,.flac`. |
| `multiple` | `multiple` | `allowMultiple` | boolean | `false` | Mengizinkan beberapa file. |
| `files`, `onFilesChange` | `v-model:files` | daftarmu sendiri | `{ file, progress?, error? }[]` | `[]` | Daftar file, dengan progres (0–100) dan error dari backend. |
| `onRemove` | `@remove` | handler-mu | fungsi | tidak ada | Dijalankan setelah file dihapus, misalnya untuk membatalkan unggahannya. |
| `hint`, `error` | `hint`, `error` | `Text` | teks | tidak ada | Batasannya, dan pesan backend tentang unggahan secara keseluruhan. |
| `label`, `buttonLabel` | `label`, `button-label` | `Text` | teks | bahasa Inggris | Teks area: `label` mulai `sm`, `buttonLabel` di HP, misalnya "Pilih file". |
| `removeLabel`, `uploadingLabel` | sama | `Semantics` | fungsi | bahasa Inggris | Nama tombol dan bar, misalnya "Hapus master.wav". |
| `locale` | `locale` | locale `NumberFormat` | teks | `en-GB` | Cara ukuran file ditulis, misalnya `"id-ID"` untuk `4,1 MB`. |

Flutter tidak punya widget unggah; snippet-nya menggambar area dari tema, dan produk membuka pemilih file dengan paket `file_picker`.

## Kode

**React**
```tsx
import { useEffect, useState } from "react"
import { FileUpload, type FileUploadItem } from "@/components/ui/file-upload"

/** A file the backend already turned down, so the demo shows the error state. */
const rejected = new File(["demo"], "demo-lama.mp3", { type: "audio/mpeg" })
Object.defineProperty(rejected, "size", { value: 4_300_000 })

export default function FileUploadDemo() {
  const [files, setFiles] = useState<FileUploadItem[]>([{ file: rejected, error: "Format file-nya belum pas." }])

  // Pretend to upload: new files fill their progress bar, then settle.
  useEffect(() => {
    if (!files.some((f) => f.progress !== undefined)) return
    const timer = setTimeout(
      () =>
        setFiles((list) =>
          list.map((f) => (f.progress === undefined ? f : f.progress >= 100 ? { file: f.file } : { ...f, progress: f.progress + 25 }))
        ),
      400
    )
    return () => clearTimeout(timer)
  }, [files])

  return (
    <FileUpload
      className="max-w-md"
      accept=".wav,.flac"
      multiple
      label="Tarik file ke sini atau pilih file"
      buttonLabel="Pilih file"
      locale="id-ID"
      hint="WAV atau FLAC, maks. 200 MB."
      removeLabel={(name) => `Hapus ${name}`}
      uploadingLabel={(name) => `Mengunggah ${name}`}
      files={files}
      onFilesChange={(next) => setFiles(next.map((f) => (files.includes(f) ? f : { file: f.file, progress: 0 })))}
    />
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import type { FileUploadItem } from "@/components/ui/file-upload"
import { onBeforeUnmount, ref, watch } from "vue"
import { FileUpload } from "@/components/ui/file-upload"

/** A file the backend already turned down, so the demo shows the error state. */
const rejected = new File(["demo"], "demo-lama.mp3", { type: "audio/mpeg" })
Object.defineProperty(rejected, "size", { value: 4_300_000 })

const files = ref<FileUploadItem[]>([{ file: rejected, error: "Format file-nya belum pas." }])

/** New files start uploading. */
function update(next: FileUploadItem[]) {
  files.value = next.map(f => (files.value.includes(f) ? f : { file: f.file, progress: 0 }))
}

// Pretend to upload: new files fill their progress bar, then settle.
let timer: ReturnType<typeof setTimeout> | undefined
watch(files, (list) => {
  clearTimeout(timer)
  if (!list.some(f => f.progress !== undefined)) return
  timer = setTimeout(() => {
    files.value = files.value.map(f => (f.progress === undefined ? f : f.progress >= 100 ? { file: f.file } : { ...f, progress: f.progress + 25 }))
  }, 400)
})
onBeforeUnmount(() => clearTimeout(timer))
</script>

<template>
  <FileUpload
    class="max-w-md"
    accept=".wav,.flac"
    multiple
    label="Tarik file ke sini atau pilih file"
    button-label="Pilih file"
    locale="id-ID"
    hint="WAV atau FLAC, maks. 200 MB."
    :remove-label="(name) => `Hapus ${name}`"
    :uploading-label="(name) => `Mengunggah ${name}`"
    :files="files"
    @update:files="update"
  />
</template>
```

**Flutter**
```dart
// shadcn_ui has no upload widget: a card with an input-colored border, a "Pilih file" button and the file list.
// In a product, open the system picker with the file_picker package (not installed in this example).
// Error text per file comes from the backend.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

class FileUploadDemo extends StatelessWidget {
  const FileUploadDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          Container(
            padding: const EdgeInsets.all(24),
            decoration: BoxDecoration(
              border: Border.all(color: theme.colorScheme.input),
              borderRadius: BorderRadius.circular(12),
            ),
            child: Column(
              children: [
                Icon(LucideIcons.upload, color: theme.colorScheme.mutedForeground),
                const SizedBox(height: 8),
                // Phones have nothing to drag from: the area only offers the picker.
                const Text('Pilih file dari perangkatmu.'),
                const SizedBox(height: 4),
                Text('WAV atau FLAC, maks. 200 MB.', style: theme.textTheme.muted),
                const SizedBox(height: 12),
                ShadButton.outline(onPressed: () {}, child: const Text('Pilih file')),
              ],
            ),
          ),
          const SizedBox(height: 12),
          Container(
            padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 8),
            decoration: BoxDecoration(
              border: Border.all(color: c.destructive),
              borderRadius: BorderRadius.circular(8),
            ),
            child: Row(
              children: [
                Icon(LucideIcons.fileAudio, size: 16, color: theme.colorScheme.mutedForeground),
                const SizedBox(width: 8),
                Expanded(
                  child: Column(
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: [
                      const Text('demo-lama.mp3 · 4,3 MB'),
                      Text('Format file-nya belum pas.', style: theme.textTheme.small.copyWith(color: c.destructive)),
                    ],
                  ),
                ),
                Semantics(
                  label: 'Hapus demo-lama.mp3',
                  child: ShadIconButton.ghost(icon: const Icon(LucideIcons.x, size: 16), onPressed: () {}),
                ),
              ],
            ),
          ),
        ],
      ),
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/file-upload.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/file-upload.json
```

## Aksesibilitas

- Area unggah adalah tombol: Enter dan Spasi membuka pemilih file.
- Hint dan error backend tentang unggahan secara keseluruhan terhubung ke area itu lewat `aria-describedby`.
- Setiap tombol hapus dinamai sesuai file-nya, misalnya "Hapus master.wav", dan error sebuah file terhubung ke tombol itu.
- Setiap bar progres diberi nama, misalnya "Mengunggah master.wav".


---

# Badge

> Menampilkan status atau label singkat.

Badge menampilkan status sebuah item, misalnya rilisan atau dokumen, atau label singkat seperti "Baru".

## Kapan dipakai

- Pakai varian status untuk keadaan sebuah data: `success`, `warning`, `info`, `destructive`.
- Selalu tulis statusnya dengan kata. Warna saja tidak cukup untuk menyampaikan status.
- Pakai `default` atau `outline` untuk label yang bukan status.
- Jangan pakai badge sebagai tombol.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/badge/_

### Lakukan dan jangan

- **Lakukan:** Sebut statusnya dengan kata, dan warnanya sebagai tanda kedua.
- **Jangan:** Jangan tunjukkan status hanya dengan warna; tidak semua orang bisa membedakannya.

## Anatomi

1. Teks warna status
2. Latar lembut
3. Varian outline

Teks pendek `text-xs` medium dengan `radius-sm` (6px). Badge tidak pernah berbentuk pil. Badge status memakai isi lembut dari statusnya, dengan warna status sebagai teks.

## Varian

| Varian | Tampilan | Dipakai untuk |
| --- | --- | --- |
| `success` | Teks `success` di atas `success-soft` | Selesai, disetujui, terbit. |
| `warning` | Teks `warning` di atas `warning-soft` | Menunggu, sedang ditinjau. |
| `info` | Teks `info` di atas `info-soft` | Informasi netral. |
| `destructive` | Teks `destructive` di atas `destructive-soft` | Ditolak, gagal, dibatalkan. |
| `default` | Isi `primary` | Label berwarna produk, misalnya "Baru". |
| `secondary` | Isi `secondary` | Label yang tenang. |
| `outline` | Garis `border` | Label yang tidak perlu menonjol, misalnya "Draf". |
| `ghost` | Tanpa isi sampai di-hover | Label tenang di dalam link atau menu. |
| `link` | `primary-text`, bergaris bawah saat di-hover | Badge yang sekaligus link. |

Badge `default` di atas oranye Cover Clearance memakai pengecualian kontras yang sama dengan tombol utama. Buat labelnya singkat.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | named constructor, atau `backgroundColor` + `foregroundColor` untuk status | lihat Varian | `default` | Makna dan bobot. |
| `render` | `as` / `as-child` | `child` | elemen | `span` | Merender badge sebagai elemen lain, misalnya link. |

## Kode

**React**
```tsx
import { Badge } from "@/components/ui/badge"

export default function BadgeDemo() {
  return (
    <div className="flex flex-wrap items-center gap-2">
      <Badge variant="success">Selesai</Badge>
      <Badge variant="warning">Menunggu</Badge>
      <Badge variant="info">Info</Badge>
      <Badge variant="destructive">Ditolak</Badge>
      <Badge>Baru</Badge>
      <Badge variant="outline">Draf</Badge>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Badge } from "@/components/ui/badge"
</script>

<template>
  <div class="flex flex-wrap items-center gap-2">
    <Badge variant="success">Selesai</Badge>
    <Badge variant="warning">Menunggu</Badge>
    <Badge variant="info">Info</Badge>
    <Badge variant="destructive">Ditolak</Badge>
    <Badge>Baru</Badge>
    <Badge variant="outline">Draf</Badge>
  </div>
</template>
```

**Flutter**
```dart
// Status colors come from the Sosialoka theme: context.sosialoka.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

class BadgeDemo extends StatelessWidget {
  const BadgeDemo({super.key});

  ShadBadge status(Color text, Color soft, String label) =>
      ShadBadge(backgroundColor: soft, foregroundColor: text, child: Text(label));

  @override
  Widget build(BuildContext context) {
    final c = context.sosialoka;
    return Wrap(
      spacing: 8,
      runSpacing: 8,
      children: [
        status(c.success, c.successSoft, 'Selesai'),
        status(c.warning, c.warningSoft, 'Menunggu'),
        status(c.info, c.infoSoft, 'Info'),
        status(c.destructive, c.destructiveSoft, 'Ditolak'),
        const ShadBadge(child: Text('Baru')),
        const ShadBadge.outline(child: Text('Draf')),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/badge.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/badge.json
```

## Aksesibilitas

- Teks badge dibacakan seperti teks biasa, jadi buat tetap bermakna tanpa warnanya.
- Warna status lolos kontras 4.5:1 di atas isi lembutnya, di semua tema.


---

# Alert

> Menampilkan pesan yang menetap di halaman, dengan warna status.

Alert menampilkan pesan yang menetap di halaman sampai penyebabnya selesai, misalnya rilis yang ditolak atau langganan yang hampir habis.

## Kapan dipakai

- Pakai untuk keadaan halaman atau akun yang perlu terlihat selama orang bekerja.
- Pakai [Toast](https://design.sosialoka.tech/id/components/toast/) untuk memberi tahu aksi yang baru saja terjadi; toast hilang sendiri.
- Tampilkan error validasi di bawah field-nya dengan [Field](https://design.sosialoka.tech/id/components/field/), bukan di alert. Form boleh menambahkan satu alert `destructive` di atas saat backend menolak seluruh form.
- Tulis judul singkat dan satu kalimat yang menyebut apa yang perlu dilakukan.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/alert/_

## Anatomi

1. Wadah berwarna status lembut
2. Ikon
3. Judul
4. Deskripsi

Ikon di kiri, judul, dan deskripsi, dengan `radius-lg` dan `px-4 py-3`. Varian status memakai permukaan status yang lembut, dengan ikon dan judul berwarna status dan deskripsi `foreground`; `default` memakai `card` dengan `border`.

## Varian

| Varian | Pakai untuk |
| --- | --- |
| `default` | Kabar netral, misalnya laporan yang sudah siap. |
| `info` | Hal yang perlu diketahui, misalnya rilis yang dijadwalkan. |
| `success` | Keadaan yang berhasil, misalnya rilis yang terkirim. |
| `warning` | Hal yang perlu segera diperhatikan, misalnya langganan yang hampir habis. |
| `destructive` | Sesuatu yang gagal atau ditolak, misalnya rilis yang ditolak. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | `ShadAlert` / `ShadAlert.destructive`, warna status dari `context.sosialoka` | teks | `default` | Statusnya. |
| `AlertTitle` | `AlertTitle` | `title` | teks | tidak ada | Judul singkat. |
| `AlertDescription` | `AlertDescription` | `description` | teks | tidak ada | Satu kalimat tentang apa yang perlu dilakukan. |
| ikon sebagai anak pertama | ikon sebagai anak pertama | `icon` | elemen | tidak ada | Ikon Lucide untuk statusnya. |

## Kode

**React**
```tsx
import { CircleAlertIcon, CircleCheckIcon, InfoIcon, TriangleAlertIcon, type LucideIcon } from "lucide-react"
import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert"

const alerts: { variant: "default" | "info" | "success" | "warning" | "destructive"; icon: LucideIcon; title: string; description: string }[] = [
  { variant: "default", icon: InfoIcon, title: "Laporan bulan ini sudah siap", description: "Kamu bisa mengunduhnya dari menu Royalti." },
  { variant: "info", icon: InfoIcon, title: "Rilis dijadwalkan", description: "\"Senja di Kota\" tayang 1 Des 2026 pukul 00.00 WIB." },
  { variant: "success", icon: CircleCheckIcon, title: "Rilis terkirim", description: "Semua toko musik sudah menerima \"Kaset Pertama\"." },
  { variant: "warning", icon: TriangleAlertIcon, title: "Langgananmu hampir habis", description: "Masa langgananmu habis 3 hari lagi." },
  { variant: "destructive", icon: CircleAlertIcon, title: "Rilis ditolak", description: "Sampulnya belum sesuai aturan toko musik." },
]

export default function AlertDemo() {
  return (
    <div className="grid w-full max-w-md gap-3">
      {alerts.map(({ variant, icon: Icon, title, description }) => (
        <Alert key={variant} variant={variant}>
          <Icon />
          <AlertTitle>{title}</AlertTitle>
          <AlertDescription>{description}</AlertDescription>
        </Alert>
      ))}
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { CircleAlertIcon, CircleCheckIcon, InfoIcon, TriangleAlertIcon } from "@lucide/vue"
import { Alert, AlertDescription, AlertTitle } from "@/components/ui/alert"

const alerts = [
  { variant: "default", icon: InfoIcon, title: "Laporan bulan ini sudah siap", description: "Kamu bisa mengunduhnya dari menu Royalti." },
  { variant: "info", icon: InfoIcon, title: "Rilis dijadwalkan", description: "\"Senja di Kota\" tayang 1 Des 2026 pukul 00.00 WIB." },
  { variant: "success", icon: CircleCheckIcon, title: "Rilis terkirim", description: "Semua toko musik sudah menerima \"Kaset Pertama\"." },
  { variant: "warning", icon: TriangleAlertIcon, title: "Langgananmu hampir habis", description: "Masa langgananmu habis 3 hari lagi." },
  { variant: "destructive", icon: CircleAlertIcon, title: "Rilis ditolak", description: "Sampulnya belum sesuai aturan toko musik." },
] as const
</script>

<template>
  <div class="grid w-full max-w-md gap-3">
    <Alert v-for="a in alerts" :key="a.variant" :variant="a.variant">
      <component :is="a.icon" />
      <AlertTitle>{{ a.title }}</AlertTitle>
      <AlertDescription>{{ a.description }}</AlertDescription>
    </Alert>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

class AlertDemo extends StatelessWidget {
  const AlertDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final c = context.sosialoka;
    final theme = ShadTheme.of(context);
    // Status alerts: the soft status surface, the icon and title in the status color.
    ShadAlert status(Color color, Color soft, IconData icon, String title, String description) => ShadAlert(
          icon: Icon(icon),
          iconColor: color,
          title: Text(title),
          titleStyle: theme.textTheme.p.copyWith(color: color, fontWeight: FontWeight.w500),
          description: Text(description),
          decoration: ShadDecoration(color: soft, border: ShadBorder.none),
        );
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        spacing: 12,
        children: [
          const ShadAlert(
            icon: Icon(LucideIcons.info),
            title: Text('Laporan bulan ini sudah siap'),
            description: Text('Kamu bisa mengunduhnya dari menu Royalti.'),
          ),
          status(c.info, c.infoSoft, LucideIcons.info, 'Rilis dijadwalkan', '"Senja di Kota" tayang 1 Des 2026 pukul 00.00 WIB.'),
          status(c.success, c.successSoft, LucideIcons.circleCheck, 'Rilis terkirim', 'Semua toko musik sudah menerima "Kaset Pertama".'),
          status(c.warning, c.warningSoft, LucideIcons.triangleAlert, 'Langgananmu hampir habis', 'Masa langgananmu habis 3 hari lagi.'),
          status(c.destructive, c.destructiveSoft, LucideIcons.circleAlert, 'Rilis ditolak', 'Sampulnya belum sesuai aturan toko musik.'),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/alert.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/alert.json
```

## Aksesibilitas

- Punya `role="alert"`, jadi pembaca layar membacakannya saat muncul. Render alert yang sudah ada sejak awal bersama halamannya, supaya tidak dibacakan ulang setiap ada perubahan.
- Statusnya juga tertulis di judul, tidak hanya lewat warna.
- Ikonnya dekoratif.


---

# Card

> Mengelompokkan isi yang saling terkait di permukaannya sendiri.

Card mengelompokkan isi yang saling terkait, misalnya satu rilisan atau satu dokumen, di permukaannya sendiri.

## Kapan dipakai

- Pakai untuk item yang berdiri sendiri, dengan judul dan biasanya aksi.
- Untuk membagi satu form atau halaman yang panjang, pakai section biasa, bukan card.
- Jangan menaruh card di dalam card.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/card/_

### Lakukan dan jangan

- **Lakukan:** Pisahkan kartu dari halaman dengan garis tepi.
- **Jangan:** Jangan beri bayangan pada setiap kartu; bayangan hanya untuk yang melayang di atas halaman.

## Anatomi

1. Header: judul dan deskripsi
2. Isi
3. Footer dengan aksi

Header (judul, deskripsi, aksi opsional), isi, lalu footer berisi aksi. Card berlatar `card` dengan garis `border` dan `radius-lg` (12px). Bawaannya tanpa bayangan, karena garis tepi sudah memisahkannya dari halaman. Tambahkan `shadow-md` hanya untuk card yang melayang, seperti kartu header di dasbor.

## Varian

Hanya ada satu gaya. Tambahkan `shadow-md` untuk card yang melayang.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `CardHeader`, `CardTitle`, `CardDescription` | nama yang sama | `title`, `description` | elemen | tidak ada | Area judul. |
| `CardContent` | `CardContent` | `child` | elemen | tidak ada | Isi. |
| `CardFooter` | `CardFooter` | `footer` | elemen | tidak ada | Aksi. |
| `className` | `class` | `width`, `padding` | string | tidak ada | Ukuran dan bayangan melayang. |

## Kode

**React**
```tsx
import { Button } from "@/components/ui/button"
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card"

export default function CardDemo() {
  return (
    <Card className="w-full max-w-sm">
      <CardHeader>
        <CardTitle>Rilis baru</CardTitle>
        <CardDescription>Single "Senja di Kota" siap dikirim ke semua platform.</CardDescription>
      </CardHeader>
      <CardContent>
        <p className="text-sm text-muted-foreground">Periksa metadata dan artwork sebelum kamu kirim.</p>
      </CardContent>
      <CardFooter className="gap-2">
        <Button>Kirim</Button>
        <Button variant="outline">Periksa dulu</Button>
      </CardFooter>
    </Card>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Button } from "@/components/ui/button"
import {
  Card,
  CardContent,
  CardDescription,
  CardFooter,
  CardHeader,
  CardTitle,
} from "@/components/ui/card"
</script>

<template>
  <Card class="w-full max-w-sm">
    <CardHeader>
      <CardTitle>Rilis baru</CardTitle>
      <CardDescription>Single "Senja di Kota" siap dikirim ke semua platform.</CardDescription>
    </CardHeader>
    <CardContent>
      <p class="text-sm text-muted-foreground">Periksa metadata dan artwork sebelum kamu kirim.</p>
    </CardContent>
    <CardFooter class="gap-2">
      <Button>Kirim</Button>
      <Button variant="outline">Periksa dulu</Button>
    </CardFooter>
  </Card>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class CardDemo extends StatelessWidget {
  const CardDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ShadCard(
      width: 384,
      title: Text('Rilis baru', style: theme.textTheme.h4),
      description: const Text('Single "Senja di Kota" siap dikirim ke semua platform.'),
      footer: Row(
        children: [
          ShadButton(onPressed: () {}, child: const Text('Kirim')),
          const SizedBox(width: 8),
          ShadButton.outline(onPressed: () {}, child: const Text('Periksa dulu')),
        ],
      ),
      child: const Padding(
        padding: EdgeInsets.symmetric(vertical: 16),
        child: Text('Periksa metadata dan artwork sebelum kamu kirim.'),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/card.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/card.json
```

## Aksesibilitas

- Card hanyalah wadah. Kalau card memulai sebuah bagian, beri judulnya level heading yang benar di halamanmu.
- Cukup satu aksi utama per card, supaya footer-nya mudah dibaca.


---

# Carousel

> Menggeser deretan kartu, misalnya rilis terbaru.

Carousel menampilkan deretan kartu yang bisa digeser, misalnya rilis terbaru atau sorotan di layar beranda.

## Kapan dipakai

- Pakai untuk konten yang boleh terlewat, misalnya rilis atau sorotan.
- Jangan taruh informasi wajib di dalamnya: yang ada di luar layar mungkin tidak pernah terlihat.
- Jangan pakai autoplay.
- Tampilkan tepi kartu berikutnya, supaya orang tahu masih ada lagi.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/carousel/_

## Anatomi

1. Slide saat ini
2. Slide berikutnya, terlihat sebagian
3. Titik posisi

Kartu berderet dengan jarak 16px, plus tombol sebelumnya dan berikutnya `outline` berbentuk kotak (bukan pil) yang nonaktif di ujung. Di HP tombolnya disembunyikan dan orang cukup menggeser; halaman tidak pernah bergulir ke samping.

Di HP, `CarouselDots` di bawah deretan kartu boleh menunjukkan posisi, karena orang menggeser tanpa melihat tombol:

- Satu titik per perhentian: 6px, `radius-full`, berjarak 4px, di tengah 12px di bawah kartu.
- Titik slide yang sedang tampil selebar 20px dengan warna `primary`; sisanya `input`.
- Pakai titik untuk maksimal 5 slide. Lebih dari itu, jangan pakai titik.
- Titik hanya menunjukkan posisi. Titik bukan tombol, dan pembaca layar melewatinya.

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `opts` | `:opts` | `PageController(viewportFraction: 0.85)` | opsi Embla | tidak ada | Misalnya `{ align: "start" }`. |
| `CarouselItem aria-label` | sama | `Semantics label` | teks | tidak ada | Posisi slide, misalnya "1 dari 5". |
| `CarouselPrevious label`, `CarouselNext label` | sama | `Semantics label` | teks | `Previous slide`, `Next slide` | Nama tombol, misalnya "Sebelumnya". |
| `CarouselDots max` | `CarouselDots :max` | baris titik (lihat kode Flutter) | angka | `5` | Titik posisi untuk HP; kalau perhentiannya lebih dari ini, titik tidak tampil. |
| `setApi` | `@init-api` | controller-nya | fungsi | tidak ada | Membaca atau menggeser carousel dari luar. |

## Kode

**React**
```tsx
import { MusicIcon } from "lucide-react"
import { Carousel, CarouselContent, CarouselDots, CarouselItem, CarouselNext, CarouselPrevious } from "@/components/ui/carousel"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika" },
  { title: "Kaset Pertama", artist: "Bima Laras" },
  { title: "Pulang Sore", artist: "Nada Kirana" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening" },
  { title: "Lampu Kota", artist: "Sinta Maharani" },
]

export default function CarouselDemo() {
  return (
    <Carousel aria-label="Rilis terbaru" opts={{ align: "start" }} className="w-full max-w-md sm:mx-12">
      <CarouselContent>
        {releases.map((r, i) => (
          <CarouselItem key={r.title} aria-label={`${i + 1} dari ${releases.length}`} className="basis-2/3 sm:basis-1/2">
            <div className="flex flex-col gap-2">
              <div className="flex aspect-square items-center justify-center rounded-lg bg-muted">
                <MusicIcon aria-hidden="true" className="size-6 text-muted-foreground" />
              </div>
              <div className="text-sm">
                <p className="truncate font-medium">{r.title}</p>
                <p className="truncate text-muted-foreground">{r.artist}</p>
              </div>
            </div>
          </CarouselItem>
        ))}
      </CarouselContent>
      <CarouselPrevious label="Sebelumnya" />
      <CarouselNext label="Berikutnya" />
      <CarouselDots />
    </Carousel>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Music } from "@lucide/vue"
import { Carousel, CarouselContent, CarouselDots, CarouselItem, CarouselNext, CarouselPrevious } from "@/components/ui/carousel"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika" },
  { title: "Kaset Pertama", artist: "Bima Laras" },
  { title: "Pulang Sore", artist: "Nada Kirana" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening" },
  { title: "Lampu Kota", artist: "Sinta Maharani" },
]
</script>

<template>
  <Carousel aria-label="Rilis terbaru" :opts="{ align: 'start' }" class="w-full max-w-md sm:mx-12">
    <CarouselContent>
      <CarouselItem v-for="(r, i) in releases" :key="r.title" :aria-label="`${i + 1} dari ${releases.length}`" class="basis-2/3 sm:basis-1/2">
        <div class="flex flex-col gap-2">
          <div class="flex aspect-square items-center justify-center rounded-lg bg-muted">
            <Music aria-hidden="true" class="size-6 text-muted-foreground" />
          </div>
          <div class="text-sm">
            <p class="truncate font-medium">
              {{ r.title }}
            </p>
            <p class="truncate text-muted-foreground">
              {{ r.artist }}
            </p>
          </div>
        </div>
      </CarouselItem>
    </CarouselContent>
    <CarouselPrevious label="Sebelumnya" />
    <CarouselNext label="Berikutnya" />
    <CarouselDots />
  </Carousel>
</template>
```

**Flutter**
```dart
// A PageView that shows a peek of the next card. Wide screens get previous and next buttons with a "2 dari 5"
// count; phones, where people swipe, get position dots instead (hidden from screen readers, as each slide says
// its own position).
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const _releases = [
  (title: 'Senja di Kota', artist: 'Rara Senandika'),
  (title: 'Kaset Pertama', artist: 'Bima Laras'),
  (title: 'Pulang Sore', artist: 'Nada Kirana'),
  (title: 'Hujan Bulan Juni', artist: 'Arka Wening'),
  (title: 'Lampu Kota', artist: 'Sinta Maharani'),
];

class CarouselDemo extends StatefulWidget {
  const CarouselDemo({super.key});

  @override
  State<CarouselDemo> createState() => _CarouselDemoState();
}

class _CarouselDemoState extends State<CarouselDemo> {
  final controller = PageController(viewportFraction: 0.85);
  int page = 0;

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  void go(int to) =>
      controller.animateToPage(to, duration: const Duration(milliseconds: 300), curve: Curves.easeOutCubic);

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final phone = MediaQuery.sizeOf(context).width < 640;
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          SizedBox(
            height: 240,
            child: PageView.builder(
              controller: controller,
              itemCount: _releases.length,
              onPageChanged: (value) => setState(() => page = value),
              itemBuilder: (context, i) => Semantics(
                container: true,
                label: '${i + 1} dari ${_releases.length}',
                child: Padding(
                  padding: const EdgeInsets.symmetric(horizontal: 6),
                  child: Column(
                    crossAxisAlignment: CrossAxisAlignment.start,
                    children: [
                      Expanded(
                        child: Container(
                          decoration: BoxDecoration(
                            color: theme.colorScheme.muted,
                            borderRadius: BorderRadius.circular(8),
                          ),
                          alignment: Alignment.center,
                          child: Icon(LucideIcons.music, color: theme.colorScheme.mutedForeground),
                        ),
                      ),
                      const SizedBox(height: 8),
                      Text(_releases[i].title, style: const TextStyle(fontWeight: FontWeight.w500)),
                      Text(_releases[i].artist, style: theme.textTheme.muted),
                    ],
                  ),
                ),
              ),
            ),
          ),
          const SizedBox(height: 12),
          if (phone)
            ExcludeSemantics(
              child: Row(
                mainAxisAlignment: MainAxisAlignment.center,
                spacing: 4,
                children: [
                  for (var i = 0; i < _releases.length; i++)
                    AnimatedContainer(
                      key: ValueKey('dot-$i'),
                      duration: const Duration(milliseconds: 200),
                      width: i == page ? 20 : 6,
                      height: 6,
                      decoration: BoxDecoration(
                        color: i == page ? theme.colorScheme.primary : theme.colorScheme.input,
                        borderRadius: BorderRadius.circular(3),
                      ),
                    ),
                ],
              ),
            )
          else
          Row(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Semantics(
                label: 'Sebelumnya',
                button: true,
                // excludeSemantics hides the button's own state, so say here whether it is on.
                enabled: page > 0,
                excludeSemantics: true,
                child: ShadIconButton.outline(
                  icon: const Icon(LucideIcons.chevronLeft, size: 16),
                  onPressed: page == 0 ? null : () => go(page - 1),
                ),
              ),
              const SizedBox(width: 12),
              Text('${page + 1} dari ${_releases.length}', style: theme.textTheme.muted),
              const SizedBox(width: 12),
              Semantics(
                label: 'Berikutnya',
                button: true,
                enabled: page < _releases.length - 1,
                excludeSemantics: true,
                child: ShadIconButton.outline(
                  icon: const Icon(LucideIcons.chevronRight, size: 16),
                  onPressed: page == _releases.length - 1 ? null : () => go(page + 1),
                ),
              ),
            ],
          ),
        ],
      ),
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/carousel.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/carousel.json
```

## Aksesibilitas

- Carousel adalah region dengan `aria-roledescription="carousel"`; beri nama, misalnya "Rilis terbaru".
- Setiap slide adalah group dengan `aria-roledescription="slide"` dan label seperti "1 dari 5".
- Tombol sebelumnya dan berikutnya diberi nama dan nonaktif di ujung.
- Titik diberi `aria-hidden`; posisi disampaikan lewat label slide, misalnya "1 dari 3".
- Tombol panah kiri dan kanan berpindah slide saat fokus ada di dalamnya.


---

# Item

> Baris daftar dengan media, judul, deskripsi, dan aksi.

Item adalah satu baris di daftar: gambar atau ikon, judul, satu baris deskripsi, dan aksi, misalnya artis di daftar atau pengaturan di menu.

## Kapan dipakai

- Pakai untuk daftar di HP dan di panel: artis, rilis, menu akun, pengaturan.
- Pakai [Table](https://design.sosialoka.tech/id/components/table/) untuk data dengan banyak kolom yang dibandingkan.
- Jadikan seluruh baris tautan kalau membuka halaman; pakai tombol terpisah kalau baris punya aksi sendiri.
- Item menjadi baris di pola [Aplikasi mobile](https://design.sosialoka.tech/id/patterns/mobile-app/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/item/_

## Anatomi

1. Avatar atau ikon di depan
2. Judul dan keterangan
3. Chevron di belakang
4. Pemisah

Baris dengan `radius-lg`, `p-3`, dan jarak 12px: media di kiri (Avatar atau ikon 40px), judul (`text-sm font-medium`) dan deskripsi (`text-sm text-muted-foreground`), lalu aksi di kanan. Sebagai tautan, warnanya berubah `accent` saat disorot.

## Varian

| Varian | Pakai untuk |
| --- | --- |
| `default` | Baris di menu atau daftar dengan pemisah. |
| `outline` | Baris yang berdiri sendiri, misalnya kartu di daftar. |
| `muted` | Baris yang butuh permukaan tenang, misalnya ringkasan. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `variant` | `variant` | `ShadItem` / `.outline` / `.muted` | teks | `default` | Tampilan. |
| `size` | `size` | `size` | `default`, `sm`, `xs` (khusus React) | `default` | Padding. |
| `render={<a href />}` | `as-child` dengan tautan | `onPressed` | elemen | `div` | Menjadikan seluruh baris tautan. |
| `ItemMedia`, `ItemTitle`, `ItemDescription`, `ItemActions` | sama | `media`, `title`, `description`, `actions` | elemen | tidak ada | Bagian-bagian baris. |

## Kode

**React**
```tsx
import { Avatar, AvatarFallback } from "@/components/ui/avatar"
import { Button } from "@/components/ui/button"
import { Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemTitle } from "@/components/ui/item"

const artists = [
  { name: "Rara Senandika", initials: "RS", detail: "3 rilis · Pop" },
  { name: "Bima Laras", initials: "BL", detail: "5 rilis · Folk" },
  { name: "Nada Kirana", initials: "NK", detail: "2 rilis · R&B" },
]

export default function ItemDemo() {
  return (
    <ItemGroup className="w-full max-w-md gap-2">
      {artists.map((artist) => (
        <Item key={artist.name} variant="outline">
          <ItemMedia>
            <Avatar>
              <AvatarFallback>{artist.initials}</AvatarFallback>
            </Avatar>
          </ItemMedia>
          <ItemContent>
            <ItemTitle>{artist.name}</ItemTitle>
            <ItemDescription>{artist.detail}</ItemDescription>
          </ItemContent>
          <ItemActions>
            <Button variant="outline" size="sm" aria-label={`Lihat ${artist.name}`}>
              Lihat
            </Button>
          </ItemActions>
        </Item>
      ))}
    </ItemGroup>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Avatar, AvatarFallback } from "@/components/ui/avatar"
import { Button } from "@/components/ui/button"
import { Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemTitle } from "@/components/ui/item"

const artists = [
  { name: "Rara Senandika", initials: "RS", detail: "3 rilis · Pop" },
  { name: "Bima Laras", initials: "BL", detail: "5 rilis · Folk" },
  { name: "Nada Kirana", initials: "NK", detail: "2 rilis · R&B" },
]
</script>

<template>
  <ItemGroup class="w-full max-w-md gap-2">
    <Item v-for="artist in artists" :key="artist.name" variant="outline">
      <ItemMedia>
        <Avatar>
          <AvatarFallback>{{ artist.initials }}</AvatarFallback>
        </Avatar>
      </ItemMedia>
      <ItemContent>
        <ItemTitle>{{ artist.name }}</ItemTitle>
        <ItemDescription>{{ artist.detail }}</ItemDescription>
      </ItemContent>
      <ItemActions>
        <Button variant="outline" size="sm" :aria-label="`Lihat ${artist.name}`">Lihat</Button>
      </ItemActions>
    </Item>
  </ItemGroup>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const itemArtists = [('Rara Senandika', 'RS', '3 rilis · Pop'), ('Bima Laras', 'BL', '5 rilis · Folk'), ('Nada Kirana', 'NK', '2 rilis · R&B')];

class ItemDemo extends StatelessWidget {
  const ItemDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        spacing: 8,
        children: [
          for (final (name, initials, detail) in itemArtists)
            ShadItem.outline(
              media: ShadAvatar(null, placeholder: Text(initials)),
              title: Text(name),
              description: Text(detail),
              actions: Semantics(
                label: 'Lihat $name',
                button: true,
                child: ExcludeSemantics(child: ShadButton.outline(size: ShadButtonSize.sm, onPressed: () {}, child: const Text('Lihat'))),
              ),
            ),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/item.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/item.json
```

## Aksesibilitas

- Beri nama setiap aksi beserta objeknya: "Lihat Rara Senandika", bukan hanya "Lihat".
- Kalau seluruh baris berupa tautan, jangan taruh tombol lain di dalamnya.
- Taruh item di dalam daftar (`ItemGroup`) supaya pembaca layar menyebut jumlahnya.


---

# Accordion

> Menampilkan dan menyembunyikan bagian isi satu per satu.

Accordion menumpuk bagian-bagian di bawah judulnya dan membukanya satu per satu, supaya halaman yang panjang tetap ringkas.

## Kapan dipakai

- Pakai untuk tanya jawab, kelompok pengaturan, dan detail yang hanya dibutuhkan sebagian orang.
- Pakai [Tabs](https://design.sosialoka.tech/id/components/tabs/) untuk berpindah antartampilan dari hal yang sama, dan halaman biasa kalau setiap bagian penting.
- Jangan sembunyikan informasi wajib di bagian yang tertutup: orang mungkin tidak pernah membukanya.
- Di HP, accordion juga mengubah baris tabel menjadi bagian-bagian; lihat pola [Tabel responsif](https://design.sosialoka.tech/id/patterns/responsive-table/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/accordion/_

## Anatomi

1. Header bagian yang terbuka
2. Isi
3. Bagian yang tertutup
4. Chevron

Item dipisahkan `border-b` berwarna `border`. Setiap item punya trigger (`py-4 text-sm font-medium`, dengan chevron yang berputar 180° saat terbuka) dan isinya (`pb-4 text-sm`).

## Varian

| Mode | Pakai untuk |
| --- | --- |
| Satu terbuka (bawaan) | Tanya jawab, cukup satu jawaban yang dibaca. |
| Beberapa terbuka (`multiple`) | Kelompok pengaturan yang dibandingkan. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `multiple` | `type="single"` / `"multiple"` | `ShadAccordion` / `ShadAccordion.multiple` | mode | satu terbuka | Berapa bagian yang boleh terbuka. |
| selalu bisa ditutup | `collapsible` | selalu bisa ditutup | boolean | `false` di Vue | Bagian yang terbuka bisa ditutup lagi. |
| `value` / `defaultValue` | `v-model` / `default-value` | `initialValue` | nilai | tidak ada | Bagian yang terbuka. |
| `AccordionItem value` | `AccordionItem value` | `ShadAccordionItem value` | nilai | tidak ada | Nama satu bagian. |

## Kode

**React**
```tsx
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion"

const questions = [
  { q: "Berapa lama clearance selesai?", a: "Biasanya 5–7 hari kerja setelah dokumenmu lengkap. Kamu dapat kabar di setiap langkah." },
  { q: "Lagu apa saja yang bisa kamu cover?", a: "Lagu yang ada di katalog kami. Cari judulnya di menu Katalog." },
  { q: "Kapan royalti dibayar?", a: "Setiap bulan, paling lambat tanggal 25, ke rekening yang terdaftar di akunmu." },
]

export default function AccordionDemo() {
  return (
    <Accordion className="w-full max-w-md">
      {questions.map(({ q, a }) => (
        <AccordionItem key={q} value={q}>
          <AccordionTrigger>{q}</AccordionTrigger>
          <AccordionContent>{a}</AccordionContent>
        </AccordionItem>
      ))}
    </Accordion>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion"

const questions = [
  { q: "Berapa lama clearance selesai?", a: "Biasanya 5–7 hari kerja setelah dokumenmu lengkap. Kamu dapat kabar di setiap langkah." },
  { q: "Lagu apa saja yang bisa kamu cover?", a: "Lagu yang ada di katalog kami. Cari judulnya di menu Katalog." },
  { q: "Kapan royalti dibayar?", a: "Setiap bulan, paling lambat tanggal 25, ke rekening yang terdaftar di akunmu." },
]
</script>

<template>
  <Accordion type="single" collapsible class="w-full max-w-md">
    <AccordionItem v-for="item in questions" :key="item.q" :value="item.q">
      <AccordionTrigger>{{ item.q }}</AccordionTrigger>
      <AccordionContent>{{ item.a }}</AccordionContent>
    </AccordionItem>
  </Accordion>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const questions = [
  ('Berapa lama clearance selesai?', 'Biasanya 5–7 hari kerja setelah dokumenmu lengkap. Kamu dapat kabar di setiap langkah.'),
  ('Lagu apa saja yang bisa kamu cover?', 'Lagu yang ada di katalog kami. Cari judulnya di menu Katalog.'),
  ('Kapan royalti dibayar?', 'Setiap bulan, paling lambat tanggal 25, ke rekening yang terdaftar di akunmu.'),
];

class AccordionDemo extends StatelessWidget {
  const AccordionDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: ShadAccordion<int>(
        children: [
          for (var i = 0; i < questions.length; i++)
            ShadAccordionItem(value: i, title: Text(questions[i].$1), child: Text(questions[i].$2)),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/accordion.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/accordion.json
```

## Aksesibilitas

- Setiap trigger berupa tombol dengan `aria-expanded` dan `aria-controls` yang menunjuk ke isinya.
- Enter dan Spasi membuka dan menutup bagian; Tab berpindah antartrigger.
- Tulis teks trigger sebagai pertanyaan atau judul utuh, supaya tetap jelas saat dibaca sendiri.


---

# Separator

> Garis tipis di antara kelompok.

Separator menggambar garis tipis di antara kelompok isi, misalnya bagian-bagian kartu atau menu.

## Kapan dipakai

- Pakai di antara kelompok yang masih satu kesatuan tapi dibaca terpisah, misalnya profil dan statistik di kartu artis.
- Utamakan jarak dulu; tambahkan garis hanya kalau jarak saja belum cukup memisahkan.
- Pakai `vertical` di antara item dalam satu baris, misalnya tombol toolbar.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/separator/_

## Anatomi

1. Pemisah horizontal
2. Pemisah vertikal

Garis 1px berwarna `border`, mendatar secara bawaan.

## Varian

| Orientasi | Pakai untuk |
| --- | --- |
| `horizontal` (bawaan) | Di antara kelompok yang bertumpuk. |
| `vertical` | Di antara item dalam satu baris. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `orientation` | `orientation` | `ShadSeparator.horizontal` / `.vertical` | teks | `horizontal` | Arah garis. |
| selalu `role="separator"` | `decorative` | tidak dibacakan | boolean | `true` di Vue | Apakah pembaca layar mendengarnya. |

## Kode

**React**
```tsx
import { Separator } from "@/components/ui/separator"

export default function SeparatorDemo() {
  return (
    <div className="w-full max-w-xs rounded-lg border border-border bg-card p-4 text-sm">
      <p className="font-medium">Rara Senandika</p>
      <p className="text-muted-foreground">Penyanyi pop, Bandung</p>
      <Separator className="my-3" />
      <p className="text-muted-foreground">3 rilis · 12.480 pendengar bulanan</p>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Separator } from "@/components/ui/separator"
</script>

<template>
  <div class="w-full max-w-xs rounded-lg border border-border bg-card p-4 text-sm">
    <p class="font-medium">Rara Senandika</p>
    <p class="text-muted-foreground">Penyanyi pop, Bandung</p>
    <Separator :decorative="false" class="my-3" />
    <p class="text-muted-foreground">3 rilis · 12.480 pendengar bulanan</p>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class SeparatorDemo extends StatelessWidget {
  const SeparatorDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return SizedBox(
      width: 320,
      child: ShadCard(
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text('Rara Senandika', style: theme.textTheme.small),
            Text('Penyanyi pop, Bandung', style: theme.textTheme.muted),
            const ShadSeparator.horizontal(margin: EdgeInsets.symmetric(vertical: 12)),
            Text('3 rilis · 12.480 pendengar bulanan', style: theme.textTheme.muted),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/separator.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/separator.json
```

## Aksesibilitas

- Separator di antara bagian yang sungguhan punya `role="separator"`; garis yang hanya hiasan disembunyikan dari pembaca layar (`decorative` di Vue).
- Separator tidak pernah menerima fokus.


---

# Tabs

> Berpindah antartampilan dari isi yang sama.

Tabs memindahkan tampilan dari isi yang sama, misalnya ringkasan, rilis, dan royalti satu artis.

## Kapan dipakai

- Pakai untuk 2 sampai 6 tampilan yang setara.
- Pastikan isi setiap tab saling terkait. Isi yang tidak terkait ditaruh di halaman terpisah.
- Jangan pakai tabs sebagai langkah-langkah proses; pakai stepper.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/tabs/_

## Anatomi

1. Tab aktif
2. Indikator di primary
3. Tab
4. Panel

Deretan label di atas garis `border`, dan isi tab aktif di bawahnya. Tab aktif memakai teks `foreground` dengan garis 2px `primary` di bawahnya, sedangkan yang lain memakai `muted-foreground`. Tinggi tab 36px, dan tidak pernah berada di atas latar pil.

## Varian

Hanya ada satu gaya, mendatar atau tegak (`orientation="vertical"`). Di tabs tegak, garisnya pindah ke tepi kanan.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `defaultValue` / `value` | `default-value` / `v-model` | `value` | string | tidak ada | Tab yang aktif. |
| `onValueChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat tab berganti. |
| `orientation` | `orientation` | tidak ada | `horizontal` \| `vertical` | `horizontal` | Arah daftar tab. |

## Kode

**React**
```tsx
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"

export default function TabsDemo() {
  return (
    <Tabs defaultValue="ringkasan" className="w-full max-w-md">
      <TabsList>
        <TabsTrigger value="ringkasan">Ringkasan</TabsTrigger>
        <TabsTrigger value="rilis">Rilis</TabsTrigger>
        <TabsTrigger value="royalti">Royalti</TabsTrigger>
      </TabsList>
      <TabsContent value="ringkasan" className="pt-3 text-muted-foreground">12 rilis aktif bulan ini.</TabsContent>
      <TabsContent value="rilis" className="pt-3 text-muted-foreground">3 rilis menunggu dikirim.</TabsContent>
      <TabsContent value="royalti" className="pt-3 text-muted-foreground">Laporan Oktober sudah masuk.</TabsContent>
    </Tabs>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"
</script>

<template>
  <Tabs default-value="ringkasan" class="w-full max-w-md">
    <TabsList>
      <TabsTrigger value="ringkasan">Ringkasan</TabsTrigger>
      <TabsTrigger value="rilis">Rilis</TabsTrigger>
      <TabsTrigger value="royalti">Royalti</TabsTrigger>
    </TabsList>
    <TabsContent value="ringkasan" class="pt-3 text-muted-foreground">12 rilis aktif bulan ini.</TabsContent>
    <TabsContent value="rilis" class="pt-3 text-muted-foreground">3 rilis menunggu dikirim.</TabsContent>
    <TabsContent value="royalti" class="pt-3 text-muted-foreground">Laporan Oktober sudah masuk.</TabsContent>
  </Tabs>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class TabsDemo extends StatelessWidget {
  const TabsDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadTabs<String>(
      value: 'ringkasan',
      // Tabs share the bar width equally; leave room for the longest label.
      tabBarConstraints: const BoxConstraints(maxWidth: 520),
      tabs: const [
        ShadTab(value: 'ringkasan', content: Text('12 rilis aktif bulan ini.'), child: Text('Ringkasan')),
        ShadTab(value: 'rilis', content: Text('3 rilis menunggu dikirim.'), child: Text('Rilis')),
        ShadTab(value: 'royalti', content: Text('Laporan Oktober sudah masuk.'), child: Text('Royalti')),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/tabs.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/tabs.json
```

## Aksesibilitas

- Dirender dengan `role="tablist"`, `tab`, dan `tabpanel`, dengan `aria-selected` di tab aktif.
- Tombol panah berpindah antartab, dan Tab masuk ke panel.


---

# Breadcrumb

> Menunjukkan letak halaman dan menautkan kembali ke induknya.

Breadcrumb menunjukkan jalur dari sebuah bagian ke halaman saat ini, dan menautkan setiap langkahnya kembali.

## Kapan dipakai

- Pakai di halaman yang dua tingkat atau lebih di dalam, misalnya metadata satu rilis.
- Taruh di atas judul halaman. Pola [Detail](https://design.sosialoka.tech/id/patterns/detail/) menunjukkan letaknya.
- Jangan pakai di halaman tingkat atas; sidebar sudah menunjukkan posisimu.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/breadcrumb/_

## Anatomi

1. Link ke halaman induk
2. Pemisah
3. Halaman saat ini

Tautan berukuran `text-sm text-muted-foreground`, dipisahkan chevron 14px. Halaman saat ini menjadi item terakhir, berwarna `text-foreground font-medium`, dan bukan tautan. Di bawah `sm`, ringkas level tengah menjadi ellipsis.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `BreadcrumbLink href` | `BreadcrumbLink href` | `ShadBreadcrumbLink onPressed` | tautan | tidak ada | Halaman induk. |
| `BreadcrumbPage` | `BreadcrumbPage` | `Text` | teks | tidak ada | Halaman saat ini, bukan tautan. |
| `BreadcrumbSeparator` | `BreadcrumbSeparator` | `separator` | elemen | chevron | Tanda di antara langkah. |
| `BreadcrumbEllipsis` | `BreadcrumbEllipsis` | `ShadBreadcrumbEllipsis` | elemen | tidak ada | Pengganti level tengah yang disembunyikan. |

## Kode

**React**
```tsx
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"

export default function BreadcrumbDemo() {
  return (
    <Breadcrumb>
      <BreadcrumbList>
        <BreadcrumbItem>
          <BreadcrumbLink href="#">Rilis</BreadcrumbLink>
        </BreadcrumbItem>
        <BreadcrumbSeparator />
        <BreadcrumbItem>
          <BreadcrumbLink href="#">Senja di Kota</BreadcrumbLink>
        </BreadcrumbItem>
        <BreadcrumbSeparator />
        <BreadcrumbItem>
          <BreadcrumbPage>Ubah metadata</BreadcrumbPage>
        </BreadcrumbItem>
      </BreadcrumbList>
    </Breadcrumb>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"
</script>

<template>
  <Breadcrumb>
    <BreadcrumbList>
      <BreadcrumbItem>
        <BreadcrumbLink href="#">Rilis</BreadcrumbLink>
      </BreadcrumbItem>
      <BreadcrumbSeparator />
      <BreadcrumbItem>
        <BreadcrumbLink href="#">Senja di Kota</BreadcrumbLink>
      </BreadcrumbItem>
      <BreadcrumbSeparator />
      <BreadcrumbItem>
        <BreadcrumbPage>Ubah metadata</BreadcrumbPage>
      </BreadcrumbItem>
    </BreadcrumbList>
  </Breadcrumb>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class BreadcrumbDemo extends StatelessWidget {
  const BreadcrumbDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadBreadcrumb(
      children: [
        ShadBreadcrumbLink(onPressed: () {}, child: const Text('Rilis')),
        ShadBreadcrumbLink(onPressed: () {}, child: const Text('Senja di Kota')),
        // The current page is plain text, not a link.
        Semantics(selected: true, child: const Text('Ubah metadata')),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/breadcrumb.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/breadcrumb.json
```

## Aksesibilitas

- Breadcrumb berupa `nav` bernama "breadcrumb", dengan langkah-langkahnya dalam daftar berurut.
- Halaman saat ini punya `aria-current="page"`.
- Pemisah disembunyikan dari pembaca layar.


---

# Stepper

> Menunjukkan langkah-langkah alur dan langkah yang sedang dijalani.

Stepper menunjukkan langkah-langkah sebuah alur, mana yang sudah selesai, dan langkah yang sedang dijalani, misalnya saat mengajukan clearance.

## Kapan dipakai

- Pakai untuk alur 3 sampai 6 langkah yang dijalani berurutan.
- Beri nama setiap langkah dengan kata benda singkat: "Data rilis", "Dokumen".
- Simpan draf di setiap langkah, supaya orang bisa berhenti dan kembali lagi: "Simpan dulu, lanjutkan kapan saja."
- Kalau formnya pendek, pakai satu halaman dengan beberapa bagian saja.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/stepper/_

## Anatomi

1. Langkah selesai
2. Langkah saat ini
3. Langkah berikutnya
4. Penghubung

Daftar langkah berurut. Setiap langkah berupa lingkaran 32px dengan namanya di bawah, disambung ke langkah berikutnya dengan garis 1px.

| Status | Lingkaran | Garis ke langkah berikutnya |
| --- | --- | --- |
| Selesai | `primary-soft` dengan centang, warna `primary-text` | `primary` |
| Saat ini | `primary` dengan nomor, warna `primary-foreground` | `border` |
| Berikutnya | `muted` dengan nomor, warna `muted-foreground` | `border` |

Di bawah `sm`, hanya nama langkah saat ini yang tampil, dengan baris seperti "Langkah 2 dari 4" di bawah stepper; pembaca layar tetap membacakan semua nama.

## Varian

Hanya ada satu gaya, mendatar.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` | `v-model` | dibangun dari `Row` (`shadcn_ui` belum punya stepper) | angka | tidak ada (React), `1` (Vue) | Langkah saat ini, mulai dari 1. |
| `completedText` | `completed-text` | `Semantics label` | teks | `completed` | Dibacakan setelah setiap langkah yang selesai, misalnya "selesai". |
| `StepperItem step` | `StepperItem :step` | indeksnya | angka | tidak ada | Nomor langkah. |
| `StepperTitle`, `StepperDescription` | sama | `Text` | teks | tidak ada | Nama langkah dan baris tambahan opsional. |

## Kode

**React**
```tsx
import { useState } from "react"
import { Button } from "@/components/ui/button"
import { Stepper, StepperIndicator, StepperItem, StepperSeparator, StepperTitle } from "@/components/ui/stepper"

const steps = ["Pilih lagu", "Data rilis", "Dokumen", "Kirim"]

export default function StepperDemo() {
  const [step, setStep] = useState(2)
  return (
    <div className="grid w-full max-w-xl gap-6">
      <Stepper value={step} completedText="selesai" aria-label="Ajukan clearance">
        {steps.map((title, index) => (
          <StepperItem key={title} step={index + 1}>
            <StepperIndicator />
            <StepperTitle>{title}</StepperTitle>
            {index < steps.length - 1 && <StepperSeparator />}
          </StepperItem>
        ))}
      </Stepper>
      <p className="text-center text-sm text-muted-foreground sm:hidden">
        Langkah {step} dari {steps.length}
      </p>
      <div className="flex justify-between">
        <Button variant="outline" disabled={step === 1} onClick={() => setStep((s) => s - 1)}>
          Kembali
        </Button>
        <Button disabled={step === steps.length} onClick={() => setStep((s) => s + 1)}>
          Lanjut
        </Button>
      </div>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import { Button } from "@/components/ui/button"
import { Stepper, StepperIndicator, StepperItem, StepperSeparator, StepperTitle } from "@/components/ui/stepper"

const steps = ["Pilih lagu", "Data rilis", "Dokumen", "Kirim"]
const step = ref(2)
</script>

<template>
  <div class="grid w-full max-w-xl gap-6">
    <Stepper v-model="step" completed-text="selesai" aria-label="Ajukan clearance">
      <StepperItem v-for="(title, index) in steps" :key="title" :step="index + 1">
        <StepperIndicator />
        <StepperTitle>{{ title }}</StepperTitle>
        <StepperSeparator v-if="index < steps.length - 1" />
      </StepperItem>
    </Stepper>
    <p class="text-center text-sm text-muted-foreground sm:hidden">Langkah {{ step }} dari {{ steps.length }}</p>
    <div class="flex justify-between">
      <Button variant="outline" :disabled="step === 1" @click="step--">Kembali</Button>
      <Button :disabled="step === steps.length" @click="step++">Lanjut</Button>
    </div>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const clearanceSteps = ['Pilih lagu', 'Data rilis', 'Dokumen', 'Kirim'];

// shadcn_ui has no stepper: circles joined by lines, drawn from the theme. On phones only the current
// step's name shows, with "Langkah 2 dari 4" under the steps; every name stays in the semantics.
class StepperDemo extends StatefulWidget {
  const StepperDemo({super.key});

  @override
  State<StepperDemo> createState() => _StepperDemoState();
}

class _StepperDemoState extends State<StepperDemo> {
  int step = 2;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 576),
      child: LayoutBuilder(
        builder: (context, constraints) {
          final compact = constraints.maxWidth < 640;
          return Column(
            mainAxisSize: MainAxisSize.min,
            spacing: 16,
            children: [
              Row(
                crossAxisAlignment: CrossAxisAlignment.start,
                children: [
                  for (var i = 0; i < clearanceSteps.length; i++)
                    Expanded(
                      child: Semantics(
                        label: '${clearanceSteps[i]}${i + 1 < step ? ', selesai' : ''}',
                        selected: i + 1 == step,
                        child: ExcludeSemantics(
                          child: Stack(
                            children: [
                              // The line to the next step: primary once this step is done.
                              if (i < clearanceSteps.length - 1)
                                Positioned(
                                  top: 15.5,
                                  left: 0,
                                  right: 0,
                                  child: FractionalTranslation(
                                    translation: const Offset(0.5, 0),
                                    child: Padding(
                                      padding: const EdgeInsets.symmetric(horizontal: 24),
                                      child: Container(height: 1, color: i + 1 < step ? theme.colorScheme.primary : theme.colorScheme.border),
                                    ),
                                  ),
                                ),
                              Column(
                                children: [
                                  Container(
                                    width: 32,
                                    height: 32,
                                    alignment: Alignment.center,
                                    decoration: BoxDecoration(
                                      shape: BoxShape.circle,
                                      color: i + 1 < step
                                          ? c.primarySoft
                                          : i + 1 == step
                                              ? theme.colorScheme.primary
                                              : theme.colorScheme.muted,
                                    ),
                                    child: i + 1 < step
                                        ? Icon(LucideIcons.check, size: 16, color: c.primaryText)
                                        : Text(
                                            '${i + 1}',
                                            style: theme.textTheme.small.copyWith(
                                              color: i + 1 == step ? theme.colorScheme.primaryForeground : theme.colorScheme.mutedForeground,
                                            ),
                                          ),
                                  ),
                                  if (!compact || i + 1 == step) ...[
                                    const SizedBox(height: 8),
                                    Text(
                                      clearanceSteps[i],
                                      textAlign: TextAlign.center,
                                      style: i + 1 == step ? theme.textTheme.small : theme.textTheme.muted,
                                    ),
                                  ],
                                ],
                              ),
                            ],
                          ),
                        ),
                      ),
                    ),
                ],
              ),
              if (compact) Text('Langkah $step dari ${clearanceSteps.length}', style: theme.textTheme.muted),
              Row(
                mainAxisAlignment: MainAxisAlignment.spaceBetween,
                children: [
                  ShadButton.outline(enabled: step > 1, onPressed: () => setState(() => step--), child: const Text('Kembali')),
                  ShadButton(enabled: step < clearanceSteps.length, onPressed: () => setState(() => step++), child: const Text('Lanjut')),
                ],
              ),
            ],
          );
        },
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/stepper.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/stepper.json
```

## Aksesibilitas

- Stepper berupa daftar berurut; langkah saat ini punya `aria-current="step"`.
- Langkah yang selesai memberi tahu pembaca layar, misalnya "selesai".
- Beri nama daftarnya lewat `aria-label`, misalnya "Ajukan clearance".
- Lingkaran dan garis hanya hiasan; maknanya ada di nama langkah.


---

# Timeline

> Menampilkan apa saja yang terjadi pada sebuah data, terbaru di atas.

Timeline menampilkan riwayat sebuah data, terbaru di atas, misalnya perubahan status clearance atau aktivitas pada kontrak.

## Kapan dipakai

- Pakai untuk riwayat: perubahan status, persetujuan, unggahan, komentar.
- Taruh kejadian terbaru di atas.
- Untuk kejadian yang baru terjadi, tampilkan waktu relatif ("2 jam lalu") dan taruh tanggal lengkapnya di `dateTime` dan `title`; kejadian yang lebih lama menampilkan tanggalnya.
- Untuk langkah yang masih akan dijalani, pakai [Stepper](https://design.sosialoka.tech/id/components/stepper/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/timeline/_

## Anatomi

1. Kejadian terbaru
2. Titik kejadian
3. Garis penghubung
4. Judul dan waktu

Daftar berurut. Setiap kejadian punya titik, garis ke kejadian berikutnya, waktu, judul, dan deskripsi opsional.

| Bagian | Gaya |
| --- | --- |
| Titik | 10px (`size-2.5`), `rounded-full`. Bawaannya `primary`; `success`, `warning`, `destructive`, atau `muted-foreground` sesuai status. |
| Garis | 1px (`w-px`), `border` |
| Waktu | `text-xs`, `muted-foreground`, di elemen `<time>` |
| Judul | `text-sm`, `font-medium` |
| Deskripsi | `text-sm`, `muted-foreground` |

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `TimelineItem status` | `:status` | warna titik dari tema | `default` \| `success` \| `warning` \| `destructive` \| `muted` | `default` | Warna titik. |
| `TimelineTime dateTime` | `datetime` | `Text` | teks | tidak ada | Waktu kejadian yang bisa dibaca mesin. |
| `TimelineTitle`, `TimelineDescription` | sama | `Text` | teks | tidak ada | Apa yang terjadi. |

`shadcn_ui` tidak punya timeline; snippet Flutter menggambar titik dan garisnya dari tema.

## Kode

**React**
```tsx
import { Timeline, TimelineDescription, TimelineItem, TimelineTime, TimelineTitle } from "@/components/ui/timeline"

const events = [
  { status: "success", title: "Disetujui", time: "2026-11-12T14:20", label: "12 Nov 2026, 14.20", text: "Lisensi cover siap dipakai." },
  { status: "default", title: "Ditinjau", time: "2026-11-10T10:05", label: "10 Nov 2026, 10.05", text: "Tim kami memeriksa dokumenmu." },
  { status: "default", title: "Dokumen diterima", time: "2026-11-08T16:40", label: "8 Nov 2026, 16.40", text: "Surat kuasa dan master audio lengkap." },
  { status: "muted", title: "Diajukan", time: "2026-11-05T09:12", label: "5 Nov 2026, 09.12", text: "Kamu mengajukan clearance." },
] as const

export default function TimelineDemo() {
  return (
    <Timeline aria-label="Riwayat clearance Senja di Kota" className="w-full max-w-sm">
      {events.map((e) => (
        <TimelineItem key={e.title} status={e.status}>
          <TimelineTime dateTime={e.time}>{e.label}</TimelineTime>
          <TimelineTitle>{e.title}</TimelineTitle>
          <TimelineDescription>{e.text}</TimelineDescription>
        </TimelineItem>
      ))}
    </Timeline>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Timeline, TimelineDescription, TimelineItem, TimelineTime, TimelineTitle } from "@/components/ui/timeline"

const events = [
  { status: "success", title: "Disetujui", time: "2026-11-12T14:20", label: "12 Nov 2026, 14.20", text: "Lisensi cover siap dipakai." },
  { status: "default", title: "Ditinjau", time: "2026-11-10T10:05", label: "10 Nov 2026, 10.05", text: "Tim kami memeriksa dokumenmu." },
  { status: "default", title: "Dokumen diterima", time: "2026-11-08T16:40", label: "8 Nov 2026, 16.40", text: "Surat kuasa dan master audio lengkap." },
  { status: "muted", title: "Diajukan", time: "2026-11-05T09:12", label: "5 Nov 2026, 09.12", text: "Kamu mengajukan clearance." },
] as const
</script>

<template>
  <Timeline aria-label="Riwayat clearance Senja di Kota" class="w-full max-w-sm">
    <TimelineItem v-for="e in events" :key="e.title" :status="e.status">
      <TimelineTime :datetime="e.time">
        {{ e.label }}
      </TimelineTime>
      <TimelineTitle>{{ e.title }}</TimelineTitle>
      <TimelineDescription>{{ e.text }}</TimelineDescription>
    </TimelineItem>
  </Timeline>
</template>
```

**Flutter**
```dart
// shadcn_ui has no timeline: a column of dots and lines drawn from tokens, newest event on top.
// Each event is one Semantics node, so a screen reader reads title, time and text together.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

enum _Status { success, normal, muted }

const _events = [
  (status: _Status.success, title: 'Disetujui', time: '12 Nov 2026, 14.20', text: 'Lisensi cover siap dipakai.'),
  (status: _Status.normal, title: 'Ditinjau', time: '10 Nov 2026, 10.05', text: 'Tim kami memeriksa dokumenmu.'),
  (status: _Status.normal, title: 'Dokumen diterima', time: '8 Nov 2026, 16.40', text: 'Surat kuasa dan master audio lengkap.'),
  (status: _Status.muted, title: 'Diajukan', time: '5 Nov 2026, 09.12', text: 'Kamu mengajukan clearance.'),
];

class TimelineDemo extends StatelessWidget {
  const TimelineDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    Color dot(_Status s) => switch (s) {
      _Status.success => c.success,
      _Status.normal => theme.colorScheme.primary,
      _Status.muted => theme.colorScheme.mutedForeground,
    };
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          for (final (index, e) in _events.indexed)
            Semantics(
              label: '${e.title}, ${e.time}. ${e.text}',
              child: ExcludeSemantics(
                child: IntrinsicHeight(
                  child: Row(
                    crossAxisAlignment: CrossAxisAlignment.stretch,
                    children: [
                      SizedBox(
                        width: 16,
                        child: Column(
                          children: [
                            const SizedBox(height: 4),
                            Container(
                              width: 10,
                              height: 10,
                              decoration: BoxDecoration(color: dot(e.status), shape: BoxShape.circle),
                            ),
                            if (index < _events.length - 1)
                              Expanded(child: Container(width: 1, color: theme.colorScheme.border)),
                          ],
                        ),
                      ),
                      const SizedBox(width: 12),
                      Expanded(
                        child: Padding(
                          padding: const EdgeInsets.only(bottom: 20),
                          child: Column(
                            crossAxisAlignment: CrossAxisAlignment.start,
                            children: [
                              Text(e.time, style: theme.textTheme.muted),
                              Text(e.title, style: const TextStyle(fontWeight: FontWeight.w500)),
                              Text(e.text, style: theme.textTheme.muted),
                            ],
                          ),
                        ),
                      ),
                    ],
                  ),
                ),
              ),
            ),
        ],
      ),
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/timeline.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/timeline.json
```

## Aksesibilitas

- Timeline adalah daftar; beri nama dengan `aria-label`, misalnya "Riwayat clearance Senja di Kota".
- Judulnya menyebut apa yang terjadi, jadi warna titik tidak pernah menjadi satu-satunya tanda.
- Titik dan garis disembunyikan dari pembaca layar. Di Flutter, setiap kejadian adalah satu node `Semantics` berisi judul, waktu, dan teksnya.


---

# Table

> Menampilkan data dalam baris dan kolom, dengan tata letak datatable bersama dan paginasi.

Tabel menampilkan data dalam baris dan kolom. Semua produk Sosialoka menyusun datatable-nya dengan cara yang sama.

## Kapan dipakai

- Pakai untuk data yang dibandingkan atau dipindai, misalnya rilisan, dokumen, atau pembayaran.
- Pakai card untuk sedikit item yang kaya isi, dan daftar biasa untuk satu kolom teks.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/table/_

### Lakukan dan jangan

- **Lakukan:** Rata kanankan angka dengan angka tabular, supaya digitnya sejajar.
- **Jangan:** Jangan tengahkan angka; besar-kecilnya jadi sulit dibandingkan.

## Anatomi

1. Baris header di muted
2. Baris
3. Badge status

Datatable bersama punya empat bagian:

1. **Header**: nama kolom berwarna `muted-foreground`, tebal medium.
2. **Baris**: garis `border-b border-border` antarbaris, `bg-muted/50` saat di-hover. Status memakai [Badge](https://design.sosialoka.tech/id/components/badge/).
3. **Aksi baris**: tombol ikon ghost yang membuka [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/), di kolom terakhir.
4. **Paginasi**: di bawah tabel, di dalam kartu yang sama. Halaman yang sedang dibuka memakai tombol `outline`.

Taruh tabel di dalam kartu (`rounded-lg border border-border bg-card`) supaya terbaca sebagai satu permukaan.

## Varian

Hanya ada satu gaya. Tambahkan `text-right` dan `tabular-nums` ke kolom angka.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `Table`, `TableHeader`, `TableBody`, `TableRow`, `TableHead`, `TableCell` | nama yang sama | `ShadTable.list`, `ShadTableCell` | elemen | tidak ada | Struktur tabel. |
| `PaginationLink isActive` | `PaginationItem :is-active` | `ShadButton.outline` | boolean | `false` | Menandai halaman yang dibuka. |
| `href` di link paginasi | `:total`, `:items-per-page` di `Pagination` | tidak ada | string / angka | tidak ada | Tujuan link halaman, atau cara Vue menghitung halaman. |

## Kode

**React**
```tsx
import { useState, type MouseEvent } from "react"
import { Badge } from "@/components/ui/badge"
import {
  Pagination,
  PaginationContent,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak" },
] as const

/** Two pages of five rows; the demo shows the first page's rows on both. */
const pages = [1, 2]

export default function TableDemo() {
  const [page, setPage] = useState(1)
  const goTo = (next: number) => (event: MouseEvent) => {
    event.preventDefault()
    setPage(next)
  }
  return (
    <div className="w-full max-w-xl rounded-lg border border-border bg-card">
      <Table>
        <TableHeader>
          <TableRow>
            <TableHead>Judul</TableHead>
            <TableHead>Artis</TableHead>
            <TableHead>Status</TableHead>
          </TableRow>
        </TableHeader>
        <TableBody>
          {releases.map((r) => (
            <TableRow key={r.title}>
              <TableCell className="font-medium">{r.title}</TableCell>
              <TableCell className="text-muted-foreground">{r.artist}</TableCell>
              <TableCell>
                <Badge variant={r.status}>{r.label}</Badge>
              </TableCell>
            </TableRow>
          ))}
        </TableBody>
      </Table>
      <Pagination className="border-t border-border py-2">
        <PaginationContent>
          <PaginationItem>
            <PaginationPrevious href="#" disabled={page === 1} onClick={goTo(page - 1)} />
          </PaginationItem>
          {pages.map((p) => (
            <PaginationItem key={p}>
              <PaginationLink href="#" isActive={p === page} onClick={goTo(p)}>
                {p}
              </PaginationLink>
            </PaginationItem>
          ))}
          <PaginationItem>
            <PaginationNext href="#" disabled={page === pages.length} onClick={goTo(page + 1)} />
          </PaginationItem>
        </PaginationContent>
      </Pagination>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Badge } from "@/components/ui/badge"
import {
  Pagination,
  PaginationContent,
  PaginationItem,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak" },
] as const
</script>

<template>
  <div class="w-full max-w-xl rounded-lg border border-border bg-card">
    <Table>
      <TableHeader>
        <TableRow>
          <TableHead>Judul</TableHead>
          <TableHead>Artis</TableHead>
          <TableHead>Status</TableHead>
        </TableRow>
      </TableHeader>
      <TableBody>
        <TableRow v-for="r in releases" :key="r.title">
          <TableCell class="font-medium">{{ r.title }}</TableCell>
          <TableCell class="text-muted-foreground">{{ r.artist }}</TableCell>
          <TableCell><Badge :variant="r.status">{{ r.label }}</Badge></TableCell>
        </TableRow>
      </TableBody>
    </Table>
    <Pagination v-slot="{ page }" :items-per-page="5" :total="10" :default-page="1" class="border-t border-border py-2">
      <PaginationContent v-slot="{ items }">
        <PaginationPrevious />
        <template v-for="(item, index) in items" :key="index">
          <PaginationItem v-if="item.type === 'page'" :value="item.value" :is-active="item.value === page">
            {{ item.value }}
          </PaginationItem>
        </template>
        <PaginationNext />
      </PaginationContent>
    </Pagination>
  </div>
</template>
```

**Flutter**
```dart
// shadcn_ui has no pagination widget: put ShadButton.outline (current page) and ShadButton.ghost below the table.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const releases = [
  (title: 'Senja di Kota', artist: 'Rara Senandika', status: 'Terbit'),
  (title: 'Kaset Pertama', artist: 'Bima Laras', status: 'Menunggu'),
  (title: 'Pulang Sore', artist: 'Nada Kirana', status: 'Dijadwalkan'),
];

class TableDemo extends StatelessWidget {
  const TableDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 576, maxHeight: 320),
      child: ShadTable.list(
        // Fixed widths for the title and artist; the status column takes the rest, so badges never clip.
        columnSpanExtent: (index) => switch (index) {
          0 => const FixedTableSpanExtent(200),
          1 => const FixedTableSpanExtent(180),
          _ => const RemainingTableSpanExtent(),
        },
        header: const [
          ShadTableCell.header(child: Text('Judul')),
          ShadTableCell.header(child: Text('Artis')),
          ShadTableCell.header(child: Text('Status')),
        ],
        children: releases.map(
          (r) => [
            ShadTableCell(child: Text(r.title, style: const TextStyle(fontWeight: FontWeight.w500))),
            ShadTableCell(child: Text(r.artist)),
            ShadTableCell(child: ShadBadge.outline(child: Text(r.status))),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/table.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/table.json
```

Paginasi adalah item terpisah:

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/pagination.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/pagination.json
```

## Aksesibilitas

- Memakai `table`, `th`, dan `td` asli, jadi screen reader membacakan baris dan kolomnya.
- Paginasi adalah `nav`, dan halaman yang dibuka punya `aria-current="page"`.
- Beri aksi baris berisi ikon saja sebuah `aria-label`, misalnya "Aksi".


---

# Chart

> Menggambar angka dari waktu ke waktu atau antarkategori, dengan tabel berisi angka yang sama.

Chart menunjukkan perubahan angka dari waktu ke waktu atau perbandingannya antarkategori, misalnya streaming per bulan per platform atau pendapatan royalti.

## Kapan dipakai

- **Bar** untuk membandingkan jumlah antara beberapa kategori atau bulan.
- **Line** untuk satu atau dua ukuran di banyak titik waktu, misalnya pendapatan per bulan.
- **Area** hanya untuk satu total dari waktu ke waktu; area bertumpuk sulit dibaca.
- Maksimal 5 seri. Sisanya digabung ke "Lainnya", atau pisahkan grafiknya.
- Dengan 4 seri atau lebih, beri label langsung di setiap garis atau kelompok bar, bukan hanya di legenda.
- Di scatter plot dan peta, tempat warna apa pun bisa bersebelahan, pakai maksimal 3 seri.
- Satu grafik, satu sumbu. Dua ukuran dengan skala berbeda dibuat jadi dua grafik.
- Satu angka utama cukup ditampilkan sebagai kartu statistik, bukan grafik.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/chart/_

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/chart/_

## Anatomi

1. Seri batang di chart-1
2. Seri garis di chart-2
3. Sumbu

[Card](https://design.sosialoka.tech/id/components/card/) dengan judul dan deskripsi singkat, grafiknya, legenda kalau ada dua seri atau lebih, dan tabel tersembunyi berisi angka yang sama.

| Bagian | Gaya |
| --- | --- |
| Seri | `chart-1` sampai `chart-5`, berurutan. `chart-1` adalah hue produk sendiri. Tidak pernah memakai warna status. |
| Grid | Hanya garis horizontal, warna `border`. Tanpa garis sumbu. |
| Label sumbu | `text-xs`, `muted-foreground`. |
| Bar | Ujung atas membulat 4px, berjarak 2px. |
| Line | 2px, tanpa titik sampai di-hover. |
| Tooltip | Permukaan popover: `rounded-lg`, `border`, `bg-popover`, `shadow-lg`. |
| Angka | `tabular-nums`, mengikuti locale produk (`12,400` dalam bahasa Inggris, `12.400` dalam bahasa Indonesia), Rupiah dua desimal (`Rp 1.890.420,25`). |

Warna grafik adalah token dengan kontras 3:1 di `background` dan `card`. Seri yang bersebelahan, sesuai urutannya, tetap bisa dibedakan pembaca buta warna; warna yang berjauhan dalam urutan bisa terlihat mirip, karena itu 4 seri atau lebih butuh label langsung. Lihat [Warna](https://design.sosialoka.tech/id/foundations/color/#palet-grafik).

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `ChartContainer config` | `ChartContainer :config` | warna dari `context.sosialoka.chart1`… | `ChartConfig` | tidak ada | Label dan warna tiap seri, misalnya `{ color: "var(--chart-1)" }`. |
| children Recharts | children Unovis | `fl_chart` `BarChart`, `LineChart` | komponen | tidak ada | Grafiknya sendiri. |
| `ChartTooltipContent formatter` | `formatter` | `getTooltipItem` | fungsi | angka sesuai `locale` | Format nilai, misalnya Rupiah. |
| `ChartTooltipContent locale`, `ChartTable locale` | `locale` | locale `NumberFormat` | teks | `en-GB` | Cara angka ditulis kalau tidak ada formatter, misalnya `"id-ID"` untuk `12.400`. |
| `ChartTable caption labelKey labelHeader data config format` | sama | `Semantics label` | | tidak ada | Angka yang sama untuk pembaca layar. Selalu pasang. |

## Kode

**React**
```tsx
import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import {
  ChartContainer,
  ChartLegend,
  ChartLegendContent,
  ChartTable,
  ChartTooltip,
  ChartTooltipContent,
  type ChartConfig,
} from "@/components/ui/chart"

const data = [
  { month: "Jun", spotify: 8200, youtube: 5100 },
  { month: "Jul", spotify: 9100, youtube: 5600 },
  { month: "Agu", spotify: 9800, youtube: 6900 },
  { month: "Sep", spotify: 10600, youtube: 7300 },
  { month: "Okt", spotify: 11300, youtube: 8100 },
  { month: "Nov", spotify: 12400, youtube: 8800 },
]

const config = {
  spotify: { label: "Spotify", color: "var(--chart-1)" },
  youtube: { label: "YouTube Music", color: "var(--chart-2)" },
} satisfies ChartConfig

const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)

export default function ChartDemo() {
  return (
    <Card className="w-full max-w-xl">
      <CardHeader>
        <CardTitle>Streaming per bulan</CardTitle>
        <CardDescription>Jun–Nov 2026, semua rilis</CardDescription>
      </CardHeader>
      <CardContent>
        <ChartContainer config={config} className="aspect-auto h-64 w-full">
          <BarChart data={data} barGap={2}>
            <CartesianGrid vertical={false} />
            <XAxis dataKey="month" tickLine={false} axisLine={false} tickMargin={8} />
            <YAxis tickLine={false} axisLine={false} tickMargin={8} width={48} tickFormatter={compact} />
            <ChartTooltip cursor={false} content={<ChartTooltipContent locale="id-ID" />} />
            <ChartLegend content={<ChartLegendContent />} />
            <Bar dataKey="spotify" fill="var(--color-spotify)" radius={[4, 4, 0, 0]} maxBarSize={20} />
            <Bar dataKey="youtube" fill="var(--color-youtube)" radius={[4, 4, 0, 0]} maxBarSize={20} />
          </BarChart>
        </ChartContainer>
        <ChartTable locale="id-ID" caption="Streaming per bulan, Jun–Nov 2026" labelHeader="Bulan" labelKey="month" data={data} config={config} />
      </CardContent>
    </Card>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import type { ChartConfig } from "@/components/ui/chart"
import { VisAxis, VisGroupedBar, VisXYContainer } from "@unovis/vue"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import {
  ChartContainer,
  ChartCrosshair,
  ChartLegendContent,
  ChartTable,
  ChartTooltip,
  ChartTooltipContent,
  componentToString,
} from "@/components/ui/chart"

const data = [
  { month: "Jun", spotify: 8200, youtube: 5100 },
  { month: "Jul", spotify: 9100, youtube: 5600 },
  { month: "Agu", spotify: 9800, youtube: 6900 },
  { month: "Sep", spotify: 10600, youtube: 7300 },
  { month: "Okt", spotify: 11300, youtube: 8100 },
  { month: "Nov", spotify: 12400, youtube: 8800 },
]
type Row = (typeof data)[number]

const config = {
  spotify: { label: "Spotify", color: "var(--chart-1)" },
  youtube: { label: "YouTube Music", color: "var(--chart-2)" },
} satisfies ChartConfig

const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)
</script>

<template>
  <Card class="w-full max-w-xl">
    <CardHeader>
      <CardTitle>Streaming per bulan</CardTitle>
      <CardDescription>Jun–Nov 2026, semua rilis</CardDescription>
    </CardHeader>
    <CardContent>
      <ChartContainer :config="config" class="aspect-auto h-64 w-full">
        <VisXYContainer :data="data" :padding="{ top: 8 }">
          <VisGroupedBar
            :x="(_: Row, i: number) => i"
            :y="[(d: Row) => d.spotify, (d: Row) => d.youtube]"
            :color="[config.spotify.color, config.youtube.color]"
            :rounded-corners="4"
            :bar-padding="0.3"
            :group-max-width="44"
          />
          <VisAxis type="x" :x="(_: Row, i: number) => i" :tick-format="(i: number) => data[i]?.month" :num-ticks="6" :grid-line="false" :tick-line="false" :domain-line="false" />
          <VisAxis type="y" :num-ticks="4" :tick-format="compact" :tick-line="false" :domain-line="false" />
          <ChartTooltip />
          <ChartCrosshair :template="componentToString(config, ChartTooltipContent, { labelKey: 'month', locale: 'id-ID' })" color="transparent" />
        </VisXYContainer>
        <ChartLegendContent />
      </ChartContainer>
      <ChartTable locale="id-ID" caption="Streaming per bulan, Jun–Nov 2026" label-header="Bulan" label-key="month" :data="data" :config="config" />
    </CardContent>
  </Card>
</template>
```

**Flutter**
```dart
// Charts come from fl_chart, colored with the chart palette of the Sosialoka theme (context.sosialoka.chart1…5).
// The bars are hidden from screen readers; a Semantics label carries the numbers instead.
import 'package:fl_chart/fl_chart.dart';
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _months = ['Jun', 'Jul', 'Agu', 'Sep', 'Okt', 'Nov'];
const _spotify = [8200, 9100, 9800, 10600, 11300, 12400];
const _youtube = [5100, 5600, 6900, 7300, 8100, 8800];

class ChartDemo extends StatelessWidget {
  const ChartDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    final number = NumberFormat.decimalPattern('id');
    final summary = [
      for (var i = 0; i < _months.length; i++)
        '${_months[i]}: Spotify ${number.format(_spotify[i])}, YouTube Music ${number.format(_youtube[i])}',
    ].join('; ');
    Widget legend(Color color, String label) => Row(
      mainAxisSize: MainAxisSize.min,
      children: [
        Container(
          width: 10,
          height: 10,
          decoration: BoxDecoration(color: color, borderRadius: BorderRadius.circular(2)),
        ),
        const SizedBox(width: 6),
        Text(label, style: theme.textTheme.muted),
      ],
    );
    return ShadCard(
      width: 576,
      title: Text('Streaming per bulan', style: theme.textTheme.h4),
      description: const Text('Jun–Nov 2026, semua rilis'),
      child: Padding(
        padding: const EdgeInsets.only(top: 16),
        child: Column(
          children: [
            Semantics(
              label: 'Streaming per bulan, Jun–Nov 2026. $summary.',
              child: ExcludeSemantics(
                child: SizedBox(
                  height: 220,
                  child: BarChart(
                    BarChartData(
                      // The tooltip sits on the popover surface, like the web charts.
                      barTouchData: BarTouchData(
                        touchTooltipData: BarTouchTooltipData(
                          getTooltipColor: (_) => theme.colorScheme.popover,
                          tooltipBorder: BorderSide(color: theme.colorScheme.border),
                          getTooltipItem: (group, _, rod, rodIndex) => BarTooltipItem(
                            '${rodIndex == 0 ? 'Spotify' : 'YouTube Music'} ${number.format(rod.toY)}',
                            theme.textTheme.small.copyWith(color: theme.colorScheme.popoverForeground),
                          ),
                        ),
                      ),
                      gridData: FlGridData(
                        drawVerticalLine: false,
                        getDrawingHorizontalLine: (_) => FlLine(color: theme.colorScheme.border, strokeWidth: 1),
                      ),
                      borderData: FlBorderData(show: false),
                      titlesData: FlTitlesData(
                        topTitles: const AxisTitles(),
                        rightTitles: const AxisTitles(),
                        leftTitles: AxisTitles(
                          sideTitles: SideTitles(
                            showTitles: true,
                            reservedSize: 44,
                            getTitlesWidget: (value, meta) => Text(
                              NumberFormat.compact(locale: 'id').format(value),
                              style: theme.textTheme.muted,
                            ),
                          ),
                        ),
                        bottomTitles: AxisTitles(
                          sideTitles: SideTitles(
                            showTitles: true,
                            getTitlesWidget: (value, meta) => Text(_months[value.toInt()], style: theme.textTheme.muted),
                          ),
                        ),
                      ),
                      barGroups: [
                        for (var i = 0; i < _months.length; i++)
                          BarChartGroupData(
                            x: i,
                            barsSpace: 2,
                            barRods: [
                              BarChartRodData(
                                toY: _spotify[i].toDouble(),
                                color: c.chart1,
                                width: 14,
                                borderRadius: const BorderRadius.vertical(top: Radius.circular(4)),
                              ),
                              BarChartRodData(
                                toY: _youtube[i].toDouble(),
                                color: c.chart2,
                                width: 14,
                                borderRadius: const BorderRadius.vertical(top: Radius.circular(4)),
                              ),
                            ],
                          ),
                      ],
                    ),
                  ),
                ),
              ),
            ),
            const SizedBox(height: 12),
            Wrap(spacing: 16, children: [legend(c.chart1, 'Spotify'), legend(c.chart2, 'YouTube Music')]),
          ],
        ),
      ),
    );
  }
}
```

### Line chart

**React**
```tsx
import { CartesianGrid, Line, LineChart, XAxis, YAxis } from "recharts"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import { ChartContainer, ChartTable, ChartTooltip, ChartTooltipContent, type ChartConfig } from "@/components/ui/chart"

const data = [
  { month: "Jun", revenue: 1250000 },
  { month: "Jul", revenue: 1418500.5 },
  { month: "Agu", revenue: 1377250 },
  { month: "Sep", revenue: 1602000.75 },
  { month: "Okt", revenue: 1745300 },
  { month: "Nov", revenue: 1890420.25 },
]

const config = { revenue: { label: "Pendapatan" , color: "var(--chart-1)" } } satisfies ChartConfig

const rupiah = (value: unknown) =>
  new Intl.NumberFormat("id-ID", { style: "currency", currency: "IDR", minimumFractionDigits: 2 }).format(Number(value))
const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)

export default function ChartLineDemo() {
  return (
    <Card className="w-full max-w-xl">
      <CardHeader>
        <CardTitle>Pendapatan royalti</CardTitle>
        <CardDescription>Jun–Nov 2026, dalam Rupiah</CardDescription>
      </CardHeader>
      <CardContent>
        <ChartContainer config={config} className="aspect-auto h-56 w-full">
          <LineChart data={data} margin={{ right: 8 }}>
            <CartesianGrid vertical={false} />
            <XAxis dataKey="month" tickLine={false} axisLine={false} tickMargin={8} />
            <YAxis tickLine={false} axisLine={false} tickMargin={8} width={48} tickFormatter={compact} />
            <ChartTooltip cursor={false} content={<ChartTooltipContent formatter={(value) => rupiah(value)} hideIndicator />} />
            <Line dataKey="revenue" type="monotone" stroke="var(--color-revenue)" strokeWidth={2} dot={false} activeDot={{ r: 4, strokeWidth: 2 }} />
          </LineChart>
        </ChartContainer>
        <ChartTable caption="Pendapatan royalti, Jun–Nov 2026" labelHeader="Bulan" labelKey="month" data={data} config={config} format={rupiah} />
      </CardContent>
    </Card>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import type { ChartConfig } from "@/components/ui/chart"
import { VisAxis, VisLine, VisXYContainer } from "@unovis/vue"
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import { ChartContainer, ChartCrosshair, ChartTable, ChartTooltip, ChartTooltipContent, componentToString } from "@/components/ui/chart"

const data = [
  { month: "Jun", revenue: 1250000 },
  { month: "Jul", revenue: 1418500.5 },
  { month: "Agu", revenue: 1377250 },
  { month: "Sep", revenue: 1602000.75 },
  { month: "Okt", revenue: 1745300 },
  { month: "Nov", revenue: 1890420.25 },
]
type Row = (typeof data)[number]

const config = { revenue: { label: "Pendapatan", color: "var(--chart-1)" } } satisfies ChartConfig

const rupiah = (value: unknown) =>
  new Intl.NumberFormat("id-ID", { style: "currency", currency: "IDR", minimumFractionDigits: 2 }).format(Number(value))
const compact = (value: number) => new Intl.NumberFormat("id-ID", { notation: "compact" }).format(value)
</script>

<template>
  <Card class="w-full max-w-xl">
    <CardHeader>
      <CardTitle>Pendapatan royalti</CardTitle>
      <CardDescription>Jun–Nov 2026, dalam Rupiah</CardDescription>
    </CardHeader>
    <CardContent>
      <ChartContainer :config="config" class="aspect-auto h-56 w-full" cursor>
        <VisXYContainer :data="data" :padding="{ top: 8, right: 8 }">
          <VisLine :x="(_: Row, i: number) => i" :y="(d: Row) => d.revenue" :color="config.revenue.color" :line-width="2" />
          <VisAxis type="x" :x="(_: Row, i: number) => i" :tick-format="(i: number) => data[i]?.month" :num-ticks="6" :grid-line="false" :tick-line="false" :domain-line="false" />
          <VisAxis type="y" :num-ticks="4" :tick-format="compact" :tick-line="false" :domain-line="false" />
          <ChartTooltip />
          <ChartCrosshair :template="componentToString(config, ChartTooltipContent, { labelKey: 'month', hideIndicator: true, formatter: rupiah })" :color="config.revenue.color" />
        </VisXYContainer>
      </ChartContainer>
      <ChartTable caption="Pendapatan royalti, Jun–Nov 2026" label-header="Bulan" label-key="month" :data="data" :config="config" :format="rupiah" />
    </CardContent>
  </Card>
</template>
```

**Flutter**
```dart
import 'package:fl_chart/fl_chart.dart';
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const revenue = [
  (month: 'Jun', value: 1250000.0),
  (month: 'Jul', value: 1418500.5),
  (month: 'Agu', value: 1377250.0),
  (month: 'Sep', value: 1602000.75),
  (month: 'Okt', value: 1745300.0),
  (month: 'Nov', value: 1890420.25),
];

// One series in chart-1, with Rupiah to two decimals. Screen readers get the same numbers as one sentence.
class ChartLineDemo extends StatelessWidget {
  const ChartLineDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    final rupiah = NumberFormat.currency(locale: 'id', symbol: 'Rp', decimalDigits: 2);
    final compact = NumberFormat.compact(locale: 'id');
    final axis = theme.textTheme.muted.copyWith(fontSize: 12);
    final summary = [
      'Pendapatan royalti, Jun–Nov 2026.',
      for (final r in revenue) '${r.month}: ${rupiah.format(r.value)}.',
    ].join(' ');

    return ShadCard(
      width: 576,
      title: Text('Pendapatan royalti', style: theme.textTheme.h4),
      description: const Text('Jun–Nov 2026, dalam Rupiah'),
      child: Semantics(
        label: summary,
        child: ExcludeSemantics(
          child: Padding(
            padding: const EdgeInsets.only(top: 16),
            child: SizedBox(
              height: 220,
              child: LineChart(
                LineChartData(
                  minY: 1000000,
                  maxY: 2000000,
                  lineBarsData: [
                    LineChartBarData(
                      spots: [for (var i = 0; i < revenue.length; i++) FlSpot(i.toDouble(), revenue[i].value)],
                      isCurved: true,
                      color: c.chart1,
                      barWidth: 2,
                      dotData: const FlDotData(show: false),
                    ),
                  ],
                  gridData: FlGridData(
                    drawVerticalLine: false,
                    horizontalInterval: 250000,
                    getDrawingHorizontalLine: (_) => FlLine(color: theme.colorScheme.border, strokeWidth: 1),
                  ),
                  borderData: FlBorderData(show: false),
                  titlesData: FlTitlesData(
                    topTitles: const AxisTitles(),
                    rightTitles: const AxisTitles(),
                    bottomTitles: AxisTitles(
                      sideTitles: SideTitles(
                        showTitles: true,
                        interval: 1,
                        getTitlesWidget: (value, meta) => SideTitleWidget(meta: meta, child: Text(revenue[value.toInt()].month, style: axis)),
                      ),
                    ),
                    leftTitles: AxisTitles(
                      sideTitles: SideTitles(
                        showTitles: true,
                        reservedSize: 44,
                        interval: 250000,
                        getTitlesWidget: (value, meta) => SideTitleWidget(meta: meta, child: Text(compact.format(value), style: axis)),
                      ),
                    ),
                  ),
                  lineTouchData: LineTouchData(
                    touchTooltipData: LineTouchTooltipData(
                      getTooltipColor: (_) => theme.colorScheme.popover,
                      tooltipBorder: BorderSide(color: theme.colorScheme.border),
                      getTooltipItems: (spots) => [
                        for (final s in spots)
                          LineTooltipItem(rupiah.format(s.y), theme.textTheme.small.copyWith(color: theme.colorScheme.popoverForeground)),
                      ],
                    ),
                  ),
                ),
              ),
            ),
          ),
        ),
      ),
    );
  }
}
```

## Instal

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/chart.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/chart.json
```

React menggambar dengan Recharts dan Vue dengan Unovis; Flutter memakai `fl_chart`.

## Aksesibilitas

- Setiap grafik punya alternatif teks: `ChartTable` menampilkan tabel tersembunyi berisi angka yang sama, dan di Flutter grafiknya dibungkus label `Semantics` yang membacakannya.
- Gambar grafiknya disembunyikan dari pembaca layar dan tidak bisa difokus, jadi tabel menjadi satu-satunya sumber.
- Tooltip tidak pernah menjadi satu-satunya tempat sebuah angka.
- Legenda menamai seri setiap kali ada dua seri atau lebih, jadi warna bukan satu-satunya pembeda.

## Migrasi dari ApexCharts

Cover Clearance saat ini menggambar grafiknya dengan ApexCharts. Saat sebuah layar pindah ke design system ini, grafiknya ikut pindah ke Chart: data yang sama, warna `chart-n`, dan `ChartTable`.


---

# Dialog

> Meminta keputusan atau isian di jendela di atas halaman.

Dialog meminta keputusan atau isian singkat di jendela di atas halaman, sementara halaman di belakangnya diredupkan.

## Kapan dipakai

- Pakai untuk form singkat atau pilihan yang butuh perhatian penuh, misalnya mengubah judul rilis.
- Pakai [Alert Dialog](https://design.sosialoka.tech/id/components/alert-dialog/) untuk memastikan aksi yang tidak bisa dibatalkan.
- Pakai [Toast](https://design.sosialoka.tech/id/components/toast/) untuk memberi tahu sesuatu yang sudah terjadi.
- Jangan menaruh alur panjang di dialog; pakai halaman.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/dialog/_

### Lakukan dan jangan

- **Lakukan:** Batasi dialog untuk satu keputusan atau form pendek.
- **Jangan:** Jangan buka dialog di atas dialog lain.

## Anatomi

1. Overlay
2. Judul
3. Isi
4. Aksi, primary paling akhir

Judul, deskripsi, isi opsional, lalu aksi di footer. Jendelanya berlatar `popover` dengan garis `border`, `radius-xl` (16px), dan `shadow-lg`. Halaman di belakangnya diredupkan dengan token `overlay`.

## Varian

Hanya ada satu gaya. Taruh aksi utama paling akhir di footer.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `open` / `defaultOpen` | `v-model:open` / `default-open` | `showShadDialog` | boolean | `false` | Terbuka atau tidak. |
| `onOpenChange` | `@update:open` | nilai kembali `showShadDialog` | function | tidak ada | Jalan saat dibuka atau ditutup. |
| `DialogTrigger render` | `DialogTrigger as-child` | `onPressed` | elemen | button | Kontrol yang membukanya. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Button } from "@/components/ui/button"
import {
  Dialog,
  DialogClose,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
} from "@/components/ui/dialog"
import { Field, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"

export default function DialogDemo() {
  const id = useId()
  return (
    <Dialog>
      <DialogTrigger render={<Button variant="outline" />}>Ubah judul</DialogTrigger>
      <DialogContent>
        <DialogHeader>
          <DialogTitle>Ubah judul rilis</DialogTitle>
          <DialogDescription>Judul baru tampil di semua toko musik setelah dikirim ulang.</DialogDescription>
        </DialogHeader>
        <Field>
          <FieldLabel htmlFor={`${id}-title`}>Judul rilis</FieldLabel>
          <Input id={`${id}-title`} defaultValue="Senja di Kota" />
        </Field>
        <DialogFooter>
          <DialogClose render={<Button variant="outline" />}>Batal</DialogClose>
          <DialogClose render={<Button />}>Simpan</DialogClose>
        </DialogFooter>
      </DialogContent>
    </Dialog>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Button } from "@/components/ui/button"
import {
  Dialog,
  DialogClose,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
} from "@/components/ui/dialog"
import { Field, FieldLabel } from "@/components/ui/field"
import { Input } from "@/components/ui/input"

const id = useId()
</script>

<template>
  <Dialog>
    <DialogTrigger as-child>
      <Button variant="outline">Ubah judul</Button>
    </DialogTrigger>
    <DialogContent>
      <DialogHeader>
        <DialogTitle>Ubah judul rilis</DialogTitle>
        <DialogDescription>Judul baru tampil di semua toko musik setelah dikirim ulang.</DialogDescription>
      </DialogHeader>
      <Field>
        <FieldLabel :for="`${id}-title`">Judul rilis</FieldLabel>
        <Input :id="`${id}-title`" default-value="Senja di Kota" />
      </Field>
      <DialogFooter>
        <DialogClose as-child><Button variant="outline">Batal</Button></DialogClose>
        <DialogClose as-child><Button>Simpan</Button></DialogClose>
      </DialogFooter>
    </DialogContent>
  </Dialog>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class DialogDemo extends StatelessWidget {
  const DialogDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadButton.outline(
      child: const Text('Ubah judul'),
      onPressed: () => showShadDialog(
        context: context,
        builder: (context) => ShadDialog(
          title: const Text('Ubah judul rilis'),
          description: const Text('Judul baru tampil di semua toko musik setelah dikirim ulang.'),
          actions: [
            ShadButton.outline(child: const Text('Batal'), onPressed: () => Navigator.of(context).pop()),
            ShadButton(child: const Text('Simpan'), onPressed: () => Navigator.of(context).pop()),
          ],
          child: ShadInputFormField(id: 'release-title', label: const Text('Judul rilis'), initialValue: 'Senja di Kota'),
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/dialog.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/dialog.json
```

Tombol yang ikut terpasang adalah tombol Sosialoka.

## Aksesibilitas

- Dirender dengan `role="dialog"` dan judul sebagai namanya. Fokus pindah ke dalam dialog, lalu kembali ke pemicunya saat ditutup.
- Escape menutupnya, dan fokus tetap di dalam selama dialog terbuka.


---

# Alert Dialog

> Memastikan aksi yang tidak bisa dibatalkan.

Alert Dialog meminta orang memastikan aksi yang tidak bisa dibatalkan, misalnya menghapus rilis, sebelum aksinya jalan.

## Kapan dipakai

- Pakai hanya untuk aksi yang tidak bisa dibatalkan: menghapus, membatalkan langganan, menarik kontrak.
- Pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/) untuk form singkat, dan [Toast](https://design.sosialoka.tech/id/components/toast/) dengan tombol urungkan kalau aksinya bisa dikembalikan.
- Tulis judulnya sebagai pertanyaan ("Hapus rilis?") dan sebut apa yang hilang di deskripsinya.
- Beri tombol aksi kata kerjanya ("Hapus"), jangan "Ya" atau "OK".

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/alert-dialog/_

### Lakukan dan jangan

- **Lakukan:** Sebut aksinya di judul dan di tombol, dan fokuskan Batal lebih dulu.
- **Jangan:** Jangan ajukan pertanyaan samar dengan satu tombol OK.

## Anatomi

1. Ikon peringatan
2. Judul yang menyebut aksinya
3. Batal, fokus pertama
4. Aksi destruktif

Judul, deskripsi, dan pita footer berisi **Batal** dan tombol aksi. Jendelanya berlatar `popover` dengan `border`, `radius-xl`, dan `shadow-lg`, di atas token `overlay`. Fokus awal ada di **Batal**, dan aksi destruktif ada paling kanan.

## Varian

Hanya ada satu gaya. Pakai tombol `destructive` untuk aksinya; tombol default hanya untuk aksi yang tidak menghapus, misalnya keluar dari semua perangkat.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `open` / `onOpenChange` | `v-model:open` | `showShadDialog` | boolean | `false` | Membuka lewat kode. |
| `AlertDialogAction variant` | `AlertDialogAction variant` | `ShadButton.destructive` | teks | `default` | Tombol aksi. |
| `AlertDialogCancel autoFocus` | `AlertDialogCancel` (fokus pertama) | `ShadButton.outline(autofocus: true)` | boolean | tidak ada | Memulai fokus di Batal. |
| `AlertDialogTrigger render` | `AlertDialogTrigger as-child` | tombol yang memanggil `showShadDialog` | elemen | tidak ada | Tombol yang membukanya. |

## Kode

**React**
```tsx
import { useState } from "react"
import {
  AlertDialog,
  AlertDialogAction,
  AlertDialogCancel,
  AlertDialogContent,
  AlertDialogDescription,
  AlertDialogFooter,
  AlertDialogHeader,
  AlertDialogTitle,
  AlertDialogTrigger,
} from "@/components/ui/alert-dialog"
import { Button } from "@/components/ui/button"

export default function AlertDialogDemo() {
  const [deleted, setDeleted] = useState(false)
  if (deleted) return <p className="text-sm text-muted-foreground">"Senja di Kota" dihapus.</p>
  return (
    <AlertDialog>
      <AlertDialogTrigger render={<Button variant="outline" />}>Hapus rilis</AlertDialogTrigger>
      <AlertDialogContent>
        <AlertDialogHeader>
          <AlertDialogTitle>Hapus rilis?</AlertDialogTitle>
          <AlertDialogDescription>"Senja di Kota" dan semua datanya akan dihapus. Kamu tidak bisa mengembalikannya.</AlertDialogDescription>
        </AlertDialogHeader>
        <AlertDialogFooter>
          <AlertDialogCancel autoFocus>Batal</AlertDialogCancel>
          <AlertDialogAction variant="destructive" onClick={() => setDeleted(true)}>
            Hapus
          </AlertDialogAction>
        </AlertDialogFooter>
      </AlertDialogContent>
    </AlertDialog>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import {
  AlertDialog,
  AlertDialogAction,
  AlertDialogCancel,
  AlertDialogContent,
  AlertDialogDescription,
  AlertDialogFooter,
  AlertDialogHeader,
  AlertDialogTitle,
  AlertDialogTrigger,
} from "@/components/ui/alert-dialog"
import { Button } from "@/components/ui/button"

const deleted = ref(false)
</script>

<template>
  <p v-if="deleted" class="text-sm text-muted-foreground">"Senja di Kota" dihapus.</p>
  <AlertDialog v-else>
    <AlertDialogTrigger as-child>
      <Button variant="outline">Hapus rilis</Button>
    </AlertDialogTrigger>
    <AlertDialogContent>
      <AlertDialogHeader>
        <AlertDialogTitle>Hapus rilis?</AlertDialogTitle>
        <AlertDialogDescription>"Senja di Kota" dan semua datanya akan dihapus. Kamu tidak bisa mengembalikannya.</AlertDialogDescription>
      </AlertDialogHeader>
      <AlertDialogFooter>
        <AlertDialogCancel>Batal</AlertDialogCancel>
        <AlertDialogAction variant="destructive" @click="deleted = true">Hapus</AlertDialogAction>
      </AlertDialogFooter>
    </AlertDialogContent>
  </AlertDialog>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class AlertDialogDemo extends StatelessWidget {
  const AlertDialogDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadButton.outline(
      child: const Text('Hapus rilis'),
      onPressed: () => showShadDialog<bool>(
        context: context,
        builder: (context) => ShadDialog.alert(
          title: const Text('Hapus rilis?'),
          description: const Text('"Senja di Kota" dan semua datanya akan dihapus. Kamu tidak bisa mengembalikannya.'),
          actions: [
            // Cancel takes the focus first; the destructive action sits last.
            ShadButton.outline(autofocus: true, child: const Text('Batal'), onPressed: () => Navigator.of(context).pop(false)),
            ShadButton.destructive(child: const Text('Hapus'), onPressed: () => Navigator.of(context).pop(true)),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/alert-dialog.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/alert-dialog.json
```

## Aksesibilitas

- Punya `role="alertdialog"`, dinamai judulnya dan dijelaskan deskripsinya.
- Fokus awal di Batal, jadi menekan Enter karena kebiasaan tidak menghapus apa pun.
- Escape membatalkan; klik di luar tidak menutupnya.
- Fokus tetap di dalam sampai tertutup, lalu kembali ke pemicunya.


---

# Sheet

> Panel yang bergeser masuk dari tepi layar.

Sheet menggeser panel masuk dari tepi layar, di atas halaman yang diredupkan, untuk filter atau detail yang tidak butuh halaman baru.

## Kapan dipakai

- Pakai untuk filter di daftar, dan panel samping berisi detail satu baris.
- Pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/) untuk keputusan atau form singkat, dan halaman untuk alur panjang.
- Di HP, buka dari bawah sebagai bottom sheet.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/sheet/_

## Anatomi

1. Overlay
2. Panel dari tepi
3. Judul
4. Aksi

Header berisi judul dan satu kalimat deskripsi, isi, lalu footer berisi aksi utama. Panelnya berlatar `popover` dengan `border` di tepi dalam dan tanpa radius di tepi yang menempel ke layar, di atas token `overlay`.

## Varian

| Sisi | Pakai untuk |
| --- | --- |
| `right` (bawaan) | Filter dan detail di web. |
| `bottom` | Filter dan aksi di HP. |
| `left` / `top` | Jarang; menu navigasi memakai Sidebar. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `side` di `SheetContent` | `side` di `SheetContent` | `side` di `showShadSheet` | teks | `right` | Tepi asal panel. |
| `open` / `onOpenChange` | `v-model:open` | `showShadSheet` | boolean | `false` | Membuka lewat kode. |
| `SheetTitle`, `SheetDescription` | `SheetTitle`, `SheetDescription` | `title`, `description` | teks | tidak ada | Nama panel. |
| `SheetFooter` | `SheetFooter` | `actions` | elemen | tidak ada | Aksi utama. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Button } from "@/components/ui/button"
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"
import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from "@/components/ui/sheet"

const statuses = ["Terbit", "Menunggu", "Ditolak"]

export default function SheetDemo() {
  const id = useId()
  return (
    <Sheet>
      <SheetTrigger render={<Button variant="outline" />}>Filter</SheetTrigger>
      <SheetContent side="right">
        <SheetHeader>
          <SheetTitle>Filter rilis</SheetTitle>
          <SheetDescription>Tampilkan rilis dengan status yang kamu pilih.</SheetDescription>
        </SheetHeader>
        <div className="grid gap-3 px-4">
          {statuses.map((status) => (
            <div key={status} className="flex items-center gap-2">
              <Checkbox id={`${id}-${status}`} />
              <Label htmlFor={`${id}-${status}`}>{status}</Label>
            </div>
          ))}
        </div>
        <SheetFooter>
          <SheetClose render={<Button />}>Terapkan</SheetClose>
        </SheetFooter>
      </SheetContent>
    </Sheet>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Button } from "@/components/ui/button"
import { Checkbox } from "@/components/ui/checkbox"
import { Label } from "@/components/ui/label"
import { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from "@/components/ui/sheet"

const statuses = ["Terbit", "Menunggu", "Ditolak"]
const id = useId()
</script>

<template>
  <Sheet>
    <SheetTrigger as-child>
      <Button variant="outline">Filter</Button>
    </SheetTrigger>
    <SheetContent side="right">
      <SheetHeader>
        <SheetTitle>Filter rilis</SheetTitle>
        <SheetDescription>Tampilkan rilis dengan status yang kamu pilih.</SheetDescription>
      </SheetHeader>
      <div class="grid gap-3 px-4">
        <div v-for="status in statuses" :key="status" class="flex items-center gap-2">
          <Checkbox :id="`${id}-${status}`" />
          <Label :for="`${id}-${status}`">{{ status }}</Label>
        </div>
      </div>
      <SheetFooter>
        <SheetClose as-child>
          <Button>Terapkan</Button>
        </SheetClose>
      </SheetFooter>
    </SheetContent>
  </Sheet>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const statuses = ['Terbit', 'Menunggu', 'Ditolak'];

class SheetDemo extends StatelessWidget {
  const SheetDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadButton.outline(
      child: const Text('Filter'),
      onPressed: () => showShadSheet(
        context: context,
        side: ShadSheetSide.right,
        builder: (context) => ShadSheet(
          constraints: const BoxConstraints(maxWidth: 384),
          title: const Text('Filter rilis'),
          description: const Text('Tampilkan rilis dengan status yang kamu pilih.'),
          actions: [ShadButton(child: const Text('Terapkan'), onPressed: () => Navigator.of(context).pop())],
          child: Column(
            mainAxisSize: MainAxisSize.min,
            crossAxisAlignment: CrossAxisAlignment.start,
            spacing: 12,
            children: [for (final status in statuses) ShadCheckbox(value: false, label: Text(status), onChanged: (_) {})],
          ),
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/sheet.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/sheet.json
```

## Aksesibilitas

- Sheet berupa dialog yang dinamai judulnya; fokus masuk ke dalamnya dan kembali ke pemicu saat tertutup.
- Escape dan tombol tutup menutupnya.
- Halaman di belakangnya tidak bisa dijangkau sampai sheet tertutup.


---

# Drawer

> Bottom sheet yang muncul dari bawah di HP.

Drawer adalah bottom sheet: panel yang muncul dari bawah layar HP, untuk mengurutkan, filter, atau pilihan singkat.

## Kapan dipakai

- Pakai di HP untuk mengurutkan, filter, dan pilihan singkat, dekat dengan jempol.
- Pakai [Sheet](https://design.sosialoka.tech/id/components/sheet/) dari samping di web. Aplikasi web yang juga harus jalan di HP membuka Sheet mulai `md` dan Drawer di bawahnya.
- Pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/) untuk keputusan yang butuh perhatian penuh.
- Isi yang panjang di-scroll di dalam drawer; drawer tidak pernah menutupi lebih dari 85% layar.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/drawer/_

## Anatomi

1. Pegangan
2. Bottom sheet
3. Halaman di belakang, diredupkan

Pegangan 48×6px di atas, header berisi judul dan satu kalimat deskripsi, isi, lalu footer berisi aksi utama. Panelnya berlatar `popover` dengan `radius-xl` hanya di sudut atas, `border` di atas, dan token `overlay` di belakangnya. Padding bawahnya menjauhi garis home di HP (`env(safe-area-inset-bottom)`).

## Varian

Hanya ada satu gaya, dari bawah. Tepi lain bisa dipakai, tapi gunakan Sheet untuk panel samping.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `open` / `onOpenChange` | `v-model:open` | `showShadSheet(side: ShadSheetSide.bottom)` | boolean | `false` | Membuka lewat kode. |
| `showSwipeHandle` | selalu tampil dari bawah | kotak `muted` 48×6 | boolean | `true` | Pegangan geser. |
| `DrawerTitle`, `DrawerDescription` | sama | `title`, `description` | teks | tidak ada | Nama panel. |
| `DrawerFooter` | `DrawerFooter` | `actions` | elemen | tidak ada | Aksi utama. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Button } from "@/components/ui/button"
import {
  Drawer,
  DrawerClose,
  DrawerContent,
  DrawerDescription,
  DrawerFooter,
  DrawerHeader,
  DrawerTitle,
  DrawerTrigger,
} from "@/components/ui/drawer"
import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const orders = [
  { value: "newest", label: "Terbaru" },
  { value: "oldest", label: "Terlama" },
  { value: "title", label: "Judul A–Z" },
]

export default function DrawerDemo() {
  const id = useId()
  return (
    <Drawer>
      <DrawerTrigger render={<Button variant="outline" />}>Urutkan</DrawerTrigger>
      <DrawerContent>
        <DrawerHeader>
          <DrawerTitle>Urutkan rilis</DrawerTitle>
          <DrawerDescription>Pilih urutan daftar rilismu.</DrawerDescription>
        </DrawerHeader>
        <RadioGroup defaultValue="newest" aria-label="Urutan" className="px-4">
          {orders.map((o) => (
            <div key={o.value} className="flex items-center gap-3">
              <RadioGroupItem value={o.value} id={`${id}-${o.value}`} />
              <Label htmlFor={`${id}-${o.value}`}>{o.label}</Label>
            </div>
          ))}
        </RadioGroup>
        <DrawerFooter>
          <DrawerClose render={<Button />}>Terapkan</DrawerClose>
        </DrawerFooter>
      </DrawerContent>
    </Drawer>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Button } from "@/components/ui/button"
import {
  Drawer,
  DrawerClose,
  DrawerContent,
  DrawerDescription,
  DrawerFooter,
  DrawerHeader,
  DrawerTitle,
  DrawerTrigger,
} from "@/components/ui/drawer"
import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const orders = [
  { value: "newest", label: "Terbaru" },
  { value: "oldest", label: "Terlama" },
  { value: "title", label: "Judul A–Z" },
]
const id = useId()
</script>

<template>
  <Drawer>
    <DrawerTrigger as-child>
      <Button variant="outline">Urutkan</Button>
    </DrawerTrigger>
    <DrawerContent>
      <DrawerHeader>
        <DrawerTitle>Urutkan rilis</DrawerTitle>
        <DrawerDescription>Pilih urutan daftar rilismu.</DrawerDescription>
      </DrawerHeader>
      <RadioGroup default-value="newest" aria-label="Urutan" class="px-4">
        <div v-for="o in orders" :key="o.value" class="flex items-center gap-3">
          <RadioGroupItem :id="`${id}-${o.value}`" :value="o.value" />
          <Label :for="`${id}-${o.value}`">{{ o.label }}</Label>
        </div>
      </RadioGroup>
      <DrawerFooter>
        <DrawerClose as-child>
          <Button>Terapkan</Button>
        </DrawerClose>
      </DrawerFooter>
    </DrawerContent>
  </Drawer>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const sortOrders = [('newest', 'Terbaru'), ('oldest', 'Terlama'), ('title', 'Judul A–Z')];

// A bottom sheet: the shadcn_ui sheet from the bottom edge, with a drag handle on top.
class DrawerDemo extends StatelessWidget {
  const DrawerDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadButton.outline(
      child: const Text('Urutkan'),
      onPressed: () => showShadSheet(
        context: context,
        side: ShadSheetSide.bottom,
        builder: (context) {
          final theme = ShadTheme.of(context);
          final handle = ExcludeSemantics(
            child: Center(
              child: Container(
                width: 48,
                height: 6,
                decoration: BoxDecoration(color: theme.colorScheme.muted, borderRadius: BorderRadius.circular(3)),
              ),
            ),
          );
          // draggable lets the handle swipe the sheet closed; the handle sits above the title.
          return ShadSheet(
            draggable: true,
            radius: const BorderRadius.vertical(top: Radius.circular(16)),
            title: Column(spacing: 12, children: [handle, const Text('Urutkan rilis')]),
            description: const Text('Pilih urutan daftar rilismu.'),
            actions: [ShadButton(child: const Text('Terapkan'), onPressed: () => Navigator.of(context).pop())],
            child: Column(
              mainAxisSize: MainAxisSize.min,
              crossAxisAlignment: CrossAxisAlignment.start,
              spacing: 16,
              children: [
                ShadRadioGroup<String>(
                  initialValue: 'newest',
                  items: [for (final (value, label) in sortOrders) ShadRadio(value: value, label: Text(label))],
                ),
              ],
            ),
          );
        },
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/drawer.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/drawer.json
```

## Aksesibilitas

- Drawer berupa dialog yang dinamai judulnya; fokus masuk ke dalamnya dan kembali ke pemicu saat tertutup.
- Menggeser pegangan ke bawah, Escape, dan ketukan di overlay menutupnya. Pegangan hanya hiasan dan tidak pernah menerima fokus, jadi tetap sediakan tombol untuk menutup atau menerapkan.
- Halaman di belakangnya tidak bisa dijangkau sampai drawer tertutup.


---

# Popover

> Menampilkan konten tambahan atau form kecil di samping pemicunya.

Popover membuka panel kecil di samping tombol yang membukanya, untuk konten tambahan atau tugas singkat yang tidak butuh dialog.

## Kapan dipakai

- Pakai untuk membagikan tautan, memasang filter cepat, atau menampilkan detail satu item.
- Pakai [Tooltip](https://design.sosialoka.tech/id/components/tooltip/) untuk nama satu baris pada tombol ikon, dan [Dialog](https://design.sosialoka.tech/id/components/dialog/) untuk tugas yang butuh perhatian penuh.
- Pakai [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/) untuk daftar aksi.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/popover/_

## Anatomi

1. Pemicu
2. Panah
3. Isi

Panel berlatar `popover` dengan `border`, `radius-lg`, dan `shadow-lg`, lebar bawaan 288px, di samping pemicunya. Panel dirender di luar alur halaman, jadi tidak pernah terpotong kartu. Judul dan satu kalimat deskripsi boleh ada di bagian atasnya.

## Varian

Hanya ada satu gaya. Pilih sisinya (`top`, `right`, `bottom`, `left`) dan perataannya (`start`, `center`, `end`).

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `open` / `onOpenChange` | `v-model:open` | `controller` | boolean | `false` | Membuka dan menutup lewat kode. |
| `side` di `PopoverContent` | `side` di `PopoverContent` | `anchor` | teks | `bottom` | Sisi pemicu tempat panel terbuka. |
| `align` di `PopoverContent` | `align` di `PopoverContent` | `anchor` | teks | `center` | Perataan panel terhadap pemicu. |
| `PopoverTrigger render` | `PopoverTrigger as-child` | `child` | elemen | tidak ada | Tombol yang membukanya. |

## Kode

**React**
```tsx
import { useId } from "react"
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
import { Popover, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger } from "@/components/ui/popover"

export default function PopoverDemo() {
  const id = useId()
  return (
    <Popover>
      <PopoverTrigger render={<Button variant="outline" />}>Bagikan</PopoverTrigger>
      <PopoverContent>
        <PopoverHeader>
          <PopoverTitle>Bagikan rilis</PopoverTitle>
          <PopoverDescription>Siapa pun yang punya tautan ini bisa mendengarkan.</PopoverDescription>
        </PopoverHeader>
        <div className="grid gap-2">
          <Label htmlFor={`${id}-link`}>Tautan rilis</Label>
          <div className="flex gap-2">
            <Input id={`${id}-link`} readOnly defaultValue="https://contoh.id/senja-di-kota" />
            <Button>Salin</Button>
          </div>
        </div>
      </PopoverContent>
    </Popover>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover"

const id = useId()
</script>

<template>
  <Popover>
    <PopoverTrigger as-child>
      <Button variant="outline">Bagikan</Button>
    </PopoverTrigger>
    <PopoverContent class="grid gap-2.5" :aria-describedby="`${id}-description`">
      <div class="grid gap-1">
        <p class="font-medium">Bagikan rilis</p>
        <p :id="`${id}-description`" class="text-muted-foreground">Siapa pun yang punya tautan ini bisa mendengarkan.</p>
      </div>
      <div class="grid gap-2">
        <Label :for="`${id}-link`">Tautan rilis</Label>
        <div class="flex gap-2">
          <Input :id="`${id}-link`" readonly default-value="https://contoh.id/senja-di-kota" />
          <Button>Salin</Button>
        </div>
      </div>
    </PopoverContent>
  </Popover>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class PopoverDemo extends StatefulWidget {
  const PopoverDemo({super.key});

  @override
  State<PopoverDemo> createState() => _PopoverDemoState();
}

class _PopoverDemoState extends State<PopoverDemo> {
  final controller = ShadPopoverController();

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ShadPopover(
      controller: controller,
      popover: (context) => SizedBox(
        width: 288,
        child: Column(
          mainAxisSize: MainAxisSize.min,
          crossAxisAlignment: CrossAxisAlignment.start,
          spacing: 8,
          children: [
            Text('Bagikan rilis', style: theme.textTheme.large),
            Text('Siapa pun yang punya tautan ini bisa mendengarkan.', style: theme.textTheme.muted),
            Row(
              spacing: 8,
              children: [
                const Expanded(
                  child: ShadInput(initialValue: 'https://contoh.id/senja-di-kota', readOnly: true),
                ),
                ShadButton(child: const Text('Salin'), onPressed: () {}),
              ],
            ),
          ],
        ),
      ),
      child: ShadButton.outline(onPressed: controller.toggle, child: const Text('Bagikan')),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/popover.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/popover.json
```

## Aksesibilitas

- Panelnya berupa dialog yang mengambil fokus saat terbuka dan mengembalikannya ke pemicu saat tertutup.
- Escape dan klik di luar panel menutupnya.
- Beri pemicu nama yang jelas, misalnya "Bagikan".


---

# Dropdown Menu

> Mengumpulkan beberapa aksi di balik satu tombol.

Dropdown menu mengumpulkan beberapa aksi di balik satu tombol, misalnya aksi sebuah baris tabel.

## Kapan dipakai

- Pakai kalau satu baris atau kartu punya lebih banyak aksi daripada yang muat sebagai tombol.
- Taruh aksi yang paling sering dipakai di atas, dan aksi destructive di bawah setelah pemisah.
- Untuk memilih nilai, pakai [Select](https://design.sosialoka.tech/id/components/select/), bukan menu.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/dropdown-menu/_

### Lakukan dan jangan

- **Lakukan:** Taruh item destruktif paling akhir, setelah pemisah.
- **Jangan:** Jangan taruh item destruktif paling atas, tempat klik cepat mendarat.

## Anatomi

1. Tombol pemicu
2. Menu di elevation-lg
3. Item yang disorot
4. Item destruktif, paling akhir setelah pemisah

Pemicu, biasanya tombol ikon ghost, dan popup berlatar `popover` dengan garis `border`, `radius-lg`, dan `shadow-lg`. Item memakai `radius-md` dan disorot dengan `accent`.

## Varian

Item bisa `destructive` (`text-destructive`), checkbox, radio, atau sub-menu.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `DropdownMenuTrigger render` | `DropdownMenuTrigger as-child` | `child` dengan `controller.toggle` | elemen | button | Kontrol yang membukanya. |
| `DropdownMenuItem variant` | `DropdownMenuItem variant` | tidak ada | `default` \| `destructive` | `default` | Menandai aksi destructive. |
| `onClick` di item | `@select` di item | `onPressed` di `ShadContextMenuItem` | function | tidak ada | Menjalankan aksi. |

## Kode

**React**
```tsx
import { MoreHorizontalIcon } from "lucide-react"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"

export default function DropdownMenuDemo() {
  return (
    <DropdownMenu>
      <DropdownMenuTrigger render={<Button variant="ghost" size="icon" aria-label="Aksi" />}>
        <MoreHorizontalIcon />
      </DropdownMenuTrigger>
      <DropdownMenuContent>
        <DropdownMenuItem>Lihat</DropdownMenuItem>
        <DropdownMenuItem>Ubah</DropdownMenuItem>
        <DropdownMenuSeparator />
        <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
      </DropdownMenuContent>
    </DropdownMenu>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { MoreHorizontal } from "@lucide/vue"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
</script>

<template>
  <DropdownMenu>
    <DropdownMenuTrigger as-child>
      <Button variant="ghost" size="icon" aria-label="Aksi"><MoreHorizontal /></Button>
    </DropdownMenuTrigger>
    <DropdownMenuContent>
      <DropdownMenuItem>Lihat</DropdownMenuItem>
      <DropdownMenuItem>Ubah</DropdownMenuItem>
      <DropdownMenuSeparator />
      <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
    </DropdownMenuContent>
  </DropdownMenu>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class DropdownMenuDemo extends StatefulWidget {
  const DropdownMenuDemo({super.key});

  @override
  State<DropdownMenuDemo> createState() => _DropdownMenuDemoState();
}

class _DropdownMenuDemoState extends State<DropdownMenuDemo> {
  final controller = ShadContextMenuController();

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return ShadContextMenu(
      controller: controller,
      items: const [
        ShadContextMenuItem(child: Text('Lihat')),
        ShadContextMenuItem(child: Text('Ubah')),
        ShadSeparator.horizontal(margin: EdgeInsets.symmetric(vertical: 4)),
        ShadContextMenuItem(child: Text('Hapus')),
      ],
      child: ShadIconButton.ghost(
        icon: const Icon(LucideIcons.ellipsis),
        onPressed: controller.toggle,
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/dropdown-menu.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/dropdown-menu.json
```

## Aksesibilitas

- Dirender dengan `role="menu"` dan `menuitem`. Tombol panah berpindah, Enter menjalankan, Escape menutup.
- Pemicu berisi ikon saja wajib punya `aria-label`.


---

# Tooltip

> Memberi nama kontrol berisi ikon saja saat di-hover atau difokus.

Tooltip memberi nama kontrol berisi ikon saja saat di-hover atau difokus.

## Kapan dipakai

- Pakai untuk memberi label tombol ikon, misalnya unduh atau ubah.
- Cukup beberapa kata. Bantuan yang lebih panjang ditaruh di halaman.
- Jangan menaruh apa pun yang perlu diklik di dalam tooltip.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/tooltip/_

### Lakukan dan jangan

- **Lakukan:** Pakai tooltip untuk menamai tombol ikon dengan satu-dua kata.
- **Jangan:** Jangan sembunyikan instruksi atau kebijakan di tooltip.

## Anatomi

1. Tooltip di foreground
2. Pemicu berupa ikon saja

Label kecil berwarna terbalik (isi `foreground`, teks `background`) dengan `radius-md`, dan panah yang menunjuk ke kontrolnya.

## Varian

Hanya ada satu gaya. Tooltip bisa muncul di sisi mana pun dari kontrolnya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `TooltipProvider delay` | `TooltipProvider :delay-duration` | tidak ada | angka (ms) | bawaan provider | Jeda sebelum muncul. |
| `TooltipContent side` | `TooltipContent side` | `anchor` | `top` \| `right` \| `bottom` \| `left` | `top` | Posisi munculnya. |
| `TooltipTrigger render` | `TooltipTrigger as-child` | `child` | elemen | button | Kontrol yang diberi nama. |

## Kode

**React**
```tsx
import { DownloadIcon } from "lucide-react"
import { Button } from "@/components/ui/button"
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip"

export default function TooltipDemo() {
  return (
    <TooltipProvider delay={0}>
      <Tooltip>
        <TooltipTrigger render={<Button variant="outline" size="icon" aria-label="Unduh laporan" />}>
          <DownloadIcon />
        </TooltipTrigger>
        <TooltipContent>Unduh laporan</TooltipContent>
      </Tooltip>
    </TooltipProvider>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Download } from "@lucide/vue"
import { Button } from "@/components/ui/button"
import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "@/components/ui/tooltip"
</script>

<template>
  <TooltipProvider :delay-duration="0">
    <Tooltip>
      <TooltipTrigger as-child>
        <Button variant="outline" size="icon" aria-label="Unduh laporan"><Download /></Button>
      </TooltipTrigger>
      <TooltipContent>Unduh laporan</TooltipContent>
    </Tooltip>
  </TooltipProvider>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class TooltipDemo extends StatelessWidget {
  const TooltipDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadTooltip(
      builder: (context) => const Text('Unduh laporan'),
      child: ShadIconButton.outline(icon: const Icon(LucideIcons.download), onPressed: () {}),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/tooltip.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/tooltip.json
```

## Aksesibilitas

- Muncul saat fokus keyboard, bukan hanya saat hover.
- Kontrolnya tetap butuh `aria-label`. Tooltip membantu yang melihat layar, label membantu pengguna screen reader.


---

# Toast

> Memberi tahu bahwa sebuah aksi berhasil, lewat pesan singkat yang hilang sendiri.

Toast memberi tahu bahwa sesuatu sudah terjadi, misalnya tersimpan atau terkirim, lewat pesan singkat yang hilang sendiri.

## Kapan dipakai

- Pakai untuk memastikan aksi yang baru dilakukan: "Rilis tersimpan."
- Pakai untuk error yang tidak terkait satu kolom: "Belum bisa mengirim. Coba lagi sebentar."
- Error validasi ditampilkan di bawah kolomnya, bukan di toast. Pesannya datang dari backend.
- Pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/) kalau orang harus memutuskan sesuatu.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/toast/_

### Lakukan dan jangan

- **Lakukan:** Konfirmasi apa yang baru terjadi dalam beberapa kata.
- **Jangan:** Jangan taruh error, teks panjang, atau keputusan di toast; toast menutup sendiri.

## Anatomi

1. Ikon status
2. Pesan
3. Tutup

Pesan berlatar `popover` dengan garis `border`, `radius-lg`, dan `shadow-lg`, dengan ikon berwarna status: `success`, `info`, `warning`, atau `destructive`. Toast bertumpuk di salah satu sudut dan mengikuti mode halaman.

## Varian

`toast()` untuk pesan biasa, dan `toast.success`, `toast.info`, `toast.warning`, `toast.error` untuk pesan dengan ikon status.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `toast.success(pesan)` dari `sonner` | `toast.success(pesan)` dari `vue-sonner` | `ShadToaster.of(context).show(ShadToast(...))` | function | tidak ada | Menampilkan toast. |
| `<Toaster />` sekali di aplikasi | `<Toaster />` sekali di aplikasi | `ShadToaster` (di `ShadApp`) | elemen | tidak ada | Tempat toast muncul. |
| `position` di `Toaster` | `position` di `Toaster` | `alignment` | string | `bottom-right` | Sudut layar. |

`Toaster` Sosialoka membaca mode terang atau gelap dari `data-theme` atau class `.dark` di `<html>`, jadi tidak butuh theme provider.

## Kode

**React**
```tsx
import { toast } from "sonner"
import { Button } from "@/components/ui/button"
import { Toaster } from "@/components/ui/sonner"

export default function SonnerDemo() {
  return (
    <div className="flex flex-wrap gap-2">
      <Button variant="outline" onClick={() => toast.success("Rilis tersimpan.")}>
        Simpan
      </Button>
      <Button variant="outline" onClick={() => toast.error("Belum bisa mengirim. Coba lagi sebentar.")}>
        Kirim
      </Button>
      <Toaster />
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { toast } from "vue-sonner"
import { Button } from "@/components/ui/button"
import { Toaster } from "@/components/ui/sonner"
</script>

<template>
  <div class="flex flex-wrap gap-2">
    <Button variant="outline" @click="toast.success('Rilis tersimpan.')">Simpan</Button>
    <Button variant="outline" @click="toast.error('Belum bisa mengirim. Coba lagi sebentar.')">Kirim</Button>
    <Toaster />
  </div>
</template>
```

**Flutter**
```dart
// ShadApp already wraps the app in a ShadToaster.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class SonnerDemo extends StatelessWidget {
  const SonnerDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return Wrap(
      spacing: 8,
      children: [
        ShadButton.outline(
          child: const Text('Simpan'),
          onPressed: () => ShadToaster.of(context).show(const ShadToast(description: Text('Rilis tersimpan.'))),
        ),
        ShadButton.outline(
          child: const Text('Kirim'),
          onPressed: () => ShadToaster.of(context).show(
            const ShadToast.destructive(description: Text('Belum bisa mengirim. Coba lagi sebentar.')),
          ),
        ),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/sonner.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/sonner.json
```

## Aksesibilitas

- Toast dibacakan screen reader tanpa mengambil fokus.
- Buat singkat. Apa pun yang harus ditindaklanjuti ditaruh di halaman atau dialog.


---

# Progress

> Menunjukkan sejauh mana tugas yang panjangnya diketahui sudah berjalan.

Progress menunjukkan sejauh mana tugas yang panjangnya diketahui sudah berjalan, misalnya mengunggah file master.

## Kapan dipakai

- Pakai untuk unggahan, impor, dan tugas lain yang melaporkan persentase.
- Pakai [Spinner](https://design.sosialoka.tech/id/components/spinner/) kalau panjangnya tidak diketahui.
- Selalu tampilkan label di atas bar, dan persentasenya bila membantu.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/progress/_

## Anatomi

1. Label
2. Nilai
3. Track
4. Indikator

Label dan nilai opsional di atas track berbentuk pil setinggi 8px (`h-2`) berwarna `muted`, terisi `primary` sampai nilainya.

## Varian

Hanya ada satu gaya.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `value` | `model-value` | `value` (0 sampai 1) | angka | React: tidak ada, yang membuat bar indeterminate; Vue: `0` | Kemajuan tugas, 0 sampai 100 di web. |
| `ProgressLabel` | `aria-labelledby` ke label yang terlihat | `semanticsLabel` | teks | tidak ada | Nama tugasnya. |
| `ProgressValue` | teks di samping label | `semanticsValue` | teks | tidak ada | Menampilkan persentase. |

## Kode

**React**
```tsx
import { Progress, ProgressLabel, ProgressValue } from "@/components/ui/progress"

export default function ProgressDemo() {
  return (
    <Progress value={64} className="w-full max-w-sm">
      <ProgressLabel>Mengunggah master.wav</ProgressLabel>
      <ProgressValue />
    </Progress>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { Progress } from "@/components/ui/progress"

const id = useId()
</script>

<template>
  <div class="grid w-full max-w-sm gap-3">
    <div class="flex text-sm">
      <span :id="`${id}-label`" class="font-medium">Mengunggah master.wav</span>
      <span class="ml-auto text-muted-foreground tabular-nums">64%</span>
    </div>
    <Progress :model-value="64" :aria-labelledby="`${id}-label`" />
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class ProgressDemo extends StatelessWidget {
  const ProgressDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 384),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        spacing: 12,
        children: [
          Row(
            children: [
              Text('Mengunggah master.wav', style: theme.textTheme.small),
              const Spacer(),
              Text('64%', style: theme.textTheme.muted),
            ],
          ),
          ShadProgress(value: 0.64, minHeight: 8, semanticsLabel: 'Mengunggah master.wav', semanticsValue: '64%'),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/progress.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/progress.json
```

## Aksesibilitas

- Punya `role="progressbar"` dengan `aria-valuenow`, `aria-valuemin`, dan `aria-valuemax`.
- Beri nama lewat label yang terlihat.
- Jangan umumkan setiap persen; beri tahu saat tugas selesai, misalnya lewat toast.


---

# Spinner

> Menunjukkan bahwa sesuatu sedang dimuat atau disimpan.

Spinner menunjukkan bahwa tugas singkat sedang berjalan, misalnya menyimpan form atau memuat daftar.

## Kapan dipakai

- Pakai di dalam tombol selama aksinya berjalan, dengan tombol nonaktif dan label bentuk sedang ("Menyimpan…").
- Pakai untuk tunggu sebentar dengan label di sampingnya, misalnya "Memuat data rilis".
- Pakai [Skeleton](https://design.sosialoka.tech/id/components/skeleton/) kalau bentuk konten yang dimuat sudah diketahui, dan [Progress](https://design.sosialoka.tech/id/components/progress/) kalau kemajuan tugasnya diketahui.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/spinner/_

## Anatomi

1. Track
2. Busur yang berputar

Ikon Lucide `Loader2` 16px (`size-4`) yang berputar dengan `animate-spin`, mengikuti warna teks.

## Varian

Hanya ada satu gaya. Ubah ukurannya dengan kelas `size-*`, misalnya `size-6` untuk halaman yang sedang dimuat.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `aria-label` | `aria-label` | `label` (Semantics) | teks | `Loading` | Apa yang sedang dimuat, misalnya "Menyimpan". |
| `className` | `class` | `SizedBox.square(dimension:)` | kelas | `size-4` | Ukuran. |

## Kode

**React**
```tsx
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"

export default function SpinnerDemo() {
  return (
    <div className="flex flex-wrap items-center gap-6">
      <Button disabled>
        <Spinner aria-label="Menyimpan" />
        Menyimpan…
      </Button>
      <div className="flex items-center gap-2 text-sm text-muted-foreground">
        <Spinner aria-label="Memuat data rilis" />
        Memuat data rilis
      </div>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Button } from "@/components/ui/button"
import { Spinner } from "@/components/ui/spinner"
</script>

<template>
  <div class="flex flex-wrap items-center gap-6">
    <Button disabled>
      <Spinner aria-label="Menyimpan" />
      Menyimpan…
    </Button>
    <div class="flex items-center gap-2 text-sm text-muted-foreground">
      <Spinner aria-label="Memuat data rilis" />
      Memuat data rilis
    </div>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/material.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

// shadcn_ui has no spinner: a 16px CircularProgressIndicator in the primary color stands in.
class Spinner extends StatelessWidget {
  const Spinner({super.key, required this.label, this.color});

  final String label;
  final Color? color;

  @override
  Widget build(BuildContext context) {
    return Semantics(
      label: label,
      liveRegion: true,
      child: SizedBox.square(
        dimension: 16,
        child: CircularProgressIndicator(strokeWidth: 2, color: color ?? ShadTheme.of(context).colorScheme.primary),
      ),
    );
  }
}

class SpinnerDemo extends StatelessWidget {
  const SpinnerDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Wrap(
      spacing: 24,
      runSpacing: 12,
      crossAxisAlignment: WrapCrossAlignment.center,
      children: [
        ShadButton(
          enabled: false,
          leading: Spinner(label: 'Menyimpan', color: theme.colorScheme.primaryForeground),
          child: const Text('Menyimpan…'),
        ),
        Row(
          mainAxisSize: MainAxisSize.min,
          spacing: 8,
          children: [
            const Spinner(label: 'Memuat data rilis'),
            Text('Memuat data rilis', style: theme.textTheme.muted),
          ],
        ),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/spinner.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/spinner.json
```

## Aksesibilitas

- Punya `role="status"`; beri `aria-label` yang menyebut apa yang sedang terjadi.
- Tetap berputar saat `prefers-reduced-motion` aktif: putarannya satu-satunya tanda bahwa tugas masih berjalan.
- Saat tugas selesai, ganti dengan hasilnya, misalnya toast atau daftar yang sudah dimuat.


---

# Skeleton

> Placeholder berbentuk konten yang sedang dimuat.

Skeleton menggambar placeholder abu-abu berbentuk konten yang sedang dimuat, supaya halaman tidak melompat saat kontennya datang.

## Kapan dipakai

- Pakai kalau bentuk yang dimuat sudah diketahui: baris daftar, kartu, profil.
- Pakai [Spinner](https://design.sosialoka.tech/id/components/spinner/) untuk tunggu sebentar tanpa bentuk yang jelas, misalnya tombol yang sedang menyimpan.
- Samakan dengan tata letak aslinya: jumlah baris dan ukurannya kira-kira sama.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/skeleton/_

## Anatomi

1. Placeholder bentuk
2. Placeholder baris

Kotak berwarna `muted` dengan `radius-md` dan denyut halus `animate-pulse`. Kontainer yang sedang dimuat diberi `aria-busy="true"` dan teks khusus pembaca layar, misalnya "Memuat rilis…".

## Varian

Hanya ada satu gaya. Bentuknya diatur dengan kelas ukuran: `size-10` untuk avatar, `h-4 w-3/4` untuk sebaris teks.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `className` | `class` | `width`, `height` pada kotak `muted` | kelas | tidak ada | Ukuran dan bentuk. |

## Kode

**React**
```tsx
import { Skeleton } from "@/components/ui/skeleton"

export default function SkeletonDemo() {
  return (
    <div aria-busy="true" className="grid w-full max-w-sm gap-4">
      <span className="sr-only">Memuat rilis…</span>
      {[0, 1, 2].map((row) => (
        <div key={row} className="flex items-center gap-3">
          <Skeleton className="size-10" />
          <div className="grid flex-1 gap-2">
            <Skeleton className="h-4 w-3/4" />
            <Skeleton className="h-3 w-1/2" />
          </div>
        </div>
      ))}
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Skeleton } from "@/components/ui/skeleton"
</script>

<template>
  <div aria-busy="true" class="grid w-full max-w-sm gap-4">
    <span class="sr-only">Memuat rilis…</span>
    <div v-for="row in 3" :key="row" class="flex items-center gap-3">
      <Skeleton class="size-10" />
      <div class="grid flex-1 gap-2">
        <Skeleton class="h-4 w-3/4" />
        <Skeleton class="h-3 w-1/2" />
      </div>
    </div>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

// shadcn_ui has no skeleton: muted boxes with the md radius stand in, and the list says it is busy.
class Bone extends StatelessWidget {
  const Bone({super.key, required this.width, required this.height});

  final double width;
  final double height;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Container(
      width: width,
      height: height,
      decoration: BoxDecoration(color: theme.colorScheme.muted, borderRadius: theme.radius),
    );
  }
}

class SkeletonDemo extends StatelessWidget {
  const SkeletonDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return Semantics(
      label: 'Memuat rilis…',
      child: ExcludeSemantics(
        child: Column(
          mainAxisSize: MainAxisSize.min,
          spacing: 16,
          children: [
            for (var row = 0; row < 3; row++)
              const Row(
                mainAxisSize: MainAxisSize.min,
                spacing: 12,
                children: [
                  Bone(width: 40, height: 40),
                  Column(
                    crossAxisAlignment: CrossAxisAlignment.start,
                    spacing: 8,
                    children: [Bone(width: 240, height: 16), Bone(width: 160, height: 12)],
                  ),
                ],
              ),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/skeleton.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/skeleton.json
```

## Aksesibilitas

- Taruh `aria-busy="true"` di kontainer yang sedang dimuat, dan hapus saat kontennya sudah ada.
- Beri pembaca layar satu teks untuk seluruh placeholder, misalnya "Memuat rilis…", dan sembunyikan kotak-kotaknya.
- Denyutnya berhenti saat `prefers-reduced-motion` aktif.


---

# Avatar

> Menampilkan orang atau artis sebagai foto atau inisial.

Avatar menampilkan orang atau artis sebagai foto, atau sebagai inisial kalau belum ada foto.

## Kapan dipakai

- Pakai di samping nama di tabel, komentar, dan menu akun.
- Selalu pasangkan dengan nama dalam teks, kecuali namanya sudah ada tepat di sebelahnya.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/avatar/_

## Anatomi

1. Inisial di latar lembut
2. Gambar
3. Tumpukan, dengan cincin warna kartu

Lingkaran (`radius-full`, satu-satunya bentuk bulat di sistem ini) berisi foto, atau inisial di atas `muted` dengan teks `muted-foreground`.

## Varian

Ukuran diatur lewat class `size-*`. Bawaannya 32px.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `AvatarImage src alt` | `AvatarImage :src alt` | argumen pertama `ShadAvatar` | string | tidak ada | Fotonya. |
| `AvatarFallback` | `AvatarFallback` | `placeholder` | elemen | tidak ada | Inisial saat memuat atau tanpa foto. |

## Kode

**React**
```tsx
import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar"

const portrait =
  "data:image/svg+xml;utf8," +
  encodeURIComponent(
    '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" fill="#cbd5e1"/><circle cx="32" cy="26" r="12" fill="#94a3b8"/><rect x="14" y="42" width="36" height="22" rx="11" fill="#94a3b8"/></svg>'
  )

export default function AvatarDemo() {
  return (
    <div className="flex items-center gap-3">
      <Avatar>
        <AvatarImage src={portrait} alt="Foto profil" />
        <AvatarFallback>RS</AvatarFallback>
      </Avatar>
      <Avatar>
        <AvatarFallback>BL</AvatarFallback>
      </Avatar>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar"

const portrait =
  "data:image/svg+xml;utf8," +
  encodeURIComponent(
    '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" fill="#cbd5e1"/><circle cx="32" cy="26" r="12" fill="#94a3b8"/><rect x="14" y="42" width="36" height="22" rx="11" fill="#94a3b8"/></svg>',
  )
</script>

<template>
  <div class="flex items-center gap-3">
    <Avatar>
      <AvatarImage :src="portrait" alt="Foto profil" />
      <AvatarFallback>RS</AvatarFallback>
    </Avatar>
    <Avatar>
      <AvatarFallback>BL</AvatarFallback>
    </Avatar>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class AvatarDemo extends StatelessWidget {
  const AvatarDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return const Row(
      mainAxisSize: MainAxisSize.min,
      children: [
        ShadAvatar('assets/portrait.png', placeholder: Text('RS')),
        SizedBox(width: 12),
        ShadAvatar('', placeholder: Text('BL')),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/avatar.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/avatar.json
```

## Aksesibilitas

- Beri foto `alt` berisi nama orangnya, atau `alt=""` kalau namanya sudah ada di sebelahnya.


---

# Sidebar

> Navigasi utama sebuah dasbor.

Sidebar adalah navigasi utama dasbor Sosialoka, di sisi kiri setiap halaman.

## Kapan dipakai

- Pakai untuk 4 sampai 8 bagian utama sebuah produk.
- Kelompokkan item yang terkait di bawah label kalau jumlahnya lebih dari enam.
- Aksi untuk satu halaman ditaruh di halaman itu, bukan di sidebar.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/sidebar/_

## Anatomi

1. Logo produk
2. Item aktif
3. Kartu pencarian
4. Isi

Ini sidebar dari kerangka dasbor Alternatif A: panel putih (`sidebar`) selebar 16rem, dengan item ikon dan label ber-`radius-md`. Item aktif memakai `sidebar-accent` dengan teks `sidebar-accent-foreground`, yaitu warna lembut produknya. Di layar kecil, sidebar berubah menjadi sheet yang bergeser masuk.

## Varian

- `collapsible="offcanvas"` (bawaan): bergeser keluar di layar kecil.
- `collapsible="icon"`: menyusut menjadi ikon saja.
- `collapsible="none"`: selalu tampil, seperti di preview.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `SidebarProvider` | `SidebarProvider` | tidak ada | elemen | tidak ada | Menyimpan status buka-tutup; membungkus layout. |
| `collapsible` | `collapsible` | tidak ada | lihat Varian | `offcanvas` | Cara menyusut. |
| `SidebarMenuButton isActive` | `SidebarMenuButton :is-active` | `backgroundColor` dari `sidebar-accent` | boolean | `false` | Menandai bagian yang sedang dibuka. |
| `SidebarMenuButton render` | `SidebarMenuButton as-child` | `onPressed` | elemen | button | Merender item sebagai link. |

## Kode

**React**
```tsx
import { BarChart3Icon, DiscIcon, FileTextIcon, HomeIcon, SettingsIcon } from "lucide-react"
import {
  Sidebar,
  SidebarContent,
  SidebarGroup,
  SidebarGroupContent,
  SidebarMenu,
  SidebarMenuButton,
  SidebarMenuItem,
  SidebarProvider,
} from "@/components/ui/sidebar"

const items = [
  { title: "Dasbor", icon: HomeIcon, active: true },
  { title: "Rilis", icon: DiscIcon },
  { title: "Royalti", icon: BarChart3Icon },
  { title: "Dokumen", icon: FileTextIcon },
  { title: "Pengaturan", icon: SettingsIcon },
]

export default function SidebarDemo() {
  return (
    <SidebarProvider className="min-h-0 w-auto">
      <div className="h-96 overflow-hidden rounded-lg border border-border">
        <Sidebar collapsible="none">
          <SidebarContent>
            <SidebarGroup>
              <SidebarGroupContent>
                <SidebarMenu>
                  {items.map((item) => (
                    <SidebarMenuItem key={item.title}>
                      <SidebarMenuButton
                        isActive={item.active}
                        render={<a href="#" aria-current={item.active ? "page" : undefined} />}
                      >
                        <item.icon />
                        <span>{item.title}</span>
                      </SidebarMenuButton>
                    </SidebarMenuItem>
                  ))}
                </SidebarMenu>
              </SidebarGroupContent>
            </SidebarGroup>
          </SidebarContent>
        </Sidebar>
      </div>
    </SidebarProvider>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { BarChart3, Disc, FileText, Home, Settings } from "@lucide/vue"
import {
  Sidebar,
  SidebarContent,
  SidebarGroup,
  SidebarGroupContent,
  SidebarMenu,
  SidebarMenuButton,
  SidebarMenuItem,
  SidebarProvider,
} from "@/components/ui/sidebar"

const items = [
  { title: "Dasbor", icon: Home, active: true },
  { title: "Rilis", icon: Disc },
  { title: "Royalti", icon: BarChart3 },
  { title: "Dokumen", icon: FileText },
  { title: "Pengaturan", icon: Settings },
]
</script>

<template>
  <SidebarProvider class="min-h-0 w-auto">
    <div class="h-96 overflow-hidden rounded-lg border border-border">
      <Sidebar collapsible="none">
        <SidebarContent>
          <SidebarGroup>
            <SidebarGroupContent>
              <SidebarMenu>
                <SidebarMenuItem v-for="item in items" :key="item.title">
                  <SidebarMenuButton as-child :is-active="item.active">
                    <a href="#" :aria-current="item.active ? 'page' : undefined">
                      <component :is="item.icon" />
                      <span>{{ item.title }}</span>
                    </a>
                  </SidebarMenuButton>
                </SidebarMenuItem>
              </SidebarMenu>
            </SidebarGroupContent>
          </SidebarGroup>
        </SidebarContent>
      </Sidebar>
    </div>
  </SidebarProvider>
</template>
```

**Flutter**
```dart
// shadcn_ui has no sidebar widget: build it from a Column of ShadButton.ghost items,
// and mark the active one with the primary-soft and primary-text colors of the Sosialoka theme.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const items = ['Dasbor', 'Rilis', 'Royalti', 'Dokumen', 'Pengaturan'];

class SidebarDemo extends StatelessWidget {
  const SidebarDemo({super.key, this.active = 'Dasbor'});

  final String active;

  @override
  Widget build(BuildContext context) {
    final scheme = ShadTheme.of(context).colorScheme;
    final c = context.sosialoka;
    return Container(
      width: 256,
      color: scheme.card,
      padding: const EdgeInsets.all(8),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          for (final item in items)
            ShadButton.ghost(
              mainAxisAlignment: MainAxisAlignment.start,
              backgroundColor: item == active ? c.primarySoft : null,
              foregroundColor: item == active ? c.primaryText : scheme.foreground,
              onPressed: () {},
              child: Text(item),
            ),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/sidebar.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/sidebar.json
```

Perintah ini juga memasang sheet, separator, skeleton, tooltip, input, dan button versi Sosialoka.

## Aksesibilitas

- Render item sebagai link, dan pasang `aria-current="page"` di item yang aktif.
- Tombol buka-tutup butuh `aria-label`. Sidebar juga bisa dibuka-tutup dengan ⌘B atau Ctrl+B.


---

# Command

> Mencari menu dan data dari keyboard.

Command mencari menu dan data sambil kamu mengetik, dan menjadi dasar pencarian di kartu header dasbor.

## Kapan dipakai

- Pakai untuk pencarian global atas menu dan data, dibuka dengan ⌘K atau Ctrl+K.
- Untuk menyaring satu tabel, pakai [Input](https://design.sosialoka.tech/id/components/input/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/command/_

## Kartu pencarian

Halaman tanpa kerangka dasbor bisa memakai kartu pencarian melayang sendiri: kartu (`rounded-lg border border-border bg-card shadow-md`) yang tampak seperti kolom pencarian dan membuka command palette di dialog. Di dalam kerangka [Dasbor](https://design.sosialoka.tech/id/patterns/dashboard/), pencarian ada di kartu header.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/command/_

**React**
```tsx
import * as React from "react"
import { SearchIcon } from "lucide-react"
import {
  Command,
  CommandDialog,
  CommandEmpty,
  CommandGroup,
  CommandInput,
  CommandItem,
  CommandList,
} from "@/components/ui/command"

/** The floating search card of the Alt A dashboard header: a card-styled trigger that opens the command palette. */
export default function SearchCardDemo() {
  const [open, setOpen] = React.useState(false)

  React.useEffect(() => {
    const onKey = (e: KeyboardEvent) => {
      if (e.key === "k" && (e.metaKey || e.ctrlKey)) {
        // One palette per keypress: the first listener claims it, so other ⌘K handlers stay closed.
        if (e.defaultPrevented) return
        e.preventDefault()
        e.stopPropagation()
        setOpen((o) => !o)
      }
    }
    document.addEventListener("keydown", onKey)
    return () => document.removeEventListener("keydown", onKey)
  }, [])

  return (
    <>
      <button
        type="button"
        onClick={() => setOpen(true)}
        className="flex h-12 w-full max-w-lg items-center gap-3 rounded-lg border border-border bg-card px-4 text-left text-sm text-muted-foreground shadow-md outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
      >
        <SearchIcon className="size-4" />
        <span className="flex-1">Cari rilis, artis, atau dokumen</span>
        <kbd className="rounded-sm border border-border bg-muted px-1.5 font-mono text-xs">⌘K</kbd>
      </button>
      <CommandDialog open={open} onOpenChange={setOpen}>
        {/* In Base UI, CommandDialog is only the window: the palette inside is a Command. */}
        <Command>
          <CommandInput placeholder="Cari rilis, artis, atau dokumen" />
          <CommandList>
            <CommandEmpty>Tidak ada yang cocok.</CommandEmpty>
            <CommandGroup heading="Rilis">
              <CommandItem>Senja di Kota</CommandItem>
              <CommandItem>Kaset Pertama</CommandItem>
            </CommandGroup>
            <CommandGroup heading="Menu">
              <CommandItem>Royalti</CommandItem>
              <CommandItem>Dokumen</CommandItem>
            </CommandGroup>
          </CommandList>
        </Command>
      </CommandDialog>
    </>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Search } from "@lucide/vue"
import { onBeforeUnmount, onMounted, ref } from "vue"
import {
  CommandDialog,
  CommandEmpty,
  CommandGroup,
  CommandInput,
  CommandItem,
  CommandList,
} from "@/components/ui/command"

/** The floating search card of the Alt A dashboard header: a card-styled trigger that opens the command palette. */
const open = ref(false)
const onKey = (e: KeyboardEvent) => {
  if (e.key === "k" && (e.metaKey || e.ctrlKey)) {
    // One palette per keypress: the first listener claims it, so other ⌘K handlers stay closed.
    if (e.defaultPrevented) return
    e.preventDefault()
    e.stopPropagation()
    open.value = !open.value
  }
}
onMounted(() => document.addEventListener("keydown", onKey))
onBeforeUnmount(() => document.removeEventListener("keydown", onKey))
</script>

<template>
  <button
    type="button"
    class="flex h-12 w-full max-w-lg items-center gap-3 rounded-lg border border-border bg-card px-4 text-left text-sm text-muted-foreground shadow-md outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
    @click="open = true"
  >
    <Search class="size-4" />
    <span class="flex-1">Cari rilis, artis, atau dokumen</span>
    <kbd class="rounded-sm border border-border bg-muted px-1.5 font-mono text-xs">⌘K</kbd>
  </button>
  <CommandDialog v-model:open="open">
    <CommandInput placeholder="Cari rilis, artis, atau dokumen" />
    <CommandList>
      <CommandEmpty>Tidak ada yang cocok.</CommandEmpty>
      <CommandGroup heading="Rilis">
        <CommandItem value="senja">Senja di Kota</CommandItem>
        <CommandItem value="kaset">Kaset Pertama</CommandItem>
      </CommandGroup>
      <CommandGroup heading="Menu">
        <CommandItem value="royalti">Royalti</CommandItem>
        <CommandItem value="dokumen">Dokumen</CommandItem>
      </CommandGroup>
    </CommandList>
  </CommandDialog>
</template>
```

**Flutter**
```dart
// The floating search card of the dashboard header. It opens a search sheet built like CommandDemo.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class SearchCardDemo extends StatelessWidget {
  const SearchCardDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return ShadCard(
      width: 512,
      padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 4),
      child: ShadInput(
        placeholder: const Text('Cari rilis, artis, atau dokumen'),
        leading: const Icon(LucideIcons.search, size: 16),
        readOnly: true,
        onPressed: () => showShadSheet(
          context: context,
          side: ShadSheetSide.top,
          builder: (context) => const ShadSheet(title: Text('Cari'), child: SizedBox(height: 240)),
        ),
      ),
    );
  }
}
```

## Anatomi

1. Kolom pencarian
2. Judul grup
3. Hasil yang disorot
4. Pintasan keyboard

Kolom pencarian dengan garis `border` di bawahnya, lalu kelompok item. Item memakai `radius-md`, dan item yang disorot memakai `accent`. Di dialog, jendelanya memakai `radius-xl`; kalau tampil langsung di halaman, daftarnya memakai `radius-lg`.

## Varian

Tampil langsung di halaman (`Command`) atau di dalam dialog (`CommandDialog`).

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `CommandDialog open onOpenChange` | `CommandDialog v-model:open` | `showShadSheet` | boolean | `false` | Membuka palette. Di React, taruh `Command` di dalamnya; di Vue sudah termasuk. |
| `CommandInput placeholder` | `CommandInput placeholder` | `ShadInput placeholder` | string | tidak ada | Apa yang dicari. |
| `CommandItem onSelect` | `CommandItem @select` | `onPressed` | function | tidak ada | Jalan saat item dipilih. |
| `CommandEmpty` | `CommandEmpty` | teks kosong | elemen | tidak ada | Tampil kalau tidak ada yang cocok. |

## Kode

**React**
```tsx
import { BarChart3Icon, DiscIcon, FileTextIcon, SettingsIcon } from "lucide-react"
import {
  Command,
  CommandEmpty,
  CommandGroup,
  CommandInput,
  CommandItem,
  CommandList,
  CommandShortcut,
} from "@/components/ui/command"

export default function CommandDemo() {
  return (
    <Command className="w-full max-w-sm border border-border shadow-md">
      <CommandInput placeholder="Cari menu atau rilis" />
      <CommandList>
        <CommandEmpty>Tidak ada yang cocok.</CommandEmpty>
        <CommandGroup heading="Menu">
          <CommandItem>
            <DiscIcon />
            Rilis
          </CommandItem>
          <CommandItem>
            <BarChart3Icon />
            Royalti
          </CommandItem>
          <CommandItem>
            <FileTextIcon />
            Dokumen
          </CommandItem>
          <CommandItem>
            <SettingsIcon />
            Pengaturan
            <CommandShortcut>⌘,</CommandShortcut>
          </CommandItem>
        </CommandGroup>
      </CommandList>
    </Command>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { BarChart3, Disc, FileText, Settings } from "@lucide/vue"
import {
  Command,
  CommandEmpty,
  CommandGroup,
  CommandInput,
  CommandItem,
  CommandList,
  CommandShortcut,
} from "@/components/ui/command"
</script>

<template>
  <Command class="w-full max-w-sm border border-border shadow-md">
    <CommandInput placeholder="Cari menu atau rilis" />
    <CommandList>
      <CommandEmpty>Tidak ada yang cocok.</CommandEmpty>
      <CommandGroup heading="Menu">
        <CommandItem value="rilis"><Disc />Rilis</CommandItem>
        <CommandItem value="royalti"><BarChart3 />Royalti</CommandItem>
        <CommandItem value="dokumen"><FileText />Dokumen</CommandItem>
        <CommandItem value="pengaturan"><Settings />Pengaturan<CommandShortcut>⌘,</CommandShortcut></CommandItem>
      </CommandGroup>
    </CommandList>
  </Command>
</template>
```

**Flutter**
```dart
// shadcn_ui has no command palette: filter a list under a ShadInput.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const menu = ['Rilis', 'Royalti', 'Dokumen', 'Pengaturan'];

class CommandDemo extends StatefulWidget {
  const CommandDemo({super.key});

  @override
  State<CommandDemo> createState() => _CommandDemoState();
}

class _CommandDemoState extends State<CommandDemo> {
  String query = '';

  @override
  Widget build(BuildContext context) {
    final matches = menu.where((m) => m.toLowerCase().contains(query.toLowerCase()));
    return ShadCard(
      width: 384,
      padding: const EdgeInsets.all(4),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          ShadInput(
            placeholder: const Text('Cari menu atau rilis'),
            leading: const Icon(LucideIcons.search, size: 16),
            onChanged: (v) => setState(() => query = v),
          ),
          for (final m in matches) ShadButton.ghost(mainAxisAlignment: MainAxisAlignment.start, onPressed: () {}, child: Text(m)),
          if (matches.isEmpty) const Padding(padding: EdgeInsets.all(12), child: Text('Tidak ada yang cocok.')),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/command.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/command.json
```

## Aksesibilitas

- Tombol panah berpindah antaritem, Enter memilih, Escape menutup dialog.
- Tampilkan pintasan (⌘K) di kartu pencarian supaya orang menemukannya.


---

# Login

> Halaman masuk. Hero brand berisi beberapa bab di samping form, dan form ditutup dengan "from Sosialoka".

Semua produk Sosialoka memakai halaman masuk yang sama, jadi di sinilah orang pertama kali melihat bahwa produk-produk ini satu keluarga. Sisi kiri bercerita tentang produkmu lewat bab-bab pendek. Sisi kanan berisi form, dan form-nya sama di semua produk.

## Kapan dipakai

- Pakai untuk masuk, daftar, dan atur ulang kata sandi di aplikasi web.
- Bab, gambar, dan logo boleh berbeda di tiap produk. Susunan form dan footer-nya jangan diubah.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/login/_

## Anatomi

1. **Hero** (mulai `lg`): bab yang berganti sendiri di atas `brand-ground`. Tiap bab punya gambar, judul dengan font display brand, dan satu kalimat pengantar. Progress bar dan tombol jeda ada di bawah.
2. **Form**: logo produk, judul, isian, dan satu aksi utama.
3. **Footer**: "from [mark] Sosialoka" di bawah form.

## Aturan

- **Kolom:** di bawah `lg` hero disembunyikan. Di `lg` hero mengambil setengah halaman, dan di `xl` dua pertiganya.
- **Satu aksi utama:** tombol kirim ("Masuk"). "Lupa kata sandi" dan "Daftar" cukup berupa tautan.
- **Copy:** judul bab berisi satu ide, sekitar delapan kata. Kalimat pengantarnya satu kalimat. Pakai "kamu", seperti di semua copy Sosialoka.
- **Warna:** hero memakai `brand-ground` dan `brand-ground-foreground`. Tes token memastikan kontras pasangan ini minimal 4.5:1. Bab yang memakai `ground` sendiri juga wajib memberi `ink` yang kontrasnya minimal 4.5:1 di atasnya.
- **Mark:** isi `markSrc` dengan mark Sosialoka, yang bisa kamu unduh di [Brand](https://design.sosialoka.tech/id/brand/).

### Motion

| Apa | Durasi | Easing |
| --- | --- | --- |
| Satu bab tampil | `duration-chapter` (7 detik) | progress bar linear |
| Bab berikutnya naik seperti lembaran | `duration-sheet` (1050 ms) | `ease-in-out` |
| Kata-kata judul naik satu per satu | 900 ms, mulai 420 ms + 40 ms per kata | `ease-expo` |
| Kalimat pengantar muncul | `duration-slow` (700 ms), mulai 780 ms | `ease-standard` |

- Bab berikutnya mulai saat progress bar aktif selesai. Jadi, apa pun yang menahan bar juga menahan babnya.
- Hover atau fokus di dalam hero hanya menahan bab yang sedang dibaca.
- Tombol jeda dan tab browser yang tersembunyi menghentikan semua animasi di hero.
- Dengan `prefers-reduced-motion`, gerakan berhenti, tetapi bab tetap berganti dengan fade singkat.

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `slides` | `slides` | `_LoginHero` | `{ title, lead, art?, ground?, ink? }[]` | tidak ada | Daftar bab. Di Vue, gambar diisi lewat slot `art` (`{ slide, index }`). |
| `logo` | slot `#logo` | widget | elemen | tidak ada | Logo produk di atas form. |
| `markSrc` | `mark-src` | `Image` | string | tidak ada | Mark Sosialoka di footer. |
| `labels` | `labels` | `Text` | `{ hero, pause, play, chapter, from }` | bahasa Inggris | Teks untuk screen reader dan footer. `chapter` menerima `{n}` dan `{title}`. Contohnya mengisi bahasa Indonesia. |
| `children` | slot bawaan | `_LoginForm` | elemen | tidak ada | Form-nya. |

## Kode

**React**
```tsx
import { CheckIcon, DiscIcon, LinkIcon, PenLineIcon } from "lucide-react"
import { LoginSplit, type LoginSlide } from "@/components/blocks/login-split"
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

/** A chapter illustration: a small product card drawn with tokens. */
function Scene({ icon: Icon, title, meta }: { icon: typeof DiscIcon; title: string; meta: string }) {
  return (
    <div className="flex w-72 items-center gap-3 rounded-xl bg-card p-4 text-card-foreground shadow-lg">
      <span className="grid size-10 place-items-center rounded-lg bg-primary-soft text-primary-text">
        <Icon className="size-5" />
      </span>
      <span className="grid gap-0.5">
        <span className="text-sm font-semibold">{title}</span>
        <span className="text-xs text-muted-foreground">{meta}</span>
      </span>
    </div>
  )
}

const slides: LoginSlide[] = [
  {
    title: "Rilis musikmu ke seluruh dunia.",
    lead: "Kirim lagu ke layanan streaming dari satu tempat.",
    art: <Scene icon={DiscIcon} title="Senja di Kota" meta="Terkirim ke 32 platform" />,
  },
  {
    title: "Cover lagu favoritmu tanpa takut copyright strike.",
    lead: "Kami urus izinnya, kamu fokus berkarya.",
    art: <Scene icon={CheckIcon} title="Izin cover disetujui" meta="Kaset Pertama · 2 menit lalu" />,
  },
  {
    title: "Tanda tangan dokumen di mana saja.",
    lead: "Kirim, tanda tangani, dan simpan perjanjian secara online.",
    art: <Scene icon={PenLineIcon} title="Perjanjian rilis" meta="Ditandatangani 2 dari 2 pihak" />,
  },
  {
    title: "Semua link musikmu di satu tempat.",
    lead: "Satu halaman untuk lagu, video, dan jadwal manggungmu.",
    art: <Scene icon={LinkIcon} title="Halaman artis" meta="1.204 kunjungan minggu ini" />,
  },
]

export default function LoginSplitDemo() {
  return (
    <LoginSplit
      slides={slides}
      markSrc="/brand/sosialoka.png"
      labels={{ hero: "Sorotan produk", pause: "Jeda", play: "Putar", chapter: "Bab {n}: {title}" }}
      logo={
        <span className="flex items-center gap-2 font-semibold">
          <span className="size-7 rounded-md bg-primary" />
          Produkmu
        </span>
      }
    >
      <form className="grid gap-6" onSubmit={(e) => e.preventDefault()}>
        <div className="grid gap-1">
          <h1 className="text-2xl font-semibold">Masuk ke akunmu</h1>
          <p className="text-sm text-muted-foreground">Senang ketemu lagi.</p>
        </div>
        <div className="grid gap-2">
          <Label htmlFor="login-email">Email</Label>
          <Input id="login-email" type="email" autoComplete="email" />
        </div>
        <div className="grid gap-2">
          <div className="flex items-center justify-between">
            <Label htmlFor="login-password">Kata sandi</Label>
            <a href="#" className="text-sm text-primary-text underline-offset-4 hover:underline">
              Lupa kata sandi?
            </a>
          </div>
          <Input id="login-password" type="password" autoComplete="current-password" />
        </div>
        <Button type="submit" className="w-full">
          Masuk
        </Button>
        <p className="text-center text-sm text-muted-foreground">
          Belum punya akun?{" "}
          <a href="#" className="font-medium text-primary-text underline-offset-4 hover:underline">
            Daftar
          </a>
        </p>
      </form>
    </LoginSplit>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Check, Disc, Link, PenLine } from "@lucide/vue"
import { LoginSplit, type LoginSlide } from "@/components/blocks/login-split"
import { Button } from "@/components/ui/button"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"

/** Each chapter's illustration: a small product card drawn with tokens. */
const scenes = [
  { icon: Disc, title: "Senja di Kota", meta: "Terkirim ke 32 platform" },
  { icon: Check, title: "Izin cover disetujui", meta: "Kaset Pertama · 2 menit lalu" },
  { icon: PenLine, title: "Perjanjian rilis", meta: "Ditandatangani 2 dari 2 pihak" },
  { icon: Link, title: "Halaman artis", meta: "1.204 kunjungan minggu ini" },
]

const slides: LoginSlide[] = [
  { title: "Rilis musikmu ke seluruh dunia.", lead: "Kirim lagu ke layanan streaming dari satu tempat." },
  { title: "Cover lagu favoritmu tanpa takut copyright strike.", lead: "Kami urus izinnya, kamu fokus berkarya." },
  { title: "Tanda tangan dokumen di mana saja.", lead: "Kirim, tanda tangani, dan simpan perjanjian secara online." },
  { title: "Semua link musikmu di satu tempat.", lead: "Satu halaman untuk lagu, video, dan jadwal manggungmu." },
]
const labels = { hero: "Sorotan produk", pause: "Jeda", play: "Putar", chapter: "Bab {n}: {title}" }
</script>

<template>
  <LoginSplit :slides="slides" mark-src="/brand/sosialoka.png" :labels="labels">
    <template #logo>
      <span class="flex items-center gap-2 font-semibold">
        <span class="size-7 rounded-md bg-primary" />
        Produkmu
      </span>
    </template>

    <template #art="{ index }">
      <div class="flex w-72 items-center gap-3 rounded-xl bg-card p-4 text-card-foreground shadow-lg">
        <span class="grid size-10 place-items-center rounded-lg bg-primary-soft text-primary-text">
          <component :is="scenes[index]!.icon" class="size-5" />
        </span>
        <span class="grid gap-0.5">
          <span class="text-sm font-semibold">{{ scenes[index]!.title }}</span>
          <span class="text-xs text-muted-foreground">{{ scenes[index]!.meta }}</span>
        </span>
      </div>
    </template>

    <form class="grid gap-6" @submit.prevent>
      <div class="grid gap-1">
        <h1 class="text-2xl font-semibold">Masuk ke akunmu</h1>
        <p class="text-sm text-muted-foreground">Senang ketemu lagi.</p>
      </div>
      <div class="grid gap-2">
        <Label for="login-email-vue">Email</Label>
        <Input id="login-email-vue" type="email" autocomplete="email" />
      </div>
      <div class="grid gap-2">
        <div class="flex items-center justify-between">
          <Label for="login-password-vue">Kata sandi</Label>
          <a href="#" class="text-sm text-primary-text underline-offset-4 hover:underline">Lupa kata sandi?</a>
        </div>
        <Input id="login-password-vue" type="password" autocomplete="current-password" />
      </div>
      <Button type="submit" class="w-full">Masuk</Button>
      <p class="text-center text-sm text-muted-foreground">
        Belum punya akun?
        <a href="#" class="font-medium text-primary-text underline-offset-4 hover:underline">Daftar</a>
      </p>
    </form>
  </LoginSplit>
</template>
```

**Flutter**
```dart
// Flutter has no registry blocks: build the login pattern from widgets with the Sosialoka theme.
// The hero sits beside the form only on wide screens (from 1024 logical px, like lg on the web);
// on phones the form stands alone. Colors come from brand-ground and brand-ground-foreground.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

class LoginSplitDemo extends StatelessWidget {
  const LoginSplitDemo({super.key, this.heroFrom = 1024, this.height = 560});

  /// The narrowest width that shows the hero.
  final double heroFrom;
  final double height;

  @override
  Widget build(BuildContext context) {
    return SizedBox(
      height: height,
      child: LayoutBuilder(
        builder: (context, constraints) {
          final form = _LoginForm();
          if (constraints.maxWidth < heroFrom) return form;
          return Row(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            children: [
              const Expanded(child: _LoginHero()),
              Expanded(child: form),
            ],
          );
        },
      ),
    );
  }
}

class _LoginHero extends StatelessWidget {
  const _LoginHero();

  @override
  Widget build(BuildContext context) {
    final c = context.sosialoka;
    final text = ShadTheme.of(context).textTheme;
    return ColoredBox(
      color: c.brandGround,
      child: Padding(
        padding: const EdgeInsets.all(48),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          mainAxisAlignment: MainAxisAlignment.end,
          children: [
            Text('Rilis musikmu ke seluruh dunia.', style: text.h1Large.copyWith(color: c.brandGroundForeground)),
            const SizedBox(height: 16),
            Text(
              'Kirim lagu ke layanan streaming dari satu tempat.',
              style: text.large.copyWith(color: c.brandGroundForeground),
            ),
          ],
        ),
      ),
    );
  }
}

class _LoginForm extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Padding(
      padding: const EdgeInsets.all(24),
      child: Column(
        children: [
          Expanded(
            child: Center(
              child: ConstrainedBox(
                constraints: const BoxConstraints(maxWidth: 384),
                child: Column(
                  mainAxisSize: MainAxisSize.min,
                  crossAxisAlignment: CrossAxisAlignment.stretch,
                  children: [
                    Text('Masuk ke akunmu', style: theme.textTheme.h3),
                    const SizedBox(height: 24),
                    ShadInputFormField(
                      id: 'email',
                      label: const Text('Email'),
                      keyboardType: TextInputType.emailAddress,
                    ),
                    const SizedBox(height: 16),
                    ShadInputFormField(id: 'password', label: const Text('Kata sandi'), obscureText: true),
                    const SizedBox(height: 24),
                    ShadButton(onPressed: () {}, child: const Text('Masuk')),
                    ShadButton.link(onPressed: () {}, child: const Text('Lupa kata sandi?')),
                  ],
                ),
              ),
            ),
          ),
          Text('from Sosialoka', style: theme.textTheme.muted),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/login-split.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/login-split.json
```

Blok ini dipasang di `components/blocks/`. Keyframe-nya sudah ikut di dalam blok, jadi kamu tidak perlu menambah CSS global.

## Flutter

Flutter tidak punya blok. Kode Flutter-nya menyusun halaman yang sama dari widget. Tampilkan hero hanya mulai lebar 1024 piksel logis, jadi di ponsel form tampil sendiri. Animasi bab di Flutter boleh dilewati. Satu bab diam saja sudah cukup.

## Aksesibilitas

- Hero adalah carousel (`aria-roledescription="carousel"`). Tiap bar bab berupa tombol bernama "Bab 1: …", dan bar yang aktif punya `aria-current`.
- Judul utuh dibacakan sekali. Kata-kata yang beranimasi disembunyikan dari screen reader.
- Tombol jeda memakai `aria-pressed`, dan namanya berganti antara "Pause" dan "Play" (`labels.pause` dan `labels.play`), atau "Jeda" dan "Putar" di contoh.


---

# Dasbor

> Kerangka dasbor. Isinya sidebar putih, kartu header melayang berisi pencarian, aksi ikon, dan akun, serta area isi.

Kerangka dasbor adalah tempat kedua yang membuat semua produk Sosialoka terlihat satu keluarga (Alternatif A). Menu, pencarian, dan akun ada di tempat yang sama di setiap produk, jadi orang yang memakai lebih dari satu produk tidak perlu mencarinya lagi.

## Kapan dipakai

- Pakai untuk semua halaman aplikasi web setelah orang masuk.
- Taruh list, detail, dan form di dalamnya. Jangan bikin header atau sidebar kedua.

### Lakukan dan jangan

- **Lakukan:** Batasi aksi header berupa ikon, masing-masing dinamai tooltip, dengan avatar paling akhir.
- **Jangan:** Jangan isi header dengan tombol teks; tombol itu mendesak pencarian dan sesak di layar kecil.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/dashboard/_

## Anatomi

1. Sidebar dengan logo produk
2. Kartu header, melayang di atas blur
3. Pencarian: membuka command palette
4. Dropdown kode bahasa, lalu aksi ikon dengan tooltip
5. Avatar dan menu akun, selalu paling akhir
6. Isi di background

- **Sidebar:** lebar 16rem di permukaan putih `sidebar`, dengan logo produk di atas. Menu yang aktif memakai `sidebar-accent` dan punya `aria-current="page"`.
- **Kartu header:** satu kartu setinggi 56px (`h-14 rounded-lg border-border bg-card shadow-md`) yang tetap di atas saat halaman digulir di bawah blur. Isinya pencarian, aksi ikon, dan avatar, seperti header Cover Clearance.
- **Pencarian:** mengisi sisi kiri kartu tanpa kotak sendiri dan membuka command palette. ⌘K atau Ctrl+K juga membukanya.
- **Aksi:** bahasa berupa pill bergaris berisi kodenya, lalu tombol ikon ghost 36px berwarna `muted-foreground`, masing-masing dinamai tooltip.
- **Akun:** avatar, selalu paling akhir, membuka menu akun.
- **Isi:** halamanmu, di atas `background`.

## Aturan

- **Satu pencarian:** kartu dan ⌘K membuka palette yang sama. Blok ini hanya mendengarkan ⌘K sekali per halaman, jadi tidak akan muncul palette kedua di atas kartu pencarian dari [Command](https://design.sosialoka.tech/id/components/command/).
- **Menu:** lima sampai tujuh item dengan ikon. Pengaturan ditaruh paling bawah. Produk dengan lebih banyak halaman mengikuti [Menu navigasi](https://design.sosialoka.tech/id/patterns/navigation-menu/).
- **Aksi:** bahasa paling depan, lalu maksimal tiga aksi ikon dengan urutan: mode, bantuan, notifikasi. Susun mode dengan `DashboardModeSelect` dan aksi lain dengan `DashboardIconButton`; `label`-nya jadi tooltip dan nama tombol.
- **Mode:** `DashboardModeSelect`, menu berisi Terang, Gelap, dan Auto. **Auto mengikuti pengaturan perangkat dan jadi pilihan awal pengguna baru.** Selama di Auto, halaman ikut berganti saat perangkat berganti mode, tanpa reload. Ikonnya menunjukkan pilihan (matahari, bulan, atau monitor untuk Auto) dan tooltip menyebutnya, misalnya "Mode: Auto". `useColorMode()` memasang `data-theme` di `<html>` dan mengingat pilihannya; pasang mode yang sama lewat script inline di `<head>` supaya halaman tidak berkedip. Flutter: `ThemeMode.light`, `ThemeMode.dark`, dan `ThemeMode.system` (Auto).
- **Bahasa:** `DashboardLanguageSelect`, seperti di Lokasign: pemicu dropdown bergaris berisi kode bahasa saat ini, "ID" atau "EN", dalam huruf mono dan chevron. Pemicu ini membuka menu bahasa, dengan bahasa aktif ditandai. Bentuknya pill (`rounded-full`), satu-satunya pill di header, dan tetap berupa menu supaya bahasa lain bisa ditambahkan.
- **Notifikasi:** `badge` menampilkan jumlah yang belum dibaca; jangan tampilkan saat nol. Lonceng membuka panel dari [Notifikasi](https://design.sosialoka.tech/id/patterns/notifications/).
- **Menu akun:** tampilkan nama dan satu baris keterangan, lalu aksinya. "Keluar" ditaruh paling akhir sebagai item destruktif.
- **Layar kecil:** di bawah `md`, sidebar berubah menjadi sheet yang dibuka dari tombol menu.
- **Bingkai pratinjau:** `collapsible="none"` menjaga sidebar tetap di alur halaman, misalnya di dalam bingkai di halaman dokumentasi.

## Props

| React | Vue | Flutter | Tipe | Bawaan | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `nav` | `nav` | daftar `ShadButton.ghost` | halaman, induk, atau bagian | tidak ada | Menu. Untuk bagian, sub menu, dan hitungan, lihat [Menu navigasi](https://design.sosialoka.tech/id/patterns/navigation-menu/). |
| `logo` | slot `#logo` | widget | elemen | tidak ada | Logo produk di atas sidebar. |
| `account` | `account` | `ShadAvatar` | `{ name, initials, detail?, menu }` | tidak ada | Avatar dan menunya. Item menu boleh punya `onSelect` dan `destructive`. |
| `actions` | slot `#actions` | `ShadButton.outline` dan `ShadIconButton.ghost` di dalam `ShadTooltip` | elemen | tidak ada | Aksi di antara pencarian dan avatar: `DashboardLanguageSelect` (`value`, `options`, `onValueChange`, `label`; Vue `v-model`), `DashboardModeSelect` (`value`, `onValueChange`, `labels`; Vue `v-model`) bersama `useColorMode(storageKey?)`, lalu `DashboardIconButton` (`label`, `badge?`, ikonnya sebagai anak). |
| `search` | `search` | `ShadInput` di dalam `ShadCard` | `{ groups: { heading, items }[] }` | tidak ada | Isi palette. Item menjalankan `onSelect` miliknya. |
| `collapsible` | `collapsible` | tidak ada | `offcanvas`, `icon`, `none` | `offcanvas` | Cara sidebar menutup. |
| `labels` | `labels` | `Text` | `{ search, empty, account, menu }` | bahasa Inggris | Teks kartu pencarian, palette, dan screen reader. Contohnya mengisi bahasa Indonesia. |
| `children` | slot bawaan | anak `Expanded` | elemen | tidak ada | Isi halaman. |

## Kode

**React**
```tsx
import { useState } from "react"
import { BarChart3Icon, BellIcon, DiscIcon, FileTextIcon, HomeIcon, SettingsIcon } from "lucide-react"
import {
  DashboardIconButton,
  DashboardLanguageSelect,
  DashboardModeSelect,
  DashboardShell,
  useColorMode,
} from "@/components/blocks/dashboard-shell"
import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"

const nav = [
  { title: "Dasbor", href: "#", icon: HomeIcon, active: true },
  { title: "Rilis", href: "#rilis", icon: DiscIcon },
  { title: "Royalti", href: "#royalti", icon: BarChart3Icon },
  { title: "Dokumen", href: "#dokumen", icon: FileTextIcon },
  { title: "Pengaturan", href: "#pengaturan", icon: SettingsIcon },
]

const stats = [
  { label: "Rilis aktif", value: "24" },
  { label: "Streaming bulan ini", value: "182.430" },
  { label: "Royalti bulan ini", value: "Rp4.812.500,00" },
]

export default function DashboardShellDemo() {
  const [mode, setMode] = useColorMode()
  const [language, setLanguage] = useState("id")
  return (
    <DashboardShell
      nav={nav}
      actions={
        <>
          <DashboardLanguageSelect
            label="Bahasa"
            value={language}
            onValueChange={setLanguage}
            options={[
              { code: "id", label: "Bahasa Indonesia" },
              { code: "en", label: "English" },
            ]}
          />
          <DashboardModeSelect
            value={mode}
            onValueChange={setMode}
            labels={{ mode: "Mode", light: "Terang", dark: "Gelap", auto: "Auto" }}
          />
          <DashboardIconButton label="Notifikasi" badge={3}>
            <BellIcon />
          </DashboardIconButton>
        </>
      }
      labels={{ search: "Cari rilis, artis, atau dokumen", empty: "Tidak ada yang cocok.", account: "Akun {name}", menu: "Buka menu" }}
      logo={
        <span className="flex items-center gap-2 font-semibold">
          <span className="size-7 rounded-md bg-primary" />
          Produkmu
        </span>
      }
      account={{
        name: "Raka Pratama",
        initials: "RP",
        detail: "raka@contoh.id",
        menu: [{ label: "Profil" }, { label: "Pengaturan akun" }, { label: "Keluar", destructive: true }],
      }}
      search={{
        groups: [
          { heading: "Rilis", items: [{ label: "Senja di Kota" }, { label: "Kaset Pertama" }] },
          { heading: "Menu", items: nav.map((item) => ({ label: item.title })) },
        ],
      }}
    >
      <h1 className="text-2xl font-semibold">Dasbor</h1>
      <p className="mt-1 text-sm text-muted-foreground">Ringkasan katalogmu minggu ini.</p>
      <div className="mt-6 grid gap-4 sm:grid-cols-3">
        {stats.map((stat) => (
          <Card key={stat.label}>
            <CardHeader>
              <CardDescription>{stat.label}</CardDescription>
              <CardTitle className="text-2xl tabular-nums">{stat.value}</CardTitle>
            </CardHeader>
          </Card>
        ))}
      </div>
    </DashboardShell>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { BarChart3, Bell, Disc, FileText, Home, Settings } from "@lucide/vue"
import { ref } from "vue"
import {
  DashboardIconButton,
  DashboardLanguageSelect,
  DashboardModeSelect,
  DashboardShell,
  useColorMode,
} from "@/components/blocks/dashboard-shell"
import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"

const nav = [
  { title: "Dasbor", href: "#", icon: Home, active: true },
  { title: "Rilis", href: "#rilis", icon: Disc },
  { title: "Royalti", href: "#royalti", icon: BarChart3 },
  { title: "Dokumen", href: "#dokumen", icon: FileText },
  { title: "Pengaturan", href: "#pengaturan", icon: Settings },
]

const stats = [
  { label: "Rilis aktif", value: "24" },
  { label: "Streaming bulan ini", value: "182.430" },
  { label: "Royalti bulan ini", value: "Rp4.812.500,00" },
]

const account = {
  name: "Raka Pratama",
  initials: "RP",
  detail: "raka@contoh.id",
  menu: [{ label: "Profil" }, { label: "Pengaturan akun" }, { label: "Keluar", destructive: true }],
}

const search = {
  groups: [
    { heading: "Rilis", items: [{ label: "Senja di Kota" }, { label: "Kaset Pertama" }] },
    { heading: "Menu", items: nav.map((item) => ({ label: item.title })) },
  ],
}
const mode = useColorMode()
const modeLabels = { mode: "Mode", light: "Terang", dark: "Gelap", auto: "Auto" }
const language = ref("id")
const languages = [
  { code: "id", label: "Bahasa Indonesia" },
  { code: "en", label: "English" },
]
const labels = { search: "Cari rilis, artis, atau dokumen", empty: "Tidak ada yang cocok.", account: "Akun {name}", menu: "Buka menu" }
</script>

<template>
  <DashboardShell :nav="nav" :account="account" :search="search" :labels="labels">
    <template #logo>
      <span class="flex items-center gap-2 font-semibold">
        <span class="size-7 rounded-md bg-primary" />
        Produkmu
      </span>
    </template>
    <template #actions>
      <DashboardLanguageSelect v-model="language" label="Bahasa" :options="languages" />
      <DashboardModeSelect v-model="mode" :labels="modeLabels" />
      <DashboardIconButton label="Notifikasi" :badge="3">
        <Bell />
      </DashboardIconButton>
    </template>

    <h1 class="text-2xl font-semibold">Dasbor</h1>
    <p class="mt-1 text-sm text-muted-foreground">Ringkasan katalogmu minggu ini.</p>
    <div class="mt-6 grid gap-4 sm:grid-cols-3">
      <Card v-for="stat in stats" :key="stat.label">
        <CardHeader>
          <CardDescription>{{ stat.label }}</CardDescription>
          <CardTitle class="text-2xl tabular-nums">{{ stat.value }}</CardTitle>
        </CardHeader>
      </Card>
    </div>
  </DashboardShell>
</template>
```

**Flutter**
```dart
// Flutter has no registry blocks: build the dashboard frame (Alt A) from widgets with the Sosialoka theme.
// A white sidebar, then the floating header card: the search, the language (code + chevron), the mode menu
// (Terang, Gelap, Auto = ThemeMode.system), notifications and the account avatar last. Every icon action has a
// tooltip that names it. Give the app's `themeMode` the picked mode and save it; new users start on Auto.
// On narrow screens, move the menu into a sheet opened from a menu button.
import 'package:flutter/material.dart' show ThemeMode;
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _menu = ['Dasbor', 'Rilis', 'Royalti', 'Dokumen', 'Pengaturan'];
const _stats = [('Rilis aktif', '24'), ('Streaming bulan ini', '182.430'), ('Royalti bulan ini', 'Rp4.812.500,00')];

const _modes = {
  ThemeMode.light: ('Terang', LucideIcons.sun),
  ThemeMode.dark: ('Gelap', LucideIcons.moon),
  ThemeMode.system: ('Auto', LucideIcons.monitor),
};

class DashboardShellDemo extends StatefulWidget {
  const DashboardShellDemo({super.key, this.height = 560});

  final double height;

  @override
  State<DashboardShellDemo> createState() => _DashboardShellDemoState();
}

class _DashboardShellDemoState extends State<DashboardShellDemo> {
  final _modeMenu = ShadContextMenuController();
  // In the app this comes from storage and goes to MaterialApp/ShadApp `themeMode`.
  var _mode = ThemeMode.system;

  @override
  void dispose() {
    _modeMenu.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    return SizedBox(
      height: widget.height,
      child: Row(
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          Container(
            width: 256,
            padding: const EdgeInsets.all(8),
            decoration: BoxDecoration(
              color: theme.colorScheme.card,
              border: Border(right: BorderSide(color: theme.colorScheme.border)),
            ),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.stretch,
              children: [
                for (final item in _menu)
                  ShadButton.ghost(
                    mainAxisAlignment: MainAxisAlignment.start,
                    backgroundColor: item == 'Dasbor' ? c.primarySoft : null,
                    foregroundColor: item == 'Dasbor' ? c.primaryText : theme.colorScheme.foreground,
                    onPressed: () {},
                    child: Text(item),
                  ),
              ],
            ),
          ),
          Expanded(
            child: ColoredBox(
              color: theme.colorScheme.background,
              child: Padding(
                padding: const EdgeInsets.all(24),
                child: Column(
                  crossAxisAlignment: CrossAxisAlignment.start,
                  children: [
                    ShadCard(
                      padding: const EdgeInsets.symmetric(horizontal: 8),
                      child: SizedBox(
                        height: 54,
                        child: Row(
                          children: [
                            Expanded(
                              child: ShadInput(
                                placeholder: const Text('Cari rilis, artis, atau dokumen'),
                                leading: const Icon(LucideIcons.search, size: 16),
                                decoration: const ShadDecoration(border: ShadBorder.none, focusedBorder: ShadBorder.none),
                                readOnly: true,
                                onPressed: () {},
                              ),
                            ),
                            // Language first, as in Lokasign: the current code with a chevron, opening a menu of languages.
                            ShadButton.outline(
                              height: 36,
                              decoration: const ShadDecoration(border: ShadBorder(radius: BorderRadius.all(Radius.circular(18)))),
                              padding: const EdgeInsets.only(left: 12, right: 8),
                              onPressed: () {},
                              trailing: Icon(LucideIcons.chevronDown, size: 14, color: theme.colorScheme.mutedForeground),
                              child: Text('ID', style: TextStyle(fontFamily: theme.textTheme.family, fontFeatures: const [FontFeature.tabularFigures()], fontSize: 12, fontWeight: FontWeight.w500)),
                            ),
                            const SizedBox(width: 4),
                            ShadContextMenu(
                              controller: _modeMenu,
                              items: [
                                for (final MapEntry(key: mode, value: (label, icon)) in _modes.entries)
                                  ShadContextMenuItem(
                                    leading: Icon(icon, size: 16),
                                    trailing: mode == _mode ? const Icon(LucideIcons.check, size: 16) : null,
                                    onPressed: () {
                                      setState(() => _mode = mode);
                                      _modeMenu.hide();
                                    },
                                    child: Text(label),
                                  ),
                              ],
                              child: ShadTooltip(
                                builder: (context) => Text('Mode: ${_modes[_mode]!.$1}'),
                                child: ShadIconButton.ghost(icon: Icon(_modes[_mode]!.$2, size: 18), onPressed: _modeMenu.toggle),
                              ),
                            ),
                            ShadTooltip(
                              builder: (context) => const Text('Notifikasi'),
                              child: Stack(
                                clipBehavior: Clip.none,
                                children: [
                                  ShadIconButton.ghost(icon: const Icon(LucideIcons.bell, size: 18), onPressed: () {}),
                                  Positioned(
                                    top: 4,
                                    right: 4,
                                    child: Container(
                                      constraints: const BoxConstraints(minWidth: 16),
                                      height: 16,
                                      alignment: Alignment.center,
                                      decoration: BoxDecoration(color: theme.colorScheme.destructive, borderRadius: BorderRadius.circular(8)),
                                      child: Text('3', style: TextStyle(fontSize: 10, fontWeight: FontWeight.w600, color: theme.colorScheme.destructiveForeground)),
                                    ),
                                  ),
                                ],
                              ),
                            ),
                            const SizedBox(width: 4),
                            const ShadAvatar('', placeholder: Text('RP'), size: Size.square(36)),
                          ],
                        ),
                      ),
                    ),
                    const SizedBox(height: 24),
                    Text('Dasbor', style: theme.textTheme.h3),
                    const SizedBox(height: 16),
                    Row(
                      children: [
                        for (final (label, value) in _stats) ...[
                          Expanded(
                            child: ShadCard(
                              description: Text(label),
                              title: Text(value, style: theme.textTheme.h4),
                            ),
                          ),
                          if (label != _stats.last.$1) const SizedBox(width: 16),
                        ],
                      ],
                    ),
                  ],
                ),
              ),
            ),
          ),
        ],
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/dashboard-shell.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/dashboard-shell.json
```

Blok ini dipasang di `components/blocks/`. Sidebar, Command, Dropdown Menu, dan Avatar versi Sosialoka ikut terpasang.

## Flutter

Flutter tidak punya blok. Kode Flutter-nya menyusun kerangka yang sama dari widget: kolom sidebar, kartu header berisi pencarian, aksi ikon, dan avatar, lalu isi. Di ponsel, pindahkan menu ke sheet.

## Aksesibilitas

- Menu yang aktif punya `aria-current="page"`.
- Pencarian berupa tombol, dan namanya adalah teks pencariannya. Petunjuk ⌘K tampil di sebelahnya.
- Setiap aksi ikon dinamai `label`-nya, dan hitungannya ikut dibacakan, misalnya "Notifikasi (3)".
- Tombol mode dibacakan beserta pilihannya, misalnya "Mode: Auto", dan menunya menandai pilihan itu.
- Tombol avatar bernama "Akun" diikuti nama akunnya.


---

# Menu navigasi

> Menu sidebar untuk produk dengan banyak halaman, berisi bagian berjudul, sub menu yang terbuka di tempat, dan hitungan.

Produk dengan banyak halaman, seperti admin Loka Musik, mengelompokkan menunya ke dalam bagian berjudul dan melipat halaman yang berkaitan di bawah satu induk. Menu ini ada di sidebar kerangka [Dasbor](https://design.sosialoka.tech/id/patterns/dashboard/); halaman ini mengatur cara menu itu tumbuh.

## Kapan dipakai

- Tambahkan bagian kalau menu sudah lebih dari sekitar tujuh entri. Beri nama sesuai pekerjaan di dalamnya, misalnya "Keuangan & Royalti".
- Tambahkan induk kalau ada tiga halaman atau lebih yang saling berkaitan, misalnya laporan. Dua halaman yang berkaitan tetap jadi halaman biasa.
- Produk dengan lima sampai tujuh halaman tetap memakai daftar biasa di kerangka Dasbor.

### Lakukan dan jangan

- **Lakukan:** Batasi menu dua tingkat: induk dan halaman-halamannya.
- **Jangan:** Jangan taruh sub menu di dalam sub menu; jadikan tingkat itu tab di halamannya.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/navigation-menu/_

## Anatomi

1. Judul bagian
2. Halaman dengan hitungan
3. Induk, terbuka
4. Sub menu dengan garis pandu
5. Halaman saat ini

Menu ada di permukaan `sidebar`. Judul bagian memakai `muted-foreground` ukuran `text-xs`. Halaman saat ini, termasuk yang ada di sub menu, memakai `sidebar-accent`. Sub menu menggantung dari induknya dengan garis pandu `border`.

## Aturan

- **Maksimal dua tingkat:** induk dan halaman-halamannya. Area yang lebih dalam dijadikan tab di halamannya.
- **Induk bukan halaman.** Induk hanya membuka dan menutup sub menunya, dan tidak punya `href`. Kalau areanya butuh ringkasan, jadikan halaman pertama, misalnya "Ringkasan".
- **Terbuka saat dikunjungi:** induk terbuka sendiri kalau salah satu halamannya sedang dibuka, dan judulnya jadi semibold.
- **Boleh terbuka lebih dari satu:** membuka satu induk tidak menutup yang lain.
- **Hitungan:** badge menunjukkan berapa yang menunggu, misalnya tiket yang masih terbuka. Tampilkan di halamannya; di induk yang tertutup, tampilkan jumlahnya. Jangan tampilkan nol.
- **Urutan:** bagian berurutan dari pekerjaan harian ke pengaturan: ringkasan, operasional, klien, keuangan, lalu sistem. Pengaturan dan administrasi paling akhir.
- **Ikon:** halaman dan induk di tingkat pertama punya ikon; halaman di sub menu tidak.
- **Hanya ikon:** saat sidebar diciutkan jadi ikon, induk membuka halamannya di menu di samping rail.
- **HP:** seluruh menu pindah ke sheet, dengan bagian dan sub menu yang sama.

## Props

`nav` pada blok Dasbor menerima halaman, induk, dan bagian:

| Entri | Bentuk | Kegunaan |
| --- | --- | --- |
| Halaman | `{ title, href, icon?, active?, badge? }` | Satu halaman. `active` menandai halaman saat ini; `badge` berisi hitungan. |
| Induk | `{ title, icon?, items, badge? }` | Membuka sub menu berisi halaman. Tanpa `href`. |
| Bagian | `{ label, items }` | Bagian menu berjudul, berisi halaman dan induk. |

Isi dengan daftar bagian, atau daftar halaman dan induk untuk menu tanpa judul. Vue memakai bentuk yang sama; Flutter menyusun menunya dari widget.

## Kode

**React**
```tsx
import {
  BuildingIcon,
  CoinsIcon,
  FileTextIcon,
  LayoutDashboardIcon,
  LifeBuoyIcon,
  MegaphoneIcon,
  MusicIcon,
  PercentIcon,
  SettingsIcon,
  ShieldIcon,
  TruckIcon,
} from "lucide-react"
import { DashboardShell, type DashboardNavSection } from "@/components/blocks/dashboard-shell"
import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"

// The Loka Musik admin menu: titled sections, pages, and parents that open a sub menu.
const nav: DashboardNavSection[] = [
  {
    label: "Overview & Support",
    items: [
      { title: "Dasbor", href: "#dasbor", icon: LayoutDashboardIcon },
      { title: "Tiket Support", href: "#tiket", icon: LifeBuoyIcon, badge: 3 },
      { title: "Pengumuman", href: "#pengumuman", icon: MegaphoneIcon },
    ],
  },
  {
    label: "Katalog & Operasional",
    items: [
      { title: "Pengiriman", href: "#pengiriman", icon: TruckIcon, badge: 12 },
      {
        title: "Laporan",
        icon: FileTextIcon,
        items: [
          { title: "Rilisan", href: "#laporan-rilisan" },
          { title: "Laporan Pengiriman", href: "#laporan-pengiriman" },
          { title: "Laporan Trek", href: "#laporan-trek" },
        ],
      },
    ],
  },
  {
    label: "Manajemen Klien & Artis",
    items: [
      { title: "Klien", href: "#klien", icon: BuildingIcon },
      {
        title: "Artis",
        icon: MusicIcon,
        items: [
          { title: "Artis", href: "#artis" },
          { title: "Klien Artis", href: "#klien-artis" },
          { title: "Kandidat Premium", href: "#kandidat" },
        ],
      },
    ],
  },
  {
    label: "Keuangan & Royalti",
    items: [
      {
        title: "Royalti",
        icon: CoinsIcon,
        items: [
          { title: "Ringkasan", href: "#royalti" },
          { title: "Laporan Royalti", href: "#laporan-royalti", active: true },
          { title: "Unggah Laporan", href: "#unggah" },
          { title: "Penarikan", href: "#penarikan", badge: 5 },
        ],
      },
      {
        title: "Pajak",
        icon: PercentIcon,
        items: [
          { title: "Klien PPh21", href: "#pph21" },
          { title: "Pengaturan PPh21", href: "#pph21-pengaturan" },
        ],
      },
    ],
  },
  {
    label: "Sistem & Master Data",
    items: [
      {
        title: "Pengaturan",
        icon: SettingsIcon,
        items: [
          { title: "Opsi", href: "#opsi" },
          { title: "Template Email", href: "#template-email" },
        ],
      },
      {
        title: "Administrasi",
        icon: ShieldIcon,
        items: [
          { title: "Manajemen Staf", href: "#staf" },
          { title: "Log Aktivitas", href: "#log" },
        ],
      },
    ],
  },
]

export default function NavigationMenuDemo() {
  return (
    <DashboardShell
      nav={nav}
      labels={{ search: "Cari rilis, artis, atau dokumen", empty: "Tidak ada yang cocok.", account: "Akun {name}", menu: "Buka menu" }}
      logo={
        <span className="flex items-center gap-2 font-semibold">
          <span className="size-7 rounded-md bg-primary" />
          Loka Musik Admin
        </span>
      }
      account={{
        name: "Raka Pratama",
        initials: "RP",
        detail: "raka@contoh.id",
        menu: [{ label: "Profil" }, { label: "Keluar", destructive: true }],
      }}
      search={{ groups: [{ heading: "Menu", items: [{ label: "Laporan Royalti" }, { label: "Penarikan" }] }] }}
    >
      <h1 className="text-2xl font-semibold">Laporan Royalti</h1>
      <p className="mt-1 text-sm text-muted-foreground">Laporan dari aggregator yang sudah diunggah.</p>
      <div className="mt-6 grid gap-4 md:grid-cols-3">
        {[
          ["Laporan bulan ini", "18"],
          ["Menunggu diproses", "4"],
          ["Total pendapatan", "Rp182.430.000,00"],
        ].map(([label, value]) => (
          <Card key={label}>
            <CardHeader>
              <CardDescription>{label}</CardDescription>
              <CardTitle className="text-2xl tabular-nums">{value}</CardTitle>
            </CardHeader>
          </Card>
        ))}
      </div>
    </DashboardShell>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Building, Coins, FileText, LayoutDashboard, LifeBuoy, Megaphone, Music, Percent, Settings, Shield, Truck } from "@lucide/vue"
import type { DashboardNavSection } from "@/components/blocks/dashboard-shell"
import { DashboardShell } from "@/components/blocks/dashboard-shell"
import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"

// The Loka Musik admin menu: titled sections, pages, and parents that open a sub menu.
const nav: DashboardNavSection[] = [
  {
    label: "Overview & Support",
    items: [
      { title: "Dasbor", href: "#dasbor", icon: LayoutDashboard },
      { title: "Tiket Support", href: "#tiket", icon: LifeBuoy, badge: 3 },
      { title: "Pengumuman", href: "#pengumuman", icon: Megaphone },
    ],
  },
  {
    label: "Katalog & Operasional",
    items: [
      { title: "Pengiriman", href: "#pengiriman", icon: Truck, badge: 12 },
      {
        title: "Laporan",
        icon: FileText,
        items: [
          { title: "Rilisan", href: "#laporan-rilisan" },
          { title: "Laporan Pengiriman", href: "#laporan-pengiriman" },
          { title: "Laporan Trek", href: "#laporan-trek" },
        ],
      },
    ],
  },
  {
    label: "Manajemen Klien & Artis",
    items: [
      { title: "Klien", href: "#klien", icon: Building },
      {
        title: "Artis",
        icon: Music,
        items: [
          { title: "Artis", href: "#artis" },
          { title: "Klien Artis", href: "#klien-artis" },
          { title: "Kandidat Premium", href: "#kandidat" },
        ],
      },
    ],
  },
  {
    label: "Keuangan & Royalti",
    items: [
      {
        title: "Royalti",
        icon: Coins,
        items: [
          { title: "Ringkasan", href: "#royalti" },
          { title: "Laporan Royalti", href: "#laporan-royalti", active: true },
          { title: "Unggah Laporan", href: "#unggah" },
          { title: "Penarikan", href: "#penarikan", badge: 5 },
        ],
      },
      {
        title: "Pajak",
        icon: Percent,
        items: [
          { title: "Klien PPh21", href: "#pph21" },
          { title: "Pengaturan PPh21", href: "#pph21-pengaturan" },
        ],
      },
    ],
  },
  {
    label: "Sistem & Master Data",
    items: [
      {
        title: "Pengaturan",
        icon: Settings,
        items: [
          { title: "Opsi", href: "#opsi" },
          { title: "Template Email", href: "#template-email" },
        ],
      },
      {
        title: "Administrasi",
        icon: Shield,
        items: [
          { title: "Manajemen Staf", href: "#staf" },
          { title: "Log Aktivitas", href: "#log" },
        ],
      },
    ],
  },
]

const account = {
  name: "Raka Pratama",
  initials: "RP",
  detail: "raka@contoh.id",
  menu: [{ label: "Profil" }, { label: "Keluar", destructive: true }],
}
const search = { groups: [{ heading: "Menu", items: [{ label: "Laporan Royalti" }, { label: "Penarikan" }] }] }
const labels = { search: "Cari rilis, artis, atau dokumen", empty: "Tidak ada yang cocok.", account: "Akun {name}", menu: "Buka menu" }
const stats = [
  ["Laporan bulan ini", "18"],
  ["Menunggu diproses", "4"],
  ["Total pendapatan", "Rp182.430.000,00"],
]
</script>

<template>
  <DashboardShell :nav="nav" :account="account" :search="search" :labels="labels">
    <template #logo>
      <span class="flex items-center gap-2 font-semibold">
        <span class="size-7 rounded-md bg-primary" />
        Loka Musik Admin
      </span>
    </template>
    <h1 class="text-2xl font-semibold">Laporan Royalti</h1>
    <p class="mt-1 text-sm text-muted-foreground">Laporan dari aggregator yang sudah diunggah.</p>
    <div class="mt-6 grid gap-4 md:grid-cols-3">
      <Card v-for="[label, value] in stats" :key="label">
        <CardHeader>
          <CardDescription>{{ label }}</CardDescription>
          <CardTitle class="text-2xl tabular-nums">{{ value }}</CardTitle>
        </CardHeader>
      </Card>
    </div>
  </DashboardShell>
</template>
```

**Flutter**
```dart
// The navigation menu of a product with many pages, such as the Loka Musik admin: titled sections, pages,
// and parents that open a sub menu in place. A parent is not a page; it opens on its own when one of its
// pages is the current page. Put this column in the sidebar of the dashboard frame.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

class _Page {
  const _Page(this.title, {this.icon, this.active = false, this.badge});
  final String title;
  final IconData? icon;
  final bool active;
  final int? badge;
}

class _Parent {
  const _Parent(this.title, this.icon, this.pages);
  final String title;
  final IconData icon;
  final List<_Page> pages;
}

const _sections = <(String, List<Object>)>[
  ('Overview & Support', [
    _Page('Dasbor', icon: LucideIcons.layoutDashboard),
    _Page('Tiket Support', icon: LucideIcons.lifeBuoy, badge: 3),
  ]),
  ('Katalog & Operasional', [
    _Page('Pengiriman', icon: LucideIcons.truck, badge: 12),
    _Parent('Laporan', LucideIcons.fileText, [_Page('Rilisan'), _Page('Laporan Pengiriman'), _Page('Laporan Trek')]),
  ]),
  ('Keuangan & Royalti', [
    _Parent('Royalti', LucideIcons.coins, [
      _Page('Ringkasan'),
      _Page('Laporan Royalti', active: true),
      _Page('Unggah Laporan'),
      _Page('Penarikan', badge: 5),
    ]),
    _Parent('Pajak', LucideIcons.percent, [_Page('Klien PPh21'), _Page('Pengaturan PPh21')]),
  ]),
];

class NavigationMenuDemo extends StatelessWidget {
  const NavigationMenuDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Container(
      width: 256,
      padding: const EdgeInsets.all(8),
      decoration: BoxDecoration(
        color: theme.colorScheme.card,
        border: Border(right: BorderSide(color: theme.colorScheme.border)),
      ),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.stretch,
        mainAxisSize: MainAxisSize.min,
        children: [
          for (final (label, entries) in _sections) ...[
            Padding(
              padding: const EdgeInsets.fromLTRB(8, 12, 8, 4),
              child: Text(label, style: theme.textTheme.small.copyWith(color: theme.colorScheme.mutedForeground, fontSize: 12)),
            ),
            for (final entry in entries)
              if (entry is _Parent) _ParentEntry(parent: entry) else _PageEntry(page: entry as _Page),
          ],
        ],
      ),
    );
  }
}

class _PageEntry extends StatelessWidget {
  const _PageEntry({required this.page, this.indent = false});

  final _Page page;
  final bool indent;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    return Semantics(
      selected: page.active,
      child: ShadButton.ghost(
        height: indent ? 32 : 36,
        mainAxisAlignment: MainAxisAlignment.start,
        backgroundColor: page.active ? c.primarySoft : null,
        foregroundColor: page.active ? c.primaryText : theme.colorScheme.foreground,
        leading: page.icon == null ? null : Icon(page.icon, size: 16),
        trailing: page.badge == null ? null : Text('${page.badge}', style: theme.textTheme.small.copyWith(fontSize: 12)),
        onPressed: () {},
        child: Expanded(child: Text(page.title, overflow: TextOverflow.ellipsis)),
      ),
    );
  }
}

class _ParentEntry extends StatefulWidget {
  const _ParentEntry({required this.parent});

  final _Parent parent;

  @override
  State<_ParentEntry> createState() => _ParentEntryState();
}

class _ParentEntryState extends State<_ParentEntry> {
  // A parent opens on its own when one of its pages is the current page.
  late bool _open = widget.parent.pages.any((p) => p.active);

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return Column(
      crossAxisAlignment: CrossAxisAlignment.stretch,
      children: [
        Semantics(
          expanded: _open,
          child: ShadButton.ghost(
            mainAxisAlignment: MainAxisAlignment.start,
            foregroundColor: theme.colorScheme.foreground,
            leading: Icon(widget.parent.icon, size: 16),
            trailing: AnimatedRotation(
              turns: _open ? 0.25 : 0,
              duration: const Duration(milliseconds: 200),
              child: const Icon(LucideIcons.chevronRight, size: 16),
            ),
            onPressed: () => setState(() => _open = !_open),
            child: Expanded(child: Text(widget.parent.title)),
          ),
        ),
        if (_open)
          Container(
            margin: const EdgeInsets.only(left: 15),
            padding: const EdgeInsets.only(left: 9),
            decoration: BoxDecoration(border: Border(left: BorderSide(color: theme.colorScheme.border))),
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.stretch,
              children: [for (final page in widget.parent.pages) _PageEntry(page: page, indent: true)],
            ),
          ),
      ],
    );
  }
}
```

## Pasang

Menu ini bagian dari blok Dasbor; pasang dari halaman [Dasbor](https://design.sosialoka.tech/id/patterns/dashboard/#pasang).

## Aksesibilitas

- Induk berupa tombol dengan `aria-expanded` dan `aria-controls` yang menunjuk sub menunya.
- Halaman saat ini punya `aria-current="page"`, termasuk di dalam sub menu.
- Judul bagian menamai kelompok link di bawahnya.
- Hitungan dibacakan bersama halamannya, misalnya "Tiket Support 3".


---

# Aplikasi mobile

> Kerangka aplikasi HP. Isinya top bar dengan judul dan pencarian, konten, dan bottom nav berisi 3 sampai 5 tujuan.

Kerangka aplikasi mobile adalah versi HP dari [Dasbor](https://design.sosialoka.tech/id/patterns/dashboard/): judul, pencarian, dan tujuan utama ada di tempat yang sama di setiap aplikasi Sosialoka, dari Cover Clearance sampai My Loka Link.

## Kapan dipakai

- Pakai untuk setiap layar aplikasi HP setelah masuk, dan untuk aplikasi web di HP.
- Taruh list, detail, dan form di dalamnya. Jangan membuat header atau navigasi kedua.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/mobile-app/_

## Anatomi

1. **Top bar:** tinggi 56px, dengan judul layar di kiri dan maksimal dua tombol ikon di kanan, misalnya notifikasi. Kolom pencarian opsional ada di bawahnya.
2. **Konten:** layarnya, berlatar `background`, dengan ruang di bawah supaya item terakhir tidak tertutup bottom nav.
3. **Bottom nav:** 3 sampai 5 tujuan, masing-masing ikon di atas label. Tujuan saat ini berwarna `primary`, tanpa pil di belakangnya.

## Aturan

- **Top bar hanya berisi judul, dua tombol ikon, dan pencarian.** Sapaan, kartu ringkasan, tab, dan filter masuk ke konten di bawahnya.
- **Beranda:** sapaan, judul kartu unggulan, dan angka utama di bagian atas boleh memakai `font-brand`; selebihnya tetap `font-sans`. Lihat [Momen brand](https://design.sosialoka.tech/id/brand/#momen-brand).
- **Bottom nav:** 3 sampai 5 tujuan, label selalu tampil, target setinggi minimal 48px. Taruh Akun paling akhir.
- **Urutkan dan filter** membuka [Drawer](https://design.sosialoka.tech/id/components/drawer/) dari bawah, bukan halaman.
- **Baris** memakai [Item](https://design.sosialoka.tech/id/components/item/); status ditaruh di [Badge](https://design.sosialoka.tech/id/components/badge/) pada barisnya.
- **Safe area:** top bar dan bottom nav menjauhi notch dan garis home (`env(safe-area-inset-*)`).

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `title` | `title` | `Text` | teks | tidak ada | Judul layar. |
| `nav` | `nav` | `Row` berisi tombol ikon dan label | `{ title, href, icon, active? }[]` | tidak ada | Bottom nav. |
| `actions` | slot `#actions` | `ShadIconButton.ghost` | elemen | tidak ada | Maksimal dua tombol ikon di top bar. |
| `search` | slot `#search` | `ShadInput` | elemen | tidak ada | Pencarian opsional di bawah judul. |
| `labels` | `labels` | `Semantics` | `{ nav }` | bahasa Inggris | Nama bottom nav untuk pembaca layar, misalnya "Navigasi utama". |
| `children` | slot bawaan | anak `Expanded` | elemen | tidak ada | Isi layar. |

## Kode

**React**
```tsx
import { useId } from "react"
import { BarChart3Icon, BellIcon, DiscIcon, HomeIcon, SearchIcon, UserIcon } from "lucide-react"
import { MobileShell } from "@/components/blocks/mobile-shell"
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import {
  Drawer,
  DrawerClose,
  DrawerContent,
  DrawerFooter,
  DrawerHeader,
  DrawerTitle,
  DrawerTrigger,
} from "@/components/ui/drawer"
import { InputGroup, InputGroupAddon, InputGroupInput } from "@/components/ui/input-group"
import { Item, ItemContent, ItemDescription, ItemGroup, ItemTitle } from "@/components/ui/item"
import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const nav = [
  { title: "Beranda", href: "#", icon: HomeIcon },
  { title: "Rilis", href: "#rilis", icon: DiscIcon, active: true },
  { title: "Royalti", href: "#royalti", icon: BarChart3Icon },
  { title: "Notifikasi", href: "#notifikasi", icon: BellIcon },
  { title: "Akun", href: "#akun", icon: UserIcon },
]

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak" },
  { title: "Jalan Pulang", artist: "Raka Pratama", status: "success", label: "Terbit" },
] as const

export default function MobileShellDemo() {
  const id = useId()
  return (
    <MobileShell
      title="Rilis"
      nav={nav}
      labels={{ nav: "Navigasi utama" }}
      actions={
        <Button variant="ghost" size="icon-lg" className="size-11" aria-label="Notifikasi">
          <BellIcon />
        </Button>
      }
      search={
        <InputGroup>
          <InputGroupAddon>
            <SearchIcon />
          </InputGroupAddon>
          <InputGroupInput type="search" aria-label="Cari rilis" placeholder="Cari judul atau artis" />
        </InputGroup>
      }
    >
      <div className="mb-3 flex items-center justify-between">
        <p className="text-sm text-muted-foreground">6 rilis</p>
        <Drawer>
          <DrawerTrigger render={<Button variant="outline" size="sm" />}>Urutkan</DrawerTrigger>
          <DrawerContent>
            <DrawerHeader>
              <DrawerTitle>Urutkan rilis</DrawerTitle>
            </DrawerHeader>
            <RadioGroup defaultValue="newest" aria-label="Urutan" className="px-4">
              {[
                ["newest", "Terbaru"],
                ["oldest", "Terlama"],
                ["title", "Judul A–Z"],
              ].map(([value, label]) => (
                <div key={value} className="flex items-center gap-3">
                  <RadioGroupItem value={value} id={`${id}-${value}`} />
                  <Label htmlFor={`${id}-${value}`}>{label}</Label>
                </div>
              ))}
            </RadioGroup>
            <DrawerFooter>
              <DrawerClose render={<Button />}>Terapkan</DrawerClose>
            </DrawerFooter>
          </DrawerContent>
        </Drawer>
      </div>
      <ItemGroup className="gap-2">
        {releases.map((r) => (
          <Item key={r.title} variant="outline" render={<a href="#" />}>
            <ItemContent>
              <ItemTitle>{r.title}</ItemTitle>
              <ItemDescription>{r.artist}</ItemDescription>
            </ItemContent>
            <Badge variant={r.status}>{r.label}</Badge>
          </Item>
        ))}
      </ItemGroup>
    </MobileShell>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { useId } from "vue"
import { BarChart3, Bell, Disc, Home, Search, User } from "@lucide/vue"
import { MobileShell } from "@/components/blocks/mobile-shell"
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import { Drawer, DrawerClose, DrawerContent, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger } from "@/components/ui/drawer"
import { InputGroup, InputGroupAddon, InputGroupInput } from "@/components/ui/input-group"
import { Item, ItemContent, ItemDescription, ItemGroup, ItemTitle } from "@/components/ui/item"
import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"

const nav = [
  { title: "Beranda", href: "#", icon: Home },
  { title: "Rilis", href: "#rilis", icon: Disc, active: true },
  { title: "Royalti", href: "#royalti", icon: BarChart3 },
  { title: "Notifikasi", href: "#notifikasi", icon: Bell },
  { title: "Akun", href: "#akun", icon: User },
]

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak" },
  { title: "Jalan Pulang", artist: "Raka Pratama", status: "success", label: "Terbit" },
] as const

const orders = [
  { value: "newest", label: "Terbaru" },
  { value: "oldest", label: "Terlama" },
  { value: "title", label: "Judul A–Z" },
]
const id = useId()
</script>

<template>
  <MobileShell title="Rilis" :nav="nav" :labels="{ nav: 'Navigasi utama' }">
    <template #actions>
      <Button variant="ghost" size="icon-lg" class="size-11" aria-label="Notifikasi">
        <Bell />
      </Button>
    </template>
    <template #search>
      <InputGroup>
        <InputGroupAddon>
          <Search />
        </InputGroupAddon>
        <InputGroupInput type="search" aria-label="Cari rilis" placeholder="Cari judul atau artis" />
      </InputGroup>
    </template>

    <div class="mb-3 flex items-center justify-between">
      <p class="text-sm text-muted-foreground">6 rilis</p>
      <Drawer>
        <DrawerTrigger as-child>
          <Button variant="outline" size="sm">Urutkan</Button>
        </DrawerTrigger>
        <DrawerContent>
          <DrawerHeader>
            <DrawerTitle>Urutkan rilis</DrawerTitle>
          </DrawerHeader>
          <RadioGroup default-value="newest" aria-label="Urutan" class="px-4">
            <div v-for="o in orders" :key="o.value" class="flex items-center gap-3">
              <RadioGroupItem :id="`${id}-${o.value}`" :value="o.value" />
              <Label :for="`${id}-${o.value}`">{{ o.label }}</Label>
            </div>
          </RadioGroup>
          <DrawerFooter>
            <DrawerClose as-child>
              <Button>Terapkan</Button>
            </DrawerClose>
          </DrawerFooter>
        </DrawerContent>
      </Drawer>
    </div>
    <ItemGroup class="gap-2">
      <Item v-for="r in releases" :key="r.title" variant="outline" as-child>
        <a href="#">
          <ItemContent>
            <ItemTitle>{{ r.title }}</ItemTitle>
            <ItemDescription>{{ r.artist }}</ItemDescription>
          </ItemContent>
          <Badge :variant="r.status">{{ r.label }}</Badge>
        </a>
      </Item>
    </ItemGroup>
  </MobileShell>
</template>
```

**Flutter**
```dart
// The phone app frame: a top bar with the title, one icon button and the search, the content, and a
// bottom nav of five destinations. Greetings, summary cards, tabs and filters go in the content.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const mobileNav = [
  (LucideIcons.house, 'Beranda'),
  (LucideIcons.disc, 'Rilis'),
  (LucideIcons.chartColumn, 'Royalti'),
  (LucideIcons.bell, 'Notifikasi'),
  (LucideIcons.user, 'Akun'),
];

const mobileReleases = [
  ('Senja di Kota', 'Rara Senandika', 'Terbit'),
  ('Kaset Pertama', 'Bima Laras', 'Menunggu'),
  ('Pulang Sore', 'Nada Kirana', 'Dijadwalkan'),
  ('Hujan Bulan Juni', 'Arka Wening', 'Terbit'),
  ('Lampu Kota', 'Sinta Maharani', 'Ditolak'),
  ('Jalan Pulang', 'Raka Pratama', 'Terbit'),
];

class MobileShellDemo extends StatelessWidget {
  const MobileShellDemo({super.key, this.active = 1});

  final int active;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final border = BorderSide(color: theme.colorScheme.border);
    return SizedBox(
      width: 390,
      height: 720,
      child: DecoratedBox(
        decoration: BoxDecoration(color: theme.colorScheme.background),
        child: Column(
          children: [
            // Top bar: title, at most two icon buttons, then the search.
            DecoratedBox(
              decoration: BoxDecoration(border: Border(bottom: border)),
              child: Padding(
                padding: const EdgeInsets.fromLTRB(16, 0, 16, 12),
                child: Column(
                  children: [
                    SizedBox(
                      height: 56,
                      child: Row(
                        children: [
                          Expanded(child: Text('Rilis', style: theme.textTheme.large)),
                          ShadIconButton.ghost(
                            width: 44,
                            height: 44,
                            icon: const Icon(LucideIcons.bell, size: 20, semanticLabel: 'Notifikasi'),
                            onPressed: () {},
                          ),
                        ],
                      ),
                    ),
                    const ShadInput(
                      placeholder: Text('Cari judul atau artis'),
                      leading: Icon(LucideIcons.search, size: 16),
                    ),
                  ],
                ),
              ),
            ),
            Expanded(
              child: ListView.separated(
                padding: const EdgeInsets.all(16),
                itemCount: mobileReleases.length,
                separatorBuilder: (_, _) => const SizedBox(height: 8),
                itemBuilder: (context, i) {
                  final (title, artist, status) = mobileReleases[i];
                  // ShadItem's actions slot is narrow, so the status badge sits beside the title.
                  return ShadItem.outline(
                    title: Row(children: [Expanded(child: Text(title)), ShadBadge.secondary(child: Text(status))]),
                    description: Text(artist),
                    onPressed: () {},
                  );
                },
              ),
            ),
            // Bottom nav: icon above an always-visible label, 48px tall targets, the current page in primary.
            DecoratedBox(
              decoration: BoxDecoration(border: Border(top: border), color: theme.colorScheme.background),
              child: SafeArea(
                top: false,
                child: Row(
                  children: [
                    for (var i = 0; i < mobileNav.length; i++)
                      Expanded(
                        child: Semantics(
                          selected: i == active,
                          button: true,
                          child: GestureDetector(
                            onTap: () {},
                            child: ConstrainedBox(
                              constraints: const BoxConstraints(minHeight: 56),
                              child: Column(
                                mainAxisAlignment: MainAxisAlignment.center,
                                spacing: 4,
                                children: [
                                  Icon(
                                    mobileNav[i].$1,
                                    size: 20,
                                    color: i == active ? theme.colorScheme.primary : theme.colorScheme.mutedForeground,
                                  ),
                                  Text(
                                    mobileNav[i].$2,
                                    maxLines: 1,
                                    overflow: TextOverflow.ellipsis,
                                    style: theme.textTheme.small.copyWith(
                                      fontSize: 12,
                                      color: i == active ? theme.colorScheme.primary : theme.colorScheme.mutedForeground,
                                    ),
                                  ),
                                ],
                              ),
                            ),
                          ),
                        ),
                      ),
                  ],
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/mobile-shell.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/mobile-shell.json
```

Blok ini masuk ke `components/blocks/`. Pasang [Item](https://design.sosialoka.tech/id/components/item/), [Drawer](https://design.sosialoka.tech/id/components/drawer/), [Badge](https://design.sosialoka.tech/id/components/badge/), [Input Group](https://design.sosialoka.tech/id/components/input-group/), [Button](https://design.sosialoka.tech/id/components/button/), [Label](https://design.sosialoka.tech/id/components/label/), dan [Radio Group](https://design.sosialoka.tech/id/components/radio-group/) untuk isi yang ditampilkan di sini.

## Flutter

Aplikasi Flutter membangun kerangka yang sama dari widget: `Column` berisi top bar, daftar `ShadItem` di dalam `Expanded`, dan baris tombol ikon dan label di dalam `SafeArea`. `NavigationBar` Material juga boleh dipakai asal mengikuti aturan yang sama: label selalu tampil, item saat ini berwarna `primary`, tanpa indikator pil.

## Aksesibilitas

- Bottom nav berupa `nav` bernama "Main navigation" secara bawaan ("Navigasi utama" di contoh); tujuan saat ini punya `aria-current="page"`.
- Setiap tujuan menampilkan labelnya, jadi tidak pernah hanya mengandalkan ikon.
- Tombol ikon di top bar punya nama, misalnya "Notifikasi".
- Lonceng membuka halaman notifikasi, bukan popover: lihat [Notifikasi](https://design.sosialoka.tech/id/patterns/notifications/).


---

# List

> Halaman list. Isinya statistik, pencarian dan filter, tabel dengan aksi baris, dan pagination.

Sebagian besar layar di produk Sosialoka berawal dari list: rilis, kontrak, pembayaran, artis. Bagian-bagian halaman list selalu sama dan urutannya juga sama, jadi orang tahu harus melihat ke mana di produk mana pun.

## Kapan dipakai

- Pakai untuk kumpulan data yang orang telusuri, cari, dan olah.
- Untuk satu data, pakai halaman [Detail](https://design.sosialoka.tech/id/patterns/detail/). Kalau kumpulannya masih kosong, tampilkan [state kosong](https://design.sosialoka.tech/id/patterns/states/), bukan tabel kosong.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/list/_

## Anatomi

1. **Header:** judul halaman dan satu aksi utama, misalnya "Rilis baru".
2. **Statistik:** maksimal empat kartu, masing-masing berisi label dan angka.
3. **Filter:** pencarian di atas, lalu chip status ([Toggle Group](https://design.sosialoka.tech/id/components/toggle-group/)) beserta jumlah tiap status. Letaknya di atas tabel yang difilter.
4. **Tabel:** di dalam kartu, dengan kolom badge status dan satu tombol aksi baris di ujung.
5. **Pagination:** di bawah tabel, masih di dalam kartu yang sama.

## Aturan

- **Satu aksi utama** di header. Aksi lain ada di menu baris.
- **Menu baris:** beri tombolnya nama sesuai barisnya ("Aksi untuk Senja di Kota"). Item destruktif ditaruh paling akhir, setelah pemisah.
- **Status:** pakai badge status (`success`, `warning`, `info`, `destructive`), jangan warna brand.
- **Angka:** rata kanan hanya di kolom uang. Pakai `tabular-nums`, dan tulis Rupiah dengan dua desimal.
- **Chip status** selalu punya satu status aktif: "Semua" sebagai bawaan, dan klik pada chip yang aktif tetap membuatnya aktif.
- **Filter** menyimpan nilainya di URL, jadi tautan yang dibagikan membuka tampilan yang sama.
- **Di HP,** ubah tabel menjadi accordion: lihat [Tabel responsif](https://design.sosialoka.tech/id/patterns/responsive-table/).

## Kode

**React**
```tsx
import { useState, type MouseEvent } from "react"
import { MoreHorizontalIcon, PlusIcon, SearchIcon } from "lucide-react"
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Input } from "@/components/ui/input"
import {
  Pagination,
  PaginationContent,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

const stats = [
  { label: "Rilis aktif", value: "24" },
  { label: "Menunggu dikirim", value: "3" },
  { label: "Royalti bulan ini", value: "Rp4.812.500,00" },
]

const statuses = [
  { label: "Semua", value: "semua", count: 24 },
  { label: "Terbit", value: "terbit", count: 12 },
  { label: "Menunggu", value: "menunggu", count: 8 },
  { label: "Ditolak", value: "ditolak", count: 4 },
]

const releases = [
  { title: "Senja di Kota", artist: "Raka Pratama", status: "success", label: "Terbit", date: "14 Nov 2026" },
  { title: "Kaset Pertama", artist: "Nadia Senja", status: "warning", label: "Menunggu", date: "21 Nov 2026" },
  { title: "Pulang Sore", artist: "Bima Laras", status: "info", label: "Dijadwalkan", date: "28 Nov 2026" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak", date: "2 Nov 2026" },
] as const

/** Two pages of four rows; the demo shows the first page's rows on both. */
const pages = [1, 2]

/** A list page: title and one main action, stats, filters above the table, row actions in a menu, pages below. */
export default function ListPageDemo() {
  const [page, setPage] = useState(1)
  const [status, setStatus] = useState("semua")
  const goTo = (next: number) => (event: MouseEvent) => {
    event.preventDefault()
    setPage(next)
  }
  return (
    <div className="min-h-svh bg-background p-6 text-foreground">
      <div className="mx-auto grid max-w-5xl gap-6">
        <div className="flex items-center justify-between gap-4">
          <h1 className="text-2xl font-semibold">Rilis</h1>
          <Button>
            <PlusIcon />
            Rilis baru
          </Button>
        </div>

        <div className="grid gap-4 sm:grid-cols-3">
          {stats.map((stat) => (
            <Card key={stat.label}>
              <CardHeader>
                <CardDescription>{stat.label}</CardDescription>
                <CardTitle className="text-2xl tabular-nums">{stat.value}</CardTitle>
              </CardHeader>
            </Card>
          ))}
        </div>

        <div className="flex flex-wrap items-center gap-3">
          <div className="relative w-full max-w-xs">
            <SearchIcon className="pointer-events-none absolute top-1/2 left-2.5 size-4 -translate-y-1/2 text-muted-foreground" />
            <Input type="search" aria-label="Cari rilis" placeholder="Cari judul atau artis" className="pl-8" />
          </div>
        </div>

        <ToggleGroup
          variant="outline"
          spacing={2}
          aria-label="Filter status"
          value={[status]}
          // A status filter always has one value: clicking the active chip keeps it on.
          onValueChange={(value) => value.length > 0 && setStatus(value[value.length - 1])}
        >
          {statuses.map((s) => (
            <ToggleGroupItem key={s.value} value={s.value}>
              {s.label}
              <span className="tabular-nums text-muted-foreground">{s.count}</span>
            </ToggleGroupItem>
          ))}
        </ToggleGroup>

        <div className="rounded-xl border border-border bg-card">
          <Table>
            <TableHeader>
              <TableRow>
                <TableHead>Judul</TableHead>
                <TableHead>Artis</TableHead>
                <TableHead>Status</TableHead>
                <TableHead>Tanggal rilis</TableHead>
                <TableHead className="w-12">
                  <span className="sr-only">Aksi</span>
                </TableHead>
              </TableRow>
            </TableHeader>
            <TableBody>
              {releases.map((r) => (
                <TableRow key={r.title}>
                  <TableCell className="font-medium">{r.title}</TableCell>
                  <TableCell className="text-muted-foreground">{r.artist}</TableCell>
                  <TableCell>
                    <Badge variant={r.status}>{r.label}</Badge>
                  </TableCell>
                  <TableCell className="tabular-nums">{r.date}</TableCell>
                  <TableCell>
                    <DropdownMenu>
                      <DropdownMenuTrigger
                        render={<Button variant="ghost" size="icon-sm" aria-label={`Aksi untuk ${r.title}`} />}
                      >
                        <MoreHorizontalIcon />
                      </DropdownMenuTrigger>
                      <DropdownMenuContent align="end">
                        <DropdownMenuItem>Lihat</DropdownMenuItem>
                        <DropdownMenuItem>Ubah</DropdownMenuItem>
                        <DropdownMenuSeparator />
                        <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
                      </DropdownMenuContent>
                    </DropdownMenu>
                  </TableCell>
                </TableRow>
              ))}
            </TableBody>
          </Table>
          <Pagination className="border-t border-border py-2">
            <PaginationContent>
              <PaginationItem>
                <PaginationPrevious href="#" disabled={page === 1} onClick={goTo(page - 1)} />
              </PaginationItem>
              {pages.map((p) => (
                <PaginationItem key={p}>
                  <PaginationLink href="#" isActive={p === page} onClick={goTo(p)}>
                    {p}
                  </PaginationLink>
                </PaginationItem>
              ))}
              <PaginationItem>
                <PaginationNext href="#" disabled={page === pages.length} onClick={goTo(page + 1)} />
              </PaginationItem>
            </PaginationContent>
          </Pagination>
        </div>
      </div>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import { MoreHorizontal, Plus, Search } from "@lucide/vue"
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Input } from "@/components/ui/input"
import {
  Pagination,
  PaginationContent,
  PaginationItem,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

/** A list page: title and one main action, stats, filters above the table, row actions in a menu, pages below. */
const stats = [
  { label: "Rilis aktif", value: "24" },
  { label: "Menunggu dikirim", value: "3" },
  { label: "Royalti bulan ini", value: "Rp4.812.500,00" },
]

const statuses = [
  { label: "Semua", value: "semua", count: 24 },
  { label: "Terbit", value: "terbit", count: 12 },
  { label: "Menunggu", value: "menunggu", count: 8 },
  { label: "Ditolak", value: "ditolak", count: 4 },
]

const releases = [
  { title: "Senja di Kota", artist: "Raka Pratama", status: "success", label: "Terbit", date: "14 Nov 2026" },
  { title: "Kaset Pertama", artist: "Nadia Senja", status: "warning", label: "Menunggu", date: "21 Nov 2026" },
  { title: "Pulang Sore", artist: "Bima Laras", status: "info", label: "Dijadwalkan", date: "28 Nov 2026" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak", date: "2 Nov 2026" },
] as const
const status = ref("semua")
// A status filter always has one value: clicking the active chip keeps it on.
function pickStatus(value: unknown) {
  if (typeof value === "string" && value) status.value = value
}
</script>

<template>
  <div class="min-h-svh bg-background p-6 text-foreground">
    <div class="mx-auto grid max-w-5xl gap-6">
      <div class="flex items-center justify-between gap-4">
        <h1 class="text-2xl font-semibold">Rilis</h1>
        <Button><Plus />Rilis baru</Button>
      </div>

      <div class="grid gap-4 sm:grid-cols-3">
        <Card v-for="stat in stats" :key="stat.label">
          <CardHeader>
            <CardDescription>{{ stat.label }}</CardDescription>
            <CardTitle class="text-2xl tabular-nums">{{ stat.value }}</CardTitle>
          </CardHeader>
        </Card>
      </div>

      <div class="flex flex-wrap items-center gap-3">
        <div class="relative w-full max-w-xs">
          <Search class="pointer-events-none absolute top-1/2 left-2.5 size-4 -translate-y-1/2 text-muted-foreground" />
          <Input type="search" aria-label="Cari rilis" placeholder="Cari judul atau artis" class="pl-8" />
        </div>
      </div>

      <ToggleGroup type="single" variant="outline" :spacing="2" aria-label="Filter status" :model-value="status" @update:model-value="pickStatus">
        <ToggleGroupItem v-for="s in statuses" :key="s.value" :value="s.value">
          {{ s.label }}
          <span class="tabular-nums text-muted-foreground">{{ s.count }}</span>
        </ToggleGroupItem>
      </ToggleGroup>

      <div class="rounded-xl border border-border bg-card">
        <Table>
          <TableHeader>
            <TableRow>
              <TableHead>Judul</TableHead>
              <TableHead>Artis</TableHead>
              <TableHead>Status</TableHead>
              <TableHead>Tanggal rilis</TableHead>
              <TableHead class="w-12"><span class="sr-only">Aksi</span></TableHead>
            </TableRow>
          </TableHeader>
          <TableBody>
            <TableRow v-for="r in releases" :key="r.title">
              <TableCell class="font-medium">{{ r.title }}</TableCell>
              <TableCell class="text-muted-foreground">{{ r.artist }}</TableCell>
              <TableCell><Badge :variant="r.status">{{ r.label }}</Badge></TableCell>
              <TableCell class="tabular-nums">{{ r.date }}</TableCell>
              <TableCell>
                <DropdownMenu>
                  <DropdownMenuTrigger as-child>
                    <Button variant="ghost" size="icon-sm" :aria-label="`Aksi untuk ${r.title}`"><MoreHorizontal /></Button>
                  </DropdownMenuTrigger>
                  <DropdownMenuContent align="end">
                    <DropdownMenuItem>Lihat</DropdownMenuItem>
                    <DropdownMenuItem>Ubah</DropdownMenuItem>
                    <DropdownMenuSeparator />
                    <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
                  </DropdownMenuContent>
                </DropdownMenu>
              </TableCell>
            </TableRow>
          </TableBody>
        </Table>
        <Pagination v-slot="{ page }" :items-per-page="4" :total="8" :default-page="1" class="border-t border-border py-2">
          <PaginationContent v-slot="{ items }">
            <PaginationPrevious />
            <template v-for="(item, index) in items" :key="index">
              <PaginationItem v-if="item.type === 'page'" :value="item.value" :is-active="item.value === page">
                {{ item.value }}
              </PaginationItem>
            </template>
            <PaginationNext />
          </PaginationContent>
        </Pagination>
      </div>
    </div>
  </div>
</template>
```

**Flutter**
```dart
// A list page: title and one main action, stats, filters above the table, row actions in a menu, pages below.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _stats = [('Rilis aktif', '24'), ('Menunggu dikirim', '3'), ('Royalti bulan ini', 'Rp4.812.500,00')];
const _releases = [
  (title: 'Senja di Kota', artist: 'Raka Pratama', status: 'Terbit', date: '14 Nov 2026'),
  (title: 'Kaset Pertama', artist: 'Nadia Senja', status: 'Menunggu', date: '21 Nov 2026'),
  (title: 'Pulang Sore', artist: 'Bima Laras', status: 'Dijadwalkan', date: '28 Nov 2026'),
];

class ListPageDemo extends StatelessWidget {
  const ListPageDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 880),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          Row(
            children: [
              Expanded(child: Text('Rilis', style: theme.textTheme.h3)),
              ShadButton(
                leading: const Icon(LucideIcons.plus, size: 16),
                onPressed: () {},
                child: const Text('Rilis baru'),
              ),
            ],
          ),
          const SizedBox(height: 16),
          Row(
            children: [
              for (final (label, value) in _stats) ...[
                Expanded(
                  child: ShadCard(description: Text(label), title: Text(value, style: theme.textTheme.h4)),
                ),
                if (label != _stats.last.$1) const SizedBox(width: 16),
              ],
            ],
          ),
          const SizedBox(height: 16),
          const SizedBox(
            width: 320,
            child: ShadInput(
              placeholder: Text('Cari judul atau artis'),
              leading: Icon(LucideIcons.search, size: 16),
            ),
          ),
          const SizedBox(height: 12),
          // A status filter always has one value: allowDeselection keeps the active chip on.
          ShadToggleGroup<String>(
            initialValue: 'semua',
            allowDeselection: false,
            variant: ShadToggleVariant.outline,
            spacing: 8,
            items: [
              for (final (value, label, count) in const [('semua', 'Semua', 24), ('terbit', 'Terbit', 12), ('menunggu', 'Menunggu', 8), ('ditolak', 'Ditolak', 4)])
                ShadToggleGroupItem(
                  value: value,
                  child: Row(
                    mainAxisSize: MainAxisSize.min,
                    spacing: 6,
                    children: [Text(label), Text('$count', style: theme.textTheme.muted)],
                  ),
                ),
            ],
          ),
          const SizedBox(height: 16),
          ShadCard(
            padding: EdgeInsets.zero,
            child: SizedBox(
              height: 200,
              child: ShadTable.list(
                columnSpanExtent: (index) => switch (index) {
                  0 => const FixedTableSpanExtent(220),
                  1 => const FixedTableSpanExtent(180),
                  2 => const FixedTableSpanExtent(150),
                  3 => const FixedTableSpanExtent(150),
                  _ => const RemainingTableSpanExtent(),
                },
                header: const [
                  ShadTableCell.header(child: Text('Judul')),
                  ShadTableCell.header(child: Text('Artis')),
                  ShadTableCell.header(child: Text('Status')),
                  ShadTableCell.header(child: Text('Tanggal rilis')),
                  ShadTableCell.header(child: SizedBox.shrink()),
                ],
                children: _releases.map(
                  (r) => [
                    ShadTableCell(child: Text(r.title, style: const TextStyle(fontWeight: FontWeight.w500))),
                    ShadTableCell(child: Text(r.artist)),
                    ShadTableCell(child: ShadBadge.outline(child: Text(r.status))),
                    ShadTableCell(child: Text(r.date)),
                    ShadTableCell(child: _RowActions(title: r.title)),
                  ],
                ),
              ),
            ),
          ),
          const SizedBox(height: 8),
          Row(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ShadButton.ghost(onPressed: () {}, child: const Text('Sebelumnya')),
              ShadButton.outline(onPressed: () {}, child: const Text('1')),
              ShadButton.ghost(onPressed: () {}, child: const Text('2')),
              ShadButton.ghost(onPressed: () {}, child: const Text('Berikutnya')),
            ],
          ),
        ],
      ),
    );
  }
}

/// The row's actions behind one button, with the destructive one last.
class _RowActions extends StatefulWidget {
  const _RowActions({required this.title});

  final String title;

  @override
  State<_RowActions> createState() => _RowActionsState();
}

class _RowActionsState extends State<_RowActions> {
  final controller = ShadContextMenuController();

  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return ShadContextMenu(
      controller: controller,
      items: [
        const ShadContextMenuItem(child: Text('Lihat')),
        const ShadContextMenuItem(child: Text('Ubah')),
        const ShadSeparator.horizontal(margin: EdgeInsets.symmetric(vertical: 4)),
        ShadContextMenuItem(child: Text('Hapus', style: TextStyle(color: context.sosialoka.destructive))),
      ],
      child: Semantics(
        label: 'Aksi untuk ${widget.title}',
        child: ShadIconButton.ghost(icon: const Icon(LucideIcons.ellipsis), onPressed: controller.toggle),
      ),
    );
  }
}
```

## Dibangun dari

[Button](https://design.sosialoka.tech/id/components/button/), [Card](https://design.sosialoka.tech/id/components/card/), [Input](https://design.sosialoka.tech/id/components/input/), [Toggle Group](https://design.sosialoka.tech/id/components/toggle-group/), [Table](https://design.sosialoka.tech/id/components/table/), [Badge](https://design.sosialoka.tech/id/components/badge/), dan [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/).

## Flutter

Baris tabel diisi lewat `ShadTable.list`. shadcn_ui tidak punya widget pagination, jadi taruh tombol outline dan ghost di bawah tabel. Buka aksi baris lewat `ShadContextMenu`, dan beri tombolnya label semantik.


---

# Tabel responsif

> Tabel di layar lebar yang berubah menjadi accordion di HP, dengan semua kolom dan aksinya tetap ada.

Tabel responsif menampilkan data dalam tabel di layar lebar dan sebagai accordion di HP, tempat tabel biasa harus di-scroll ke samping.

## Kapan dipakai

- Pakai untuk halaman list yang harus jalan di HP, misalnya rilis atau pembayaran.
- Pertahankan [Table](https://design.sosialoka.tech/id/components/table/) apa adanya mulai `md`; di bawahnya, setiap baris menjadi satu item [Accordion](https://design.sosialoka.tech/id/components/accordion/).
- Pakai daftar baris [Item](https://design.sosialoka.tech/id/components/item/) kalau satu baris hanya punya dua atau tiga data.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/responsive-table/_

## Anatomi

1. **Mulai `md`:** tabel di dalam kartu, dengan aksi baris di ujung setiap baris.
2. **Di bawah `md`:** satu item accordion per baris. Trigger berisi kolom utama (judul) dan badge status; isinya memuat kolom lain sebagai pasangan label–nilai beserta aksi barisnya.

## Aturan

- **Data dan aksinya sama.** Setiap kolom dan aksi di tabel tetap ada di accordion.
- **Hanya satu yang tampil.** Sembunyikan yang lain dengan `hidden` / `md:hidden`, supaya pembaca layar tidak membacakan data dua kali.
- **Trigger:** judul dan status saja, supaya daftar yang tertutup tetap mudah dipindai.
- **Tanpa scroll ke samping** di lebar 390px.

## Kode

**React**
```tsx
import { MoreHorizontalIcon } from "lucide-react"
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion"
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit", date: "14 Nov 2026" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu", date: "21 Nov 2026" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan", date: "28 Nov 2026" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit", date: "3 Nov 2026" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak", date: "2 Nov 2026" },
] as const

function RowActions({ title }: { title: string }) {
  return (
    <DropdownMenu>
      <DropdownMenuTrigger render={<Button variant="ghost" size="icon-sm" aria-label={`Aksi untuk ${title}`} />}>
        <MoreHorizontalIcon />
      </DropdownMenuTrigger>
      <DropdownMenuContent align="end">
        <DropdownMenuItem>Lihat</DropdownMenuItem>
        <DropdownMenuItem>Ubah</DropdownMenuItem>
        <DropdownMenuSeparator />
        <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
      </DropdownMenuContent>
    </DropdownMenu>
  )
}

/** A table from md up; below it every row becomes an accordion item. Only one of them is ever shown. */
export default function ResponsiveTableDemo() {
  return (
    <div className="min-h-svh bg-background p-4 text-foreground md:p-6">
      <div className="hidden rounded-xl border border-border bg-card md:block">
        <Table>
          <TableHeader>
            <TableRow>
              <TableHead>Judul</TableHead>
              <TableHead>Artis</TableHead>
              <TableHead>Status</TableHead>
              <TableHead>Tanggal</TableHead>
              <TableHead className="w-12">
                <span className="sr-only">Aksi</span>
              </TableHead>
            </TableRow>
          </TableHeader>
          <TableBody>
            {releases.map((r) => (
              <TableRow key={r.title}>
                <TableCell className="font-medium">{r.title}</TableCell>
                <TableCell className="text-muted-foreground">{r.artist}</TableCell>
                <TableCell>
                  <Badge variant={r.status}>{r.label}</Badge>
                </TableCell>
                <TableCell className="text-muted-foreground">{r.date}</TableCell>
                <TableCell>
                  <RowActions title={r.title} />
                </TableCell>
              </TableRow>
            ))}
          </TableBody>
        </Table>
      </div>

      <Accordion className="rounded-xl border border-border bg-card px-4 md:hidden">
        {releases.map((r) => (
          <AccordionItem key={r.title} value={r.title}>
            <AccordionTrigger>
              <span className="flex flex-1 items-center justify-between gap-2">
                <span>{r.title}</span>
                <Badge variant={r.status}>{r.label}</Badge>
              </span>
            </AccordionTrigger>
            <AccordionContent>
              <dl className="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1">
                <dt className="text-muted-foreground">Artis</dt>
                <dd>{r.artist}</dd>
                <dt className="text-muted-foreground">Tanggal</dt>
                <dd>{r.date}</dd>
              </dl>
              <div className="mt-2 flex justify-end">
                <RowActions title={r.title} />
              </div>
            </AccordionContent>
          </AccordionItem>
        ))}
      </Accordion>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { MoreHorizontal } from "@lucide/vue"
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion"
import { Badge } from "@/components/ui/badge"
import { Button } from "@/components/ui/button"
import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger } from "@/components/ui/dropdown-menu"
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from "@/components/ui/table"

const releases = [
  { title: "Senja di Kota", artist: "Rara Senandika", status: "success", label: "Terbit", date: "14 Nov 2026" },
  { title: "Kaset Pertama", artist: "Bima Laras", status: "warning", label: "Menunggu", date: "21 Nov 2026" },
  { title: "Pulang Sore", artist: "Nada Kirana", status: "info", label: "Dijadwalkan", date: "28 Nov 2026" },
  { title: "Hujan Bulan Juni", artist: "Arka Wening", status: "success", label: "Terbit", date: "3 Nov 2026" },
  { title: "Lampu Kota", artist: "Sinta Maharani", status: "destructive", label: "Ditolak", date: "2 Nov 2026" },
] as const
</script>

<!-- A table from md up; below it every row becomes an accordion item. Only one of them is ever shown. -->
<template>
  <div class="min-h-svh bg-background p-4 text-foreground md:p-6">
    <div class="hidden rounded-xl border border-border bg-card md:block">
      <Table>
        <TableHeader>
          <TableRow>
            <TableHead>Judul</TableHead>
            <TableHead>Artis</TableHead>
            <TableHead>Status</TableHead>
            <TableHead>Tanggal</TableHead>
            <TableHead class="w-12"><span class="sr-only">Aksi</span></TableHead>
          </TableRow>
        </TableHeader>
        <TableBody>
          <TableRow v-for="r in releases" :key="r.title">
            <TableCell class="font-medium">{{ r.title }}</TableCell>
            <TableCell class="text-muted-foreground">{{ r.artist }}</TableCell>
            <TableCell><Badge :variant="r.status">{{ r.label }}</Badge></TableCell>
            <TableCell class="text-muted-foreground">{{ r.date }}</TableCell>
            <TableCell>
              <DropdownMenu>
                <DropdownMenuTrigger as-child>
                  <Button variant="ghost" size="icon-sm" :aria-label="`Aksi untuk ${r.title}`"><MoreHorizontal /></Button>
                </DropdownMenuTrigger>
                <DropdownMenuContent align="end">
                  <DropdownMenuItem>Lihat</DropdownMenuItem>
                  <DropdownMenuItem>Ubah</DropdownMenuItem>
                  <DropdownMenuSeparator />
                  <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
                </DropdownMenuContent>
              </DropdownMenu>
            </TableCell>
          </TableRow>
        </TableBody>
      </Table>
    </div>

    <Accordion type="single" collapsible class="rounded-xl border border-border bg-card px-4 md:hidden">
      <AccordionItem v-for="r in releases" :key="r.title" :value="r.title">
        <AccordionTrigger>
          <span class="flex flex-1 items-center justify-between gap-2">
            <span>{{ r.title }}</span>
            <Badge :variant="r.status">{{ r.label }}</Badge>
          </span>
        </AccordionTrigger>
        <AccordionContent>
          <dl class="grid grid-cols-[auto_1fr] gap-x-4 gap-y-1">
            <dt class="text-muted-foreground">Artis</dt>
            <dd>{{ r.artist }}</dd>
            <dt class="text-muted-foreground">Tanggal</dt>
            <dd>{{ r.date }}</dd>
          </dl>
          <div class="mt-2 flex justify-end">
            <DropdownMenu>
              <DropdownMenuTrigger as-child>
                <Button variant="ghost" size="icon-sm" :aria-label="`Aksi untuk ${r.title}`"><MoreHorizontal /></Button>
              </DropdownMenuTrigger>
              <DropdownMenuContent align="end">
                <DropdownMenuItem>Lihat</DropdownMenuItem>
                <DropdownMenuItem>Ubah</DropdownMenuItem>
                <DropdownMenuSeparator />
                <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
              </DropdownMenuContent>
            </DropdownMenu>
          </div>
        </AccordionContent>
      </AccordionItem>
    </Accordion>
  </div>
</template>
```

**Flutter**
```dart
// A table on wide screens; below 768 logical pixels every row becomes an accordion item.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

const tableReleases = [
  ('Senja di Kota', 'Rara Senandika', 'Terbit', '14 Nov 2026'),
  ('Kaset Pertama', 'Bima Laras', 'Menunggu', '21 Nov 2026'),
  ('Pulang Sore', 'Nada Kirana', 'Dijadwalkan', '28 Nov 2026'),
  ('Hujan Bulan Juni', 'Arka Wening', 'Terbit', '3 Nov 2026'),
  ('Lampu Kota', 'Sinta Maharani', 'Ditolak', '2 Nov 2026'),
];

class ResponsiveTableDemo extends StatelessWidget {
  const ResponsiveTableDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return LayoutBuilder(
      builder: (context, constraints) {
        if (constraints.maxWidth >= 768) {
          return SizedBox(
            height: 320,
            child: ShadTable.list(
              columnSpanExtent: (index) => switch (index) {
                0 => const FixedTableSpanExtent(220),
                1 => const FixedTableSpanExtent(200),
                2 => const FixedTableSpanExtent(160),
                _ => const RemainingTableSpanExtent(),
              },
              header: const [
                ShadTableCell.header(child: Text('Judul')),
                ShadTableCell.header(child: Text('Artis')),
                ShadTableCell.header(child: Text('Status')),
                ShadTableCell.header(child: Text('Tanggal')),
              ],
              children: [
                for (final (title, artist, status, date) in tableReleases)
                  [
                    ShadTableCell(child: Text(title)),
                    ShadTableCell(child: Text(artist)),
                    ShadTableCell(child: ShadBadge.secondary(child: Text(status))),
                    ShadTableCell(child: Text(date)),
                  ],
              ],
            ),
          );
        }
        return ShadAccordion<String>(
          children: [
            for (final (title, artist, status, date) in tableReleases)
              ShadAccordionItem(
                value: title,
                title: Row(
                  children: [Expanded(child: Text(title)), ShadBadge.secondary(child: Text(status))],
                ),
                child: Column(
                  crossAxisAlignment: CrossAxisAlignment.start,
                  spacing: 4,
                  children: [
                    Text('Artis: $artist', style: theme.textTheme.muted),
                    Text('Tanggal: $date', style: theme.textTheme.muted),
                    Align(
                      alignment: Alignment.centerRight,
                      child: ShadIconButton.ghost(
                        icon: Icon(LucideIcons.ellipsis, size: 16, semanticLabel: 'Aksi untuk $title'),
                        onPressed: () {},
                      ),
                    ),
                  ],
                ),
              ),
          ],
        );
      },
    );
  }
}
```

## Dibangun dari

[Table](https://design.sosialoka.tech/id/components/table/), [Accordion](https://design.sosialoka.tech/id/components/accordion/), [Badge](https://design.sosialoka.tech/id/components/badge/), dan [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/).

## Flutter

Pakai `LayoutBuilder`: mulai 768 logical pixel tampilkan `ShadTable.list`; di bawahnya, `ShadAccordion` dengan satu item per baris.


---

# Detail

> Halaman satu data. Isinya judul dengan status dan aksi utama, tabs, dan pasangan label–nilai.

Halaman detail menampilkan satu data dan langkah berikutnya untuk data itu.

## Kapan dipakai

- Pakai saat orang membuka satu baris dari halaman [List](https://design.sosialoka.tech/id/patterns/list/).
- Untuk data yang cukup dilihat sekilas, pakai [Dialog](https://design.sosialoka.tech/id/components/dialog/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/detail/_

## Anatomi

1. **[Breadcrumb](https://design.sosialoka.tech/id/components/breadcrumb/)** di atas judul: list-nya, lalu record ini sebagai halaman saat ini.
2. **Header:** judul, badge status, satu aksi utama, dan menu untuk aksi lainnya.
3. **Tabs** bergaris bawah, satu tab per bagian data.
4. **Fakta:** pasangan label–nilai (`dl`) di dalam kartu. Label berwarna `muted-foreground` dan ada di atas nilainya.

## Aturan

- **Satu aksi utama:** langkah yang memajukan data ini, misalnya "Kirim ke platform". Sembunyikan kalau tidak ada langkah berikutnya.
- **Label di atas nilai,** dalam grid dua atau tiga kolom. Jangan pakai tabel dua kolom untuk fakta.
- **Tabs** dibuka di tab ringkasan. Buat isi tiap tab cukup pendek supaya mudah dipindai.

## Kode

**React**
```tsx
import { MoreHorizontalIcon } from "lucide-react"
import { Badge } from "@/components/ui/badge"
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"
import { Button } from "@/components/ui/button"
import { Card, CardContent } from "@/components/ui/card"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"

const facts = [
  { term: "Artis", value: "Raka Pratama" },
  { term: "Label", value: "Rekaman Senja" },
  { term: "Genre", value: "Pop" },
  { term: "Tanggal rilis", value: "14 Nov 2026" },
  { term: "UPC", value: "198765432109" },
  { term: "Jumlah lagu", value: "4" },
]

/** A record page: back link, title with status and one main action, tabs, then label–value pairs. */
export default function DetailPageDemo() {
  return (
    <div className="min-h-svh bg-background p-6 text-foreground">
      <div className="mx-auto grid max-w-5xl gap-6">
        <Breadcrumb>
          <BreadcrumbList>
            <BreadcrumbItem>
              <BreadcrumbLink href="#">Rilis</BreadcrumbLink>
            </BreadcrumbItem>
            <BreadcrumbSeparator />
            <BreadcrumbItem>
              <BreadcrumbPage>Senja di Kota</BreadcrumbPage>
            </BreadcrumbItem>
          </BreadcrumbList>
        </Breadcrumb>
        <div className="flex flex-wrap items-center justify-between gap-4">
          <div className="flex items-center gap-3">
            <h1 className="text-2xl font-semibold">Senja di Kota</h1>
            <Badge variant="warning">Menunggu</Badge>
          </div>
          <div className="flex items-center gap-2">
            <Button>Kirim ke platform</Button>
            <DropdownMenu>
              <DropdownMenuTrigger render={<Button variant="outline" size="icon" aria-label="Aksi lainnya" />}>
                <MoreHorizontalIcon />
              </DropdownMenuTrigger>
              <DropdownMenuContent align="end">
                <DropdownMenuItem>Ubah</DropdownMenuItem>
                <DropdownMenuItem>Unduh metadata</DropdownMenuItem>
                <DropdownMenuSeparator />
                <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
              </DropdownMenuContent>
            </DropdownMenu>
          </div>
        </div>

        <Tabs defaultValue="ringkasan">
          <TabsList>
            <TabsTrigger value="ringkasan">Ringkasan</TabsTrigger>
            <TabsTrigger value="lagu">Lagu</TabsTrigger>
            <TabsTrigger value="dokumen">Dokumen</TabsTrigger>
          </TabsList>
          <TabsContent value="ringkasan" className="pt-4">
            <Card>
              <CardContent>
                <dl className="grid gap-x-6 gap-y-4 sm:grid-cols-3">
                  {facts.map((f) => (
                    <div key={f.term} className="grid gap-1">
                      <dt className="text-sm text-muted-foreground">{f.term}</dt>
                      <dd className="font-medium">{f.value}</dd>
                    </div>
                  ))}
                </dl>
              </CardContent>
            </Card>
          </TabsContent>
          <TabsContent value="lagu" className="pt-4 text-muted-foreground">
            Empat lagu siap dikirim.
          </TabsContent>
          <TabsContent value="dokumen" className="pt-4 text-muted-foreground">
            Perjanjian rilis sudah ditandatangani.
          </TabsContent>
        </Tabs>
      </div>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { MoreHorizontal } from "@lucide/vue"
import { Badge } from "@/components/ui/badge"
import { Breadcrumb, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "@/components/ui/breadcrumb"
import { Button } from "@/components/ui/button"
import { Card, CardContent } from "@/components/ui/card"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs"

/** A record page: back link, title with status and one main action, tabs, then label–value pairs. */
const facts = [
  { term: "Artis", value: "Raka Pratama" },
  { term: "Label", value: "Rekaman Senja" },
  { term: "Genre", value: "Pop" },
  { term: "Tanggal rilis", value: "14 Nov 2026" },
  { term: "UPC", value: "198765432109" },
  { term: "Jumlah lagu", value: "4" },
]
</script>

<template>
  <div class="min-h-svh bg-background p-6 text-foreground">
    <div class="mx-auto grid max-w-5xl gap-6">
      <Breadcrumb>
        <BreadcrumbList>
          <BreadcrumbItem>
            <BreadcrumbLink href="#">Rilis</BreadcrumbLink>
          </BreadcrumbItem>
          <BreadcrumbSeparator />
          <BreadcrumbItem>
            <BreadcrumbPage>Senja di Kota</BreadcrumbPage>
          </BreadcrumbItem>
        </BreadcrumbList>
      </Breadcrumb>
      <div class="flex flex-wrap items-center justify-between gap-4">
        <div class="flex items-center gap-3">
          <h1 class="text-2xl font-semibold">Senja di Kota</h1>
          <Badge variant="warning">Menunggu</Badge>
        </div>
        <div class="flex items-center gap-2">
          <Button>Kirim ke platform</Button>
          <DropdownMenu>
            <DropdownMenuTrigger as-child>
              <Button variant="outline" size="icon" aria-label="Aksi lainnya"><MoreHorizontal /></Button>
            </DropdownMenuTrigger>
            <DropdownMenuContent align="end">
              <DropdownMenuItem>Ubah</DropdownMenuItem>
              <DropdownMenuItem>Unduh metadata</DropdownMenuItem>
              <DropdownMenuSeparator />
              <DropdownMenuItem variant="destructive">Hapus</DropdownMenuItem>
            </DropdownMenuContent>
          </DropdownMenu>
        </div>
      </div>

      <Tabs default-value="ringkasan">
        <TabsList>
          <TabsTrigger value="ringkasan">Ringkasan</TabsTrigger>
          <TabsTrigger value="lagu">Lagu</TabsTrigger>
          <TabsTrigger value="dokumen">Dokumen</TabsTrigger>
        </TabsList>
        <TabsContent value="ringkasan" class="pt-4">
          <Card>
            <CardContent>
              <dl class="grid gap-x-6 gap-y-4 sm:grid-cols-3">
                <div v-for="f in facts" :key="f.term" class="grid gap-1">
                  <dt class="text-sm text-muted-foreground">{{ f.term }}</dt>
                  <dd class="font-medium">{{ f.value }}</dd>
                </div>
              </dl>
            </CardContent>
          </Card>
        </TabsContent>
        <TabsContent value="lagu" class="pt-4 text-muted-foreground">Empat lagu siap dikirim.</TabsContent>
        <TabsContent value="dokumen" class="pt-4 text-muted-foreground">Perjanjian rilis sudah ditandatangani.</TabsContent>
      </Tabs>
    </div>
  </div>
</template>
```

**Flutter**
```dart
// A record page: breadcrumb, title with status and one main action, tabs, then label–value pairs.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _facts = [
  ('Artis', 'Raka Pratama'),
  ('Label', 'Rekaman Senja'),
  ('Genre', 'Pop'),
  ('Tanggal rilis', '14 Nov 2026'),
  ('UPC', '198765432109'),
  ('Jumlah lagu', '4'),
];

class DetailPageDemo extends StatelessWidget {
  const DetailPageDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 880),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          ShadBreadcrumb(
            children: [
              ShadBreadcrumbLink(onPressed: () {}, child: const Text('Rilis')),
              Semantics(selected: true, child: const Text('Senja di Kota')),
            ],
          ),
          const SizedBox(height: 8),
          Row(
            children: [
              Text('Senja di Kota', style: theme.textTheme.h3),
              const SizedBox(width: 12),
              ShadBadge(backgroundColor: c.warningSoft, foregroundColor: c.warning, child: const Text('Menunggu')),
              const Spacer(),
              ShadButton(onPressed: () {}, child: const Text('Kirim ke platform')),
            ],
          ),
          const SizedBox(height: 16),
          ShadTabs<String>(
            value: 'ringkasan',
            // Tabs share the bar width equally; leave room for the longest label.
            tabBarConstraints: const BoxConstraints(maxWidth: 520),
            tabs: [
              ShadTab(
                value: 'ringkasan',
                content: ShadCard(
                  child: Wrap(
                    spacing: 24,
                    runSpacing: 16,
                    children: [
                      for (final (term, value) in _facts)
                        SizedBox(
                          width: 240,
                          child: Column(
                            crossAxisAlignment: CrossAxisAlignment.start,
                            children: [
                              Text(term, style: theme.textTheme.muted),
                              const SizedBox(height: 4),
                              Text(value, style: const TextStyle(fontWeight: FontWeight.w500)),
                            ],
                          ),
                        ),
                    ],
                  ),
                ),
                child: const Text('Ringkasan'),
              ),
              const ShadTab(value: 'lagu', content: Text('Empat lagu siap dikirim.'), child: Text('Lagu')),
              const ShadTab(
                value: 'dokumen',
                content: Text('Perjanjian rilis sudah ditandatangani.'),
                child: Text('Dokumen'),
              ),
            ],
          ),
        ],
      ),
    );
  }
}
```

## Dibangun dari

[Breadcrumb](https://design.sosialoka.tech/id/components/breadcrumb/), [Button](https://design.sosialoka.tech/id/components/button/), [Badge](https://design.sosialoka.tech/id/components/badge/), [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/), [Tabs](https://design.sosialoka.tech/id/components/tabs/), dan [Card](https://design.sosialoka.tech/id/components/card/).

## Flutter

Pakai `ShadTabs` yang cukup lebar untuk label terpanjang, dan `Wrap` berisi kolom label–nilai di dalam `ShadCard`.


---

# Form

> Form dengan label di atas isian, hint satu kalimat, error dari backend, dan aksi di footer.

Tampilan dan perilaku form sama di semua produk dan framework. Ini termasuk Flutter, yang dulu memakai floating label di dalam isian.

## Kapan dipakai

- Pakai untuk membuat atau mengubah data.
- Form yang panjang dipecah menjadi beberapa kartu, masing-masing dengan satu judul. Untuk masuk, pakai pola [Login](https://design.sosialoka.tech/id/patterns/login/).

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/form/_

## Anatomi

1. **Kartu** berisi judul dan satu kalimat tentang apa yang perlu diisi.
2. **Isian,** masing-masing dengan label di atasnya dan hint satu kalimat di bawahnya (opsional).
3. **Error** di bawah isiannya, berwarna `destructive`, dan terhubung ke isian lewat `aria-describedby`.
4. **Footer:** "Batal" sebagai tombol outline, lalu aksi utama.

## Aturan

- **Label di atas isian,** jangan di dalamnya sebagai placeholder atau floating label.
- **Hint** cukup satu kalimat praktis: apa yang diisi, contoh, atau batasan.
- **Error datang dari backend.** Klien hanya mengaktifkan atau menonaktifkan tombol kirim, dan tidak pernah menulis pesan error sendiri. Isian yang error diberi `aria-invalid="true"`.
- **Satu aksi utama** per form, paling akhir di footer.

## Kode

**React**
```tsx
import { Button } from "@/components/ui/button"
import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/ui/card"
import { Checkbox } from "@/components/ui/checkbox"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"

const genres = [
  { label: "Pilih genre", value: null },
  { label: "Pop", value: "pop" },
  { label: "Rock", value: "rock" },
  { label: "Dangdut", value: "dangdut" },
  { label: "Jazz", value: "jazz" },
]

/**
 * A form: labels above the fields, a one-sentence hint under a field, the error the backend sent under its
 * field, and the actions in the card footer. The error text comes from the API response, never from the client.
 */
export default function FormPageDemo() {
  return (
    <div className="min-h-svh bg-background p-6 text-foreground">
      <form className="mx-auto max-w-2xl" onSubmit={(e) => e.preventDefault()}>
        <Card>
          <CardHeader>
            <CardTitle>Data rilis</CardTitle>
            <CardDescription>Isi sesuai yang akan tampil di platform musik.</CardDescription>
          </CardHeader>
          <CardContent className="grid gap-5">
            <div className="grid gap-2">
              <Label htmlFor="release-title">Judul</Label>
              <Input
                id="release-title"
                aria-invalid="true"
                aria-describedby="release-title-hint release-title-error"
              />
              <p id="release-title-hint" className="text-sm text-muted-foreground">
                Tulis persis seperti di sampul.
              </p>
              <p id="release-title-error" className="text-sm text-destructive">
                Judul lagunya belum diisi.
              </p>
            </div>
            <div className="grid gap-2">
              <Label htmlFor="release-artist">Artis</Label>
              <Input id="release-artist" defaultValue="Raka Pratama" />
            </div>
            <div className="grid gap-2">
              <Label htmlFor="release-genre">Genre</Label>
              <Select items={genres}>
                <SelectTrigger id="release-genre" className="w-full">
                  <SelectValue />
                </SelectTrigger>
                <SelectContent>
                  {genres
                    .filter((g) => g.value !== null)
                    .map((g) => (
                      <SelectItem key={g.value} value={g.value}>
                        {g.label}
                      </SelectItem>
                    ))}
                </SelectContent>
              </Select>
            </div>
            <div className="flex items-center gap-2">
              <Checkbox id="release-explicit" />
              <Label htmlFor="release-explicit">Lagu ini mengandung lirik eksplisit</Label>
            </div>
          </CardContent>
          <CardFooter className="justify-end gap-2">
            <Button type="button" variant="outline">
              Batal
            </Button>
            <Button type="submit">Simpan</Button>
          </CardFooter>
        </Card>
      </form>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Button } from "@/components/ui/button"
import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@/components/ui/card"
import { Checkbox } from "@/components/ui/checkbox"
import { Input } from "@/components/ui/input"
import { Label } from "@/components/ui/label"
import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"

/**
 * A form: labels above the fields, a one-sentence hint under a field, the error the backend sent under its
 * field, and the actions in the card footer. The error text comes from the API response, never from the client.
 */
const genres = [
  { label: "Pop", value: "pop" },
  { label: "Rock", value: "rock" },
  { label: "Dangdut", value: "dangdut" },
  { label: "Jazz", value: "jazz" },
]
</script>

<template>
  <div class="min-h-svh bg-background p-6 text-foreground">
    <form class="mx-auto max-w-2xl" @submit.prevent>
      <Card>
        <CardHeader>
          <CardTitle>Data rilis</CardTitle>
          <CardDescription>Isi sesuai yang akan tampil di platform musik.</CardDescription>
        </CardHeader>
        <CardContent class="grid gap-5">
          <div class="grid gap-2">
            <Label for="release-title-vue">Judul</Label>
            <Input id="release-title-vue" aria-invalid="true" aria-describedby="release-title-hint-vue release-title-error-vue" />
            <p id="release-title-hint-vue" class="text-sm text-muted-foreground">Tulis persis seperti di sampul.</p>
            <p id="release-title-error-vue" class="text-sm text-destructive">Judul lagunya belum diisi.</p>
          </div>
          <div class="grid gap-2">
            <Label for="release-artist-vue">Artis</Label>
            <Input id="release-artist-vue" default-value="Raka Pratama" />
          </div>
          <div class="grid gap-2">
            <Label for="release-genre-vue">Genre</Label>
            <Select>
              <SelectTrigger id="release-genre-vue" class="w-full">
                <SelectValue placeholder="Pilih genre" />
              </SelectTrigger>
              <SelectContent>
                <SelectItem v-for="g in genres" :key="g.value" :value="g.value">{{ g.label }}</SelectItem>
              </SelectContent>
            </Select>
          </div>
          <div class="flex items-center gap-2">
            <Checkbox id="release-explicit-vue" />
            <Label for="release-explicit-vue">Lagu ini mengandung lirik eksplisit</Label>
          </div>
        </CardContent>
        <CardFooter class="justify-end gap-2">
          <Button type="button" variant="outline">Batal</Button>
          <Button type="submit">Simpan</Button>
        </CardFooter>
      </Card>
    </form>
  </div>
</template>
```

**Flutter**
```dart
// A form: labels above the fields (ShadInputFormField's label, never a floating Material labelText),
// a one-sentence hint, the error the backend sent under its field, and the actions at the bottom.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class FormPageDemo extends StatelessWidget {
  const FormPageDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ShadCard(
      width: 576,
      title: Text('Data rilis', style: theme.textTheme.h4),
      description: const Text('Isi sesuai yang akan tampil di platform musik.'),
      footer: Row(
        mainAxisAlignment: MainAxisAlignment.end,
        children: [
          ShadButton.outline(onPressed: () {}, child: const Text('Batal')),
          const SizedBox(width: 8),
          ShadButton(onPressed: () {}, child: const Text('Simpan')),
        ],
      ),
      child: Padding(
        padding: const EdgeInsets.symmetric(vertical: 16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            ShadInputFormField(
              id: 'title',
              label: const Text('Judul'),
              description: const Text('Tulis persis seperti di sampul.'),
              // The message comes from the API response; the app never writes its own.
              forceErrorText: 'Judul lagunya belum diisi.',
            ),
            const SizedBox(height: 16),
            ShadInputFormField(id: 'artist', label: const Text('Artis'), initialValue: 'Raka Pratama'),
            const SizedBox(height: 16),
            ShadSelectFormField<String>(
              id: 'genre',
              label: const Text('Genre'),
              minWidth: 544,
              placeholder: const Text('Pilih genre'),
              options: const [
                ShadOption(value: 'pop', child: Text('Pop')),
                ShadOption(value: 'rock', child: Text('Rock')),
                ShadOption(value: 'dangdut', child: Text('Dangdut')),
                ShadOption(value: 'jazz', child: Text('Jazz')),
              ],
              selectedOptionBuilder: (context, value) => Text(value),
            ),
            const SizedBox(height: 16),
            ShadCheckboxFormField(
              id: 'explicit',
              initialValue: false,
              inputLabel: const Text('Lagu ini mengandung lirik eksplisit'),
            ),
          ],
        ),
      ),
    );
  }
}
```

## Dibangun dari

[Card](https://design.sosialoka.tech/id/components/card/), [Label](https://design.sosialoka.tech/id/components/label/), [Input](https://design.sosialoka.tech/id/components/input/), [Select](https://design.sosialoka.tech/id/components/select/), [Checkbox](https://design.sosialoka.tech/id/components/checkbox/), dan [Button](https://design.sosialoka.tech/id/components/button/).

## Flutter

Pakai `ShadInputFormField(label: …)`, bukan `InputDecoration.labelText`, supaya label ada di atas isian seperti di web. Tampilkan pesan dari backend lewat `forceErrorText`.


---

# Kosong, memuat, dan error

> Yang tampil di halaman saat belum ada isi, saat sedang memuat, dan saat gagal memuat.

Selain "terisi", setiap list dan kartu punya tiga state lagi. Tampilkan state itu di tempat isinya seharusnya muncul, dengan ukuran yang sama, supaya halaman tidak melompat.

## Kapan dipakai

- **Kosong:** kumpulan datanya belum ada isinya, atau tidak ada baris yang cocok dengan filter.
- **Memuat:** data sedang diambil. Tampilkan skeleton yang bentuknya mengikuti isi.
- **Error:** data gagal dimuat. Sebutkan apa yang gagal dan beri cara untuk mencoba lagi.

## Kosong

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/states/_

Isinya judul, satu kalimat tentang apa yang nanti muncul, dan satu aksi untuk mengisinya. Kalau filter menyembunyikan semua baris, aksinya adalah menghapus filter.

## Memuat

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/states/_

Isinya skeleton yang bentuknya mengikuti baris yang akan muncul, `aria-busy="true"` di wadahnya, dan satu kalimat untuk screen reader. Kalau proses memuat lebih cepat dari sekitar 300 ms, skeleton tidak perlu ditampilkan.

**React**
```tsx
import { Skeleton } from "@/components/ui/skeleton"

/** Loading: skeletons in the shape of the rows that are coming, and a sentence for screen readers. */
export default function LoadingStateDemo() {
  return (
    <div aria-busy="true" className="grid w-full max-w-md gap-4 rounded-xl border border-border bg-card p-4">
      <span className="sr-only">Memuat rilis…</span>
      {[0, 1, 2].map((row) => (
        <div key={row} className="flex items-center gap-3" aria-hidden="true">
          <Skeleton className="size-10 rounded-md" />
          <div className="grid flex-1 gap-2">
            <Skeleton className="h-4 w-2/3" />
            <Skeleton className="h-3 w-1/3" />
          </div>
        </div>
      ))}
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Skeleton } from "@/components/ui/skeleton"

/** Loading: skeletons in the shape of the rows that are coming, and a sentence for screen readers. */
</script>

<template>
  <div aria-busy="true" class="grid w-full max-w-md gap-4 rounded-xl border border-border bg-card p-4">
    <span class="sr-only">Memuat rilis…</span>
    <div v-for="row in 3" :key="row" class="flex items-center gap-3" aria-hidden="true">
      <Skeleton class="size-10 rounded-md" />
      <div class="grid flex-1 gap-2">
        <Skeleton class="h-4 w-2/3" />
        <Skeleton class="h-3 w-1/3" />
      </div>
    </div>
  </div>
</template>
```

**Flutter**
```dart
// Loading: placeholder bars in the shape of the rows that are coming, and a label for screen readers.
// shadcn_ui has no skeleton widget; muted boxes with the theme radius do the job.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class LoadingStateDemo extends StatelessWidget {
  const LoadingStateDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final muted = ShadTheme.of(context).colorScheme.muted;
    Widget bar(double width, double height) => Container(
      width: width,
      height: height,
      decoration: BoxDecoration(color: muted, borderRadius: BorderRadius.circular(6)),
    );
    return Semantics(
      label: 'Memuat rilis…',
      child: ExcludeSemantics(
        child: ShadCard(
          width: 448,
          child: Column(
            children: [
              for (var row = 0; row < 3; row++)
                Padding(
                  padding: const EdgeInsets.symmetric(vertical: 8),
                  child: Row(
                    children: [
                      bar(40, 40),
                      const SizedBox(width: 12),
                      Column(
                        crossAxisAlignment: CrossAxisAlignment.start,
                        children: [bar(240, 14), const SizedBox(height: 8), bar(120, 12)],
                      ),
                    ],
                  ),
                ),
            ],
          ),
        ),
      ),
    );
  }
}
```

## Error

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/states/_

Isinya `role="alert"`, apa yang gagal, apa yang perlu dilakukan, dan tombol "Coba lagi". Kalau backend mengirim pesan, pakai pesan itu.

**React**
```tsx
import { RefreshCwIcon, TriangleAlertIcon } from "lucide-react"
import { Button } from "@/components/ui/button"

/** Loading failed: what failed, what to do next, and a way to try again. */
export default function ErrorStateDemo() {
  return (
    <div
      role="alert"
      className="flex w-full max-w-md flex-col items-center gap-4 rounded-xl border border-border bg-card px-6 py-10 text-center"
    >
      <span className="grid size-12 place-items-center rounded-lg bg-destructive-soft text-destructive">
        <TriangleAlertIcon className="size-6" />
      </span>
      <div className="grid gap-1">
        <h2 className="text-lg font-semibold">Rilis belum bisa dimuat</h2>
        <p className="text-sm text-muted-foreground">Cek koneksimu, lalu coba lagi.</p>
      </div>
      <Button variant="outline">
        <RefreshCwIcon />
        Coba lagi
      </Button>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { RefreshCw, TriangleAlert } from "@lucide/vue"
import { Button } from "@/components/ui/button"

/** Loading failed: what failed, what to do next, and a way to try again. */
</script>

<template>
  <div role="alert" class="flex w-full max-w-md flex-col items-center gap-4 rounded-xl border border-border bg-card px-6 py-10 text-center">
    <span class="grid size-12 place-items-center rounded-lg bg-destructive-soft text-destructive">
      <TriangleAlert class="size-6" />
    </span>
    <div class="grid gap-1">
      <h2 class="text-lg font-semibold">Rilis belum bisa dimuat</h2>
      <p class="text-sm text-muted-foreground">Cek koneksimu, lalu coba lagi.</p>
    </div>
    <Button variant="outline"><RefreshCw />Coba lagi</Button>
  </div>
</template>
```

**Flutter**
```dart
// Loading failed: what failed, what to do next, and a way to try again. Announced as a live region.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

class ErrorStateDemo extends StatelessWidget {
  const ErrorStateDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final c = context.sosialoka;
    return Semantics(
      liveRegion: true,
      child: ConstrainedBox(
        constraints: const BoxConstraints(maxWidth: 448),
        child: Column(
          mainAxisSize: MainAxisSize.min,
          children: [
            Container(
              width: 48,
              height: 48,
              decoration: BoxDecoration(color: c.destructiveSoft, borderRadius: BorderRadius.circular(8)),
              child: Icon(LucideIcons.triangleAlert, color: c.destructive),
            ),
            const SizedBox(height: 16),
            Text('Rilis belum bisa dimuat', style: theme.textTheme.large),
            const SizedBox(height: 4),
            Text('Cek koneksimu, lalu coba lagi.', style: theme.textTheme.muted),
            const SizedBox(height: 16),
            ShadButton.outline(
              leading: const Icon(LucideIcons.refreshCw, size: 16),
              onPressed: () {},
              child: const Text('Coba lagi'),
            ),
          ],
        ),
      ),
    );
  }
}
```

## Kode state kosong

**React**
```tsx
import { DiscIcon, PlusIcon } from "lucide-react"
import { Button } from "@/components/ui/button"

/** Nothing here yet: what will appear, in one sentence, and the one action that fills it. */
export default function EmptyStateDemo() {
  return (
    <div className="flex w-full max-w-md flex-col items-center gap-4 rounded-xl border border-dashed border-border px-6 py-10 text-center">
      <span className="grid size-12 place-items-center rounded-lg bg-muted text-muted-foreground">
        <DiscIcon className="size-6" />
      </span>
      <div className="grid gap-1">
        <h2 className="text-lg font-semibold">Belum ada rilis</h2>
        <p className="text-sm text-muted-foreground">Rilis pertamamu akan muncul di sini.</p>
      </div>
      <Button>
        <PlusIcon />
        Rilis baru
      </Button>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Disc, Plus } from "@lucide/vue"
import { Button } from "@/components/ui/button"

/** Nothing here yet: what will appear, in one sentence, and the one action that fills it. */
</script>

<template>
  <div class="flex w-full max-w-md flex-col items-center gap-4 rounded-xl border border-dashed border-border px-6 py-10 text-center">
    <span class="grid size-12 place-items-center rounded-lg bg-muted text-muted-foreground">
      <Disc class="size-6" />
    </span>
    <div class="grid gap-1">
      <h2 class="text-lg font-semibold">Belum ada rilis</h2>
      <p class="text-sm text-muted-foreground">Rilis pertamamu akan muncul di sini.</p>
    </div>
    <Button><Plus />Rilis baru</Button>
  </div>
</template>
```

**Flutter**
```dart
// Nothing here yet: what will appear, in one sentence, and the one action that fills it.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class EmptyStateDemo extends StatelessWidget {
  const EmptyStateDemo({super.key});

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        children: [
          Container(
            width: 48,
            height: 48,
            decoration: BoxDecoration(color: theme.colorScheme.muted, borderRadius: BorderRadius.circular(8)),
            child: Icon(LucideIcons.disc, color: theme.colorScheme.mutedForeground),
          ),
          const SizedBox(height: 16),
          Text('Belum ada rilis', style: theme.textTheme.large),
          const SizedBox(height: 4),
          Text('Rilis pertamamu akan muncul di sini.', style: theme.textTheme.muted),
          const SizedBox(height: 16),
          ShadButton(
            leading: const Icon(LucideIcons.plus, size: 16),
            onPressed: () {},
            child: const Text('Rilis baru'),
          ),
        ],
      ),
    );
  }
}
```

## Dibangun dari

[Button](https://design.sosialoka.tech/id/components/button/) dan Skeleton, yang ikut terpasang bersama [Sidebar](https://design.sosialoka.tech/id/components/sidebar/).

## Flutter

shadcn_ui tidak punya widget skeleton. Kotak berwarna muted dengan radius tema sudah cukup. Bungkus state error dengan `Semantics(liveRegion: true)`.


---

# Notifikasi

> Panel lonceng dan halaman notifikasi. Yang belum dibaca didahulukan, kategorinya berupa chip, dan keduanya memakai satu baris yang sama.

Setiap produk Sosialoka mengabarkan perubahan di dua tempat yang sama: panel di bawah lonceng di header, dan halaman notifikasi yang berisi semuanya. Keduanya memakai baris yang sama, jadi sebuah notifikasi terlihat sama di mana pun ia muncul.

## Kapan dipakai

- Pakai panel untuk melihat sekilas: notifikasi terbaru dan cara menghapus badge.
- Pakai halaman untuk menelusuri semuanya, per kategori atau yang belum dibaca saja.
- Untuk pesan tentang halaman yang sedang dibuka, pakai [Alert](https://design.sosialoka.tech/id/components/alert/) atau [toast](https://design.sosialoka.tech/id/components/toast/), bukan notifikasi.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/notifications/_

## Anatomi

### Halaman

1. **Header:** judul "Notifikasi", satu baris keterangan, dan "Tandai semua dibaca".
2. **Chip kategori:** chip [Toggle Group](https://design.sosialoka.tech/id/components/toggle-group/), "Semua" paling depan, masing-masing dengan jumlah yang belum dibaca.
3. **Kartu:** saklar Semua / Belum dibaca dan menu halaman di atas, lalu baris yang dikelompokkan jadi "Hari ini" dan "Sebelumnya", lalu "Muat lagi".

### Baris

1. **Ikon:** ikon kategori di dalam lingkaran netral.
2. **Judul:** tebal selama belum dibaca.
3. **Isi:** satu atau dua baris.
4. **Waktu dan kategori:** "5 menit lalu · Pembayaran". Tanggal dan jam lengkap muncul sebagai tooltip.
5. **Titik belum dibaca** di ujung, lalu menu baris di sebelahnya.

### Panel

1. **Lonceng:** `DashboardIconButton` dari header [Dasbor](https://design.sosialoka.tech/id/patterns/dashboard/), dengan jumlah yang belum dibaca sebagai badge.
2. **Popover:** lebar 360px, dengan "Notifikasi", "Tandai semua dibaca", dan saklar Semua / Belum dibaca di atas.
3. **Baris:** maksimal 8, dikelompokkan per waktu, sama dengan baris di halaman.
4. **Footer:** "Lihat semua notifikasi" membuka halamannya.

## Aturan

- **Tandai semua dibaca** berlaku untuk kategori yang sedang aktif. Nonaktifkan tombolnya kalau tidak ada yang belum dibaca di situ.
- **Chip kategori** selalu punya satu kategori aktif: "Semua" sebagai bawaan, dan klik pada chip yang aktif tetap membuatnya aktif. Jumlahnya dibacakan sebagai kata, misalnya "Pembayaran (1 belum dibaca)". Di HP, chip tetap satu baris yang bisa digulir ke samping; mulai `sm`, chip turun ke baris baru. Kategori dan saklarnya disimpan di URL, sama seperti filter list.
- **Badge:** jumlah yang belum dibaca, "99+" kalau lebih dari 99, dan tidak tampil saat nol. Nama tombol lonceng ikut membawa jumlahnya, misalnya "Notifikasi (3)".
- **Panel:** maksimal 8 baris. Di HP, lonceng membuka halaman, bukan popover.
- **Klik** menandai notifikasi sebagai dibaca dan membuka halaman yang dibahasnya. Notifikasi tanpa tujuan hanya ditandai dibaca.
- **Menu baris:** beri tombolnya nama sesuai barisnya ("Aksi untuk Royalti Oktober sudah masuk"). "Tandai dibaca" atau "Tandai belum dibaca" di depan, lalu "Hapus" paling akhir, setelah pemisah. Hapus bersifat opsional: hilangkan kalau produknya belum bisa menghapus notifikasi. Setelah dihapus, fokus pindah ke baris berikutnya.
- **Hapus yang sudah dibaca** bertanya dulu lewat [Alert Dialog](https://design.sosialoka.tech/id/components/alert-dialog/), karena notifikasi yang dihapus tidak bisa kembali. Item ini nonaktif kalau tidak ada lagi yang sudah dibaca.
- **Ikon** menandai kategori dengan warna netral, jangan warna brand, supaya hanya yang belum dibaca yang menonjol.
- **Waktu:** relatif ("5 menit lalu", "Kemarin"). Tanggal dan jam lengkapnya muncul saat kursor diarahkan dan dibacakan oleh pembaca layar.
- **Lainnya:** "Muat lagi" di bawah baris, bukan nomor halaman; notifikasi dibaca dari yang terbaru.
- **State:** kategori kosong menampilkan "Belum ada notifikasi di kategori ini." dan tampilan belum dibaca yang kosong menampilkan "Semua notifikasi sudah kamu baca.". Memuat dan error mengikuti [Kosong, memuat, dan error](https://design.sosialoka.tech/id/patterns/states/).

## Kode

**React**
```tsx
import { useEffect, useRef, useState } from "react"
import {
  CheckCheckIcon,
  DiscIcon,
  FileCheckIcon,
  FileTextIcon,
  InfoIcon,
  MoreHorizontalIcon,
  WalletIcon,
  type LucideIcon,
} from "lucide-react"
import {
  AlertDialog,
  AlertDialogAction,
  AlertDialogCancel,
  AlertDialogContent,
  AlertDialogDescription,
  AlertDialogFooter,
  AlertDialogHeader,
  AlertDialogTitle,
} from "@/components/ui/alert-dialog"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"

type Category = "Pembayaran" | "Clearance" | "Laporan" | "Rilis" | "Umum"

interface Notification {
  id: number
  category: Category
  title: string
  body: string
  /** Relative time shown in the row. */
  time: string
  /** Full date and time, shown as the tooltip of the relative time. */
  at: string
  /** ISO date for the <time> element. */
  iso: string
  group: "Hari ini" | "Sebelumnya"
  read: boolean
  /** The page the notification is about. Without one, a click only marks it read. */
  href?: string
}

const ICONS: Record<Category, LucideIcon> = {
  Pembayaran: WalletIcon,
  Clearance: FileCheckIcon,
  Laporan: FileTextIcon,
  Rilis: DiscIcon,
  Umum: InfoIcon,
}

const CATEGORIES: Category[] = ["Pembayaran", "Clearance", "Laporan", "Rilis", "Umum"]

const NOTIFICATIONS: Notification[] = [
  { id: 1, category: "Pembayaran", title: "Royalti Oktober sudah masuk", body: "Rp1.250.000,00 masuk ke saldomu.", time: "5 menit lalu", at: "17 Nov 2026, 14.20", iso: "2026-11-17T14:20", group: "Hari ini", read: false, href: "#saldo" },
  { id: 2, category: "Clearance", title: 'Clearance "Langit Jingga" disetujui', body: "Videomu siap tayang.", time: "1 jam lalu", at: "17 Nov 2026, 13.25", iso: "2026-11-17T13:25", group: "Hari ini", read: false, href: "#clearance" },
  { id: 3, category: "Laporan", title: "Laporan royalti Oktober siap", body: "Cek pendapatan tiap platform.", time: "3 jam lalu", at: "17 Nov 2026, 11.05", iso: "2026-11-17T11:05", group: "Hari ini", read: false, href: "#laporan" },
  { id: 4, category: "Rilis", title: '"Senja di Kota" tayang di Spotify', body: "Rilismu sudah bisa diputar.", time: "Kemarin", at: "16 Nov 2026, 19.40", iso: "2026-11-16T19:40", group: "Sebelumnya", read: true, href: "#rilis" },
  { id: 5, category: "Pembayaran", title: "Tagihan langganan November", body: "Bayar sebelum 30 Nov 2026 supaya layananmu tetap jalan.", time: "Kemarin", at: "16 Nov 2026, 09.00", iso: "2026-11-16T09:00", group: "Sebelumnya", read: true, href: "#tagihan" },
  { id: 6, category: "Clearance", title: 'Clearance "Kaset Pertama" perlu diperbaiki', body: "Cek catatan dari tim kami, lalu kirim ulang.", time: "2 hari lalu", at: "15 Nov 2026, 10.15", iso: "2026-11-15T10:15", group: "Sebelumnya", read: true, href: "#clearance" },
  { id: 7, category: "Umum", title: "Kata sandimu baru saja diganti", body: "Bukan kamu? Segera hubungi kami.", time: "3 hari lalu", at: "14 Nov 2026, 08.30", iso: "2026-11-14T08:30", group: "Sebelumnya", read: true },
  { id: 8, category: "Rilis", title: '"Pulang Sore" dijadwalkan 28 Nov 2026', body: "Kami kirim ke semua platform di tanggal itu.", time: "4 hari lalu", at: "13 Nov 2026, 16.45", iso: "2026-11-13T16:45", group: "Sebelumnya", read: true, href: "#rilis" },
  { id: 9, category: "Laporan", title: "Laporan royalti September siap", body: "Cek pendapatan tiap platform.", time: "14 Okt 2026", at: "14 Okt 2026, 10.00", iso: "2026-10-14T10:00", group: "Sebelumnya", read: true, href: "#laporan" },
  { id: 10, category: "Pembayaran", title: "Royalti September sudah masuk", body: "Rp980.000,00 masuk ke saldomu.", time: "13 Okt 2026", at: "13 Okt 2026, 15.10", iso: "2026-10-13T15:10", group: "Sebelumnya", read: true, href: "#saldo" },
]

/** Rows shown before "Muat lagi". */
const FIRST_PAGE = 8

/**
 * One notification: category icon, title (bold while unread), body, time and category, an unread dot, and a menu
 * beside the row. The row is a link when it has a target, otherwise a button that only marks it read.
 */
function NotificationRow({
  notification: n,
  onOpen,
  onToggleRead,
  onRemove,
}: {
  notification: Notification
  onOpen: () => void
  onToggleRead: () => void
  onRemove: () => void
}) {
  const Icon = ICONS[n.category]
  const content = (
    <>
      <span className="flex size-9 shrink-0 items-center justify-center rounded-full bg-muted text-muted-foreground">
        <Icon className="size-4" />
      </span>
      <span className="min-w-0 flex-1">
        <span className={n.read ? "block text-sm" : "block text-sm font-semibold"}>{n.title}</span>
        <span className="mt-0.5 line-clamp-2 block text-sm text-muted-foreground">{n.body}</span>
        <span className="mt-1 block text-xs text-muted-foreground">
          <time dateTime={n.iso} title={n.at}>
            {n.time}
          </time>
          <span className="sr-only">, {n.at}</span>
          {" · "}
          {n.category}
        </span>
      </span>
      {n.read ? null : (
        <>
          <span aria-hidden="true" className="mt-1.5 size-2 shrink-0 rounded-full bg-primary" />
          <span className="sr-only">Belum dibaca</span>
        </>
      )}
    </>
  )
  const rowClass = "flex min-w-0 flex-1 items-start gap-3 rounded-lg px-2 py-2 text-left outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
  return (
    <li className={n.read ? "flex items-start gap-1 px-2 py-1" : "flex items-start gap-1 bg-muted/50 px-2 py-1"}>
      {n.href ? (
        <a href={n.href} data-notification={n.id} className={rowClass} onClick={onOpen}>
          {content}
        </a>
      ) : (
        <button type="button" data-notification={n.id} className={rowClass} onClick={onOpen}>
          {content}
        </button>
      )}
      <DropdownMenu>
        <DropdownMenuTrigger
          render={<Button variant="ghost" size="icon-sm" className="mt-1.5" aria-label={`Aksi untuk ${n.title}`} />}
        >
          <MoreHorizontalIcon />
        </DropdownMenuTrigger>
        <DropdownMenuContent align="end">
          <DropdownMenuItem onClick={onToggleRead}>{n.read ? "Tandai belum dibaca" : "Tandai dibaca"}</DropdownMenuItem>
          <DropdownMenuSeparator />
          <DropdownMenuItem variant="destructive" onClick={onRemove}>
            Hapus
          </DropdownMenuItem>
        </DropdownMenuContent>
      </DropdownMenu>
    </li>
  )
}

/**
 * The notifications page: the title and "Tandai semua dibaca" for the selected category, category chips with unread
 * counts, then a card with the Semua / Belum dibaca switch, the page menu, rows grouped by time and "Muat lagi".
 * Keep the category and the switch in the URL in a real product, as list filters do.
 */
export default function NotificationsPageDemo() {
  const [items, setItems] = useState(NOTIFICATIONS)
  const [visible, setVisible] = useState(FIRST_PAGE)
  const [category, setCategory] = useState<"semua" | Category>("semua")
  const [show, setShow] = useState<"semua" | "belum">("semua")
  const [confirmRemoveRead, setConfirmRemoveRead] = useState(false)
  /** After a delete, focus moves to the next row (or the previous one, or the empty text) instead of the page. */
  const [focusAfterRemove, setFocusAfterRemove] = useState<number | "empty" | null>(null)
  const emptyRef = useRef<HTMLParagraphElement>(null)
  /** A new filter starts again from the first page. */
  const pickCategory = (value: "semua" | Category) => {
    setCategory(value)
    setVisible(FIRST_PAGE)
  }
  const pickShow = (value: "semua" | "belum") => {
    setShow(value)
    setVisible(FIRST_PAGE)
  }

  const inCategory = (n: Notification) => category === "semua" || n.category === category
  const unread = (c: "semua" | Category) => items.filter((n) => !n.read && (c === "semua" || n.category === c)).length
  const update = (id: number, read: boolean) => setItems((all) => all.map((n) => (n.id === id ? { ...n, read } : n)))
  const markAllRead = () => setItems((all) => all.map((n) => (inCategory(n) ? { ...n, read: true } : n)))
  const readCount = items.filter((n) => n.read && inCategory(n)).length
  const removeRead = () => setItems((all) => all.filter((n) => !(n.read && inCategory(n))))

  // Filter first, then page: "Muat lagi" shows only while more of the filtered rows exist.
  const filtered = items.filter((n) => inCategory(n) && (show === "semua" || !n.read))
  const shown = filtered.slice(0, visible)
  const groups = (["Hari ini", "Sebelumnya"] as const)
    .map((label) => ({ label, rows: shown.filter((n) => n.group === label) }))
    .filter((g) => g.rows.length > 0)
  const empty = show === "belum" ? "Semua notifikasi sudah kamu baca." : "Belum ada notifikasi di kategori ini."

  const remove = (id: number) => {
    const at = shown.findIndex((n) => n.id === id)
    const next = shown[at + 1] ?? shown[at - 1]
    setFocusAfterRemove(next ? next.id : "empty")
    setItems((all) => all.filter((n) => n.id !== id))
  }
  useEffect(() => {
    if (focusAfterRemove === null) return
    // Wait a frame: the closing menu returns focus to its trigger first, and that trigger is gone.
    const frame = requestAnimationFrame(() => {
      const target =
        focusAfterRemove === "empty"
          ? emptyRef.current
          : document.querySelector<HTMLElement>(`[data-notification="${focusAfterRemove}"]`)
      target?.focus()
      setFocusAfterRemove(null)
    })
    return () => cancelAnimationFrame(frame)
  }, [focusAfterRemove])

  return (
    <div className="min-h-svh bg-background p-6 text-foreground">
      <div className="mx-auto grid max-w-3xl gap-6">
        <div className="flex flex-wrap items-start justify-between gap-4">
          <div>
            <h1 className="text-2xl font-semibold">Notifikasi</h1>
            <p className="mt-1 text-sm text-muted-foreground">Kabar terbaru soal akunmu.</p>
          </div>
          <Button variant="outline" disabled={unread(category) === 0} onClick={markAllRead}>
            <CheckCheckIcon />
            Tandai semua dibaca
          </Button>
        </div>

        <ToggleGroup
          variant="outline"
          spacing={2}
          aria-label="Filter kategori"
          // One line that scrolls sideways on phones; from sm the chips wrap.
          className="-mx-1 w-full min-w-0 flex-nowrap overflow-x-auto px-1 pb-1 sm:w-fit sm:flex-wrap sm:overflow-visible"
          value={[category]}
          // A category filter always has one value: clicking the active chip keeps it on.
          onValueChange={(value) => value.length > 0 && pickCategory(value[value.length - 1] as "semua" | Category)}
        >
          {(["semua", ...CATEGORIES] as const).map((c) => (
            <ToggleGroupItem
              key={c}
              value={c}
              // The count reads as words: "Pembayaran (1 belum dibaca)".
              aria-label={unread(c) > 0 ? `${c === "semua" ? "Semua" : c} (${unread(c)} belum dibaca)` : undefined}
            >
              {c === "semua" ? "Semua" : c}
              {unread(c) > 0 ? <span className="tabular-nums text-muted-foreground">{unread(c)}</span> : null}
            </ToggleGroupItem>
          ))}
        </ToggleGroup>

        <div className="rounded-xl border border-border bg-card">
          <div className="flex items-center justify-between gap-2 border-b border-border px-4 py-2">
            <ToggleGroup
              size="sm"
              aria-label="Tampilkan"
              value={[show]}
              onValueChange={(value) => value.length > 0 && pickShow(value[value.length - 1] as "semua" | "belum")}
            >
              <ToggleGroupItem value="semua">Semua</ToggleGroupItem>
              <ToggleGroupItem value="belum">Belum dibaca</ToggleGroupItem>
            </ToggleGroup>
            <DropdownMenu>
              <DropdownMenuTrigger render={<Button variant="ghost" size="icon-sm" aria-label="Opsi notifikasi" />}>
                <MoreHorizontalIcon />
              </DropdownMenuTrigger>
              <DropdownMenuContent align="end">
                <DropdownMenuItem render={<a href="#pengaturan-notifikasi" />}>Pengaturan notifikasi</DropdownMenuItem>
                <DropdownMenuSeparator />
                <DropdownMenuItem variant="destructive" disabled={readCount === 0} onClick={() => setConfirmRemoveRead(true)}>
                  Hapus yang sudah dibaca
                </DropdownMenuItem>
              </DropdownMenuContent>
            </DropdownMenu>
            <AlertDialog open={confirmRemoveRead} onOpenChange={setConfirmRemoveRead}>
              <AlertDialogContent>
                <AlertDialogHeader>
                  <AlertDialogTitle>Hapus {readCount} notifikasi yang sudah dibaca?</AlertDialogTitle>
                  <AlertDialogDescription>Notifikasi yang dihapus tidak bisa dikembalikan.</AlertDialogDescription>
                </AlertDialogHeader>
                <AlertDialogFooter>
                  <AlertDialogCancel autoFocus>Batal</AlertDialogCancel>
                  <AlertDialogAction
                    variant="destructive"
                    onClick={() => {
                      removeRead()
                      setConfirmRemoveRead(false)
                    }}
                  >
                    Hapus
                  </AlertDialogAction>
                </AlertDialogFooter>
              </AlertDialogContent>
            </AlertDialog>
          </div>

          {groups.length === 0 ? (
            <p ref={emptyRef} tabIndex={-1} className="px-4 py-12 text-center text-sm text-muted-foreground outline-none">
              {empty}
            </p>
          ) : (
            groups.map((g) => (
              <section key={g.label} aria-label={g.label} className="py-2">
                <h2 className="px-4 py-1 text-xs font-medium text-muted-foreground">{g.label}</h2>
                <ul>
                  {g.rows.map((n) => (
                    <NotificationRow
                      key={n.id}
                      notification={n}
                      onOpen={() => update(n.id, true)}
                      onToggleRead={() => update(n.id, !n.read)}
                      onRemove={() => remove(n.id)}
                    />
                  ))}
                </ul>
              </section>
            ))
          )}

          {filtered.length > visible ? (
            <div className="border-t border-border p-2 text-center">
              <Button variant="ghost" onClick={() => setVisible((v) => v + FIRST_PAGE)}>
                Muat lagi
              </Button>
            </div>
          ) : null}
        </div>
      </div>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { computed, nextTick, ref, type Component } from "vue"
import { CheckCheck, Disc, FileCheck, FileText, Info, MoreHorizontal, Wallet } from "@lucide/vue"
import {
  AlertDialog,
  AlertDialogAction,
  AlertDialogCancel,
  AlertDialogContent,
  AlertDialogDescription,
  AlertDialogFooter,
  AlertDialogHeader,
  AlertDialogTitle,
} from "@/components/ui/alert-dialog"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"

/**
 * The notifications page: the title and "Tandai semua dibaca" for the selected category, category chips with unread
 * counts, then a card with the Semua / Belum dibaca switch, the page menu, rows grouped by time and "Muat lagi".
 * Keep the category and the switch in the URL in a real product, as list filters do.
 */
type Category = "Pembayaran" | "Clearance" | "Laporan" | "Rilis" | "Umum"

interface Notification {
  id: number
  category: Category
  title: string
  body: string
  /** Relative time shown in the row. */
  time: string
  /** Full date and time, shown as the tooltip of the relative time. */
  at: string
  /** ISO date for the <time> element. */
  iso: string
  group: "Hari ini" | "Sebelumnya"
  read: boolean
  /** The page the notification is about. Without one, a click only marks it read. */
  href?: string
}

const ICONS: Record<Category, Component> = { Pembayaran: Wallet, Clearance: FileCheck, Laporan: FileText, Rilis: Disc, Umum: Info }
const CATEGORIES: Category[] = ["Pembayaran", "Clearance", "Laporan", "Rilis", "Umum"]

const NOTIFICATIONS: Notification[] = [
  { id: 1, category: "Pembayaran", title: "Royalti Oktober sudah masuk", body: "Rp1.250.000,00 masuk ke saldomu.", time: "5 menit lalu", at: "17 Nov 2026, 14.20", iso: "2026-11-17T14:20", group: "Hari ini", read: false, href: "#saldo" },
  { id: 2, category: "Clearance", title: 'Clearance "Langit Jingga" disetujui', body: "Videomu siap tayang.", time: "1 jam lalu", at: "17 Nov 2026, 13.25", iso: "2026-11-17T13:25", group: "Hari ini", read: false, href: "#clearance" },
  { id: 3, category: "Laporan", title: "Laporan royalti Oktober siap", body: "Cek pendapatan tiap platform.", time: "3 jam lalu", at: "17 Nov 2026, 11.05", iso: "2026-11-17T11:05", group: "Hari ini", read: false, href: "#laporan" },
  { id: 4, category: "Rilis", title: '"Senja di Kota" tayang di Spotify', body: "Rilismu sudah bisa diputar.", time: "Kemarin", at: "16 Nov 2026, 19.40", iso: "2026-11-16T19:40", group: "Sebelumnya", read: true, href: "#rilis" },
  { id: 5, category: "Pembayaran", title: "Tagihan langganan November", body: "Bayar sebelum 30 Nov 2026 supaya layananmu tetap jalan.", time: "Kemarin", at: "16 Nov 2026, 09.00", iso: "2026-11-16T09:00", group: "Sebelumnya", read: true, href: "#tagihan" },
  { id: 6, category: "Clearance", title: 'Clearance "Kaset Pertama" perlu diperbaiki', body: "Cek catatan dari tim kami, lalu kirim ulang.", time: "2 hari lalu", at: "15 Nov 2026, 10.15", iso: "2026-11-15T10:15", group: "Sebelumnya", read: true, href: "#clearance" },
  { id: 7, category: "Umum", title: "Kata sandimu baru saja diganti", body: "Bukan kamu? Segera hubungi kami.", time: "3 hari lalu", at: "14 Nov 2026, 08.30", iso: "2026-11-14T08:30", group: "Sebelumnya", read: true },
  { id: 8, category: "Rilis", title: '"Pulang Sore" dijadwalkan 28 Nov 2026', body: "Kami kirim ke semua platform di tanggal itu.", time: "4 hari lalu", at: "13 Nov 2026, 16.45", iso: "2026-11-13T16:45", group: "Sebelumnya", read: true, href: "#rilis" },
  { id: 9, category: "Laporan", title: "Laporan royalti September siap", body: "Cek pendapatan tiap platform.", time: "14 Okt 2026", at: "14 Okt 2026, 10.00", iso: "2026-10-14T10:00", group: "Sebelumnya", read: true, href: "#laporan" },
  { id: 10, category: "Pembayaran", title: "Royalti September sudah masuk", body: "Rp980.000,00 masuk ke saldomu.", time: "13 Okt 2026", at: "13 Okt 2026, 15.10", iso: "2026-10-13T15:10", group: "Sebelumnya", read: true, href: "#saldo" },
]

/** Rows shown before "Muat lagi". */
const FIRST_PAGE = 8

const items = ref(NOTIFICATIONS.map((n) => ({ ...n })))
const visible = ref(FIRST_PAGE)
const category = ref<"semua" | Category>("semua")
const show = ref<"semua" | "belum">("semua")
const confirmRemoveRead = ref(false)
const emptyText = ref<HTMLElement | null>(null)

const inCategory = (n: Notification) => category.value === "semua" || n.category === category.value
const unread = (c: "semua" | Category) => items.value.filter((n) => !n.read && (c === "semua" || n.category === c)).length
const update = (id: number, read: boolean) => {
  items.value = items.value.map((n) => (n.id === id ? { ...n, read } : n))
}
/** After a delete, focus moves to the next row (or the previous one, or the empty text) instead of the page. */
const remove = (id: number) => {
  const shown = filtered.value.slice(0, visible.value)
  const at = shown.findIndex((n) => n.id === id)
  const next = shown[at + 1] ?? shown[at - 1]
  items.value = items.value.filter((n) => n.id !== id)
  // Wait a frame: the closing menu returns focus to its trigger first, and that trigger is gone.
  nextTick(() =>
    requestAnimationFrame(() => {
      const target = next ? document.querySelector<HTMLElement>(`[data-notification="${next.id}"]`) : emptyText.value
      target?.focus()
    }),
  )
}
const markAllRead = () => {
  items.value = items.value.map((n) => (inCategory(n) ? { ...n, read: true } : n))
}
const readCount = computed(() => items.value.filter((n) => n.read && inCategory(n)).length)
const removeRead = () => {
  items.value = items.value.filter((n) => !(n.read && inCategory(n)))
  confirmRemoveRead.value = false
}
// A filter always has one value: clicking the active chip keeps it on.
// A new filter starts again from the first page.
function pickCategory(value: unknown) {
  if (typeof value === "string" && value) {
    category.value = value as "semua" | Category
    visible.value = FIRST_PAGE
  }
}
function pickShow(value: unknown) {
  if (typeof value === "string" && value) {
    show.value = value as "semua" | "belum"
    visible.value = FIRST_PAGE
  }
}

// Filter first, then page: "Muat lagi" shows only while more of the filtered rows exist.
const filtered = computed(() => items.value.filter((n) => inCategory(n) && (show.value === "semua" || !n.read)))
const groups = computed(() => {
  const shown = filtered.value.slice(0, visible.value)
  return (["Hari ini", "Sebelumnya"] as const)
    .map((label) => ({ label, rows: shown.filter((n) => n.group === label) }))
    .filter((g) => g.rows.length > 0)
})
const empty = computed(() => (show.value === "belum" ? "Semua notifikasi sudah kamu baca." : "Belum ada notifikasi di kategori ini."))
const rowClass = "flex min-w-0 flex-1 items-start gap-3 rounded-lg px-2 py-2 text-left outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
</script>

<template>
  <div class="min-h-svh bg-background p-6 text-foreground">
    <div class="mx-auto grid max-w-3xl gap-6">
      <div class="flex flex-wrap items-start justify-between gap-4">
        <div>
          <h1 class="text-2xl font-semibold">Notifikasi</h1>
          <p class="mt-1 text-sm text-muted-foreground">Kabar terbaru soal akunmu.</p>
        </div>
        <Button variant="outline" :disabled="unread(category) === 0" @click="markAllRead">
          <CheckCheck />Tandai semua dibaca
        </Button>
      </div>

      <ToggleGroup
        type="single"
        variant="outline"
        :spacing="2"
        aria-label="Filter kategori"
        class="-mx-1 w-full min-w-0 flex-nowrap overflow-x-auto px-1 pb-1 sm:w-fit sm:flex-wrap sm:overflow-visible"
        :model-value="category"
        @update:model-value="pickCategory"
      >
        <!-- The count reads as words: "Pembayaran (1 belum dibaca)". -->
        <ToggleGroupItem
          v-for="c in ['semua', ...CATEGORIES]"
          :key="c"
          :value="c"
          :aria-label="unread(c as 'semua' | Category) > 0 ? `${c === 'semua' ? 'Semua' : c} (${unread(c as 'semua' | Category)} belum dibaca)` : undefined"
        >
          {{ c === "semua" ? "Semua" : c }}
          <span v-if="unread(c as 'semua' | Category) > 0" class="tabular-nums text-muted-foreground">{{ unread(c as "semua" | Category) }}</span>
        </ToggleGroupItem>
      </ToggleGroup>

      <div class="rounded-xl border border-border bg-card">
        <div class="flex items-center justify-between gap-2 border-b border-border px-4 py-2">
          <ToggleGroup type="single" size="sm" aria-label="Tampilkan" :model-value="show" @update:model-value="pickShow">
            <ToggleGroupItem value="semua">Semua</ToggleGroupItem>
            <ToggleGroupItem value="belum">Belum dibaca</ToggleGroupItem>
          </ToggleGroup>
          <DropdownMenu>
            <DropdownMenuTrigger as-child>
              <Button variant="ghost" size="icon-sm" aria-label="Opsi notifikasi"><MoreHorizontal /></Button>
            </DropdownMenuTrigger>
            <DropdownMenuContent align="end">
              <DropdownMenuItem as-child><a href="#pengaturan-notifikasi">Pengaturan notifikasi</a></DropdownMenuItem>
              <DropdownMenuSeparator />
              <DropdownMenuItem variant="destructive" :disabled="readCount === 0" @select="confirmRemoveRead = true">Hapus yang sudah dibaca</DropdownMenuItem>
            </DropdownMenuContent>
          </DropdownMenu>
          <AlertDialog v-model:open="confirmRemoveRead">
            <AlertDialogContent>
              <AlertDialogHeader>
                <AlertDialogTitle>Hapus {{ readCount }} notifikasi yang sudah dibaca?</AlertDialogTitle>
                <AlertDialogDescription>Notifikasi yang dihapus tidak bisa dikembalikan.</AlertDialogDescription>
              </AlertDialogHeader>
              <AlertDialogFooter>
                <AlertDialogCancel>Batal</AlertDialogCancel>
                <AlertDialogAction variant="destructive" @click="removeRead">Hapus</AlertDialogAction>
              </AlertDialogFooter>
            </AlertDialogContent>
          </AlertDialog>
        </div>

        <p v-if="groups.length === 0" ref="emptyText" tabindex="-1" class="px-4 py-12 text-center text-sm text-muted-foreground outline-none">{{ empty }}</p>
        <section v-for="g in groups" v-else :key="g.label" :aria-label="g.label" class="py-2">
          <h2 class="px-4 py-1 text-xs font-medium text-muted-foreground">{{ g.label }}</h2>
          <ul>
            <!-- One notification: the row is a link when it has a target, otherwise a button that only marks it read;
                 the menu sits beside it, never inside. -->
            <li
              v-for="n in g.rows"
              :key="n.id"
              :class="n.read ? 'flex items-start gap-1 px-2 py-1' : 'flex items-start gap-1 bg-muted/50 px-2 py-1'"
            >
              <component
                :is="n.href ? 'a' : 'button'"
                :href="n.href"
                :data-notification="n.id"
                :type="n.href ? undefined : 'button'"
                :class="rowClass"
                @click="update(n.id, true)"
              >
                <span class="flex size-9 shrink-0 items-center justify-center rounded-full bg-muted text-muted-foreground">
                  <component :is="ICONS[n.category]" class="size-4" />
                </span>
                <span class="min-w-0 flex-1">
                  <span :class="n.read ? 'block text-sm' : 'block text-sm font-semibold'">{{ n.title }}</span>
                  <span class="mt-0.5 line-clamp-2 block text-sm text-muted-foreground">{{ n.body }}</span>
                  <span class="mt-1 block text-xs text-muted-foreground">
                    <time :datetime="n.iso" :title="n.at">{{ n.time }}</time><span class="sr-only">, {{ n.at }}</span> · {{ n.category }}
                  </span>
                </span>
                <template v-if="!n.read">
                  <span aria-hidden="true" class="mt-1.5 size-2 shrink-0 rounded-full bg-primary" />
                  <span class="sr-only">Belum dibaca</span>
                </template>
              </component>
              <DropdownMenu>
                <DropdownMenuTrigger as-child>
                  <Button variant="ghost" size="icon-sm" class="mt-1.5" :aria-label="`Aksi untuk ${n.title}`"><MoreHorizontal /></Button>
                </DropdownMenuTrigger>
                <DropdownMenuContent align="end">
                  <DropdownMenuItem @select="update(n.id, !n.read)">{{ n.read ? "Tandai belum dibaca" : "Tandai dibaca" }}</DropdownMenuItem>
                  <DropdownMenuSeparator />
                  <DropdownMenuItem variant="destructive" @select="remove(n.id)">Hapus</DropdownMenuItem>
                </DropdownMenuContent>
              </DropdownMenu>
            </li>
          </ul>
        </section>

        <div v-if="filtered.length > visible" class="border-t border-border p-2 text-center">
          <Button variant="ghost" @click="visible += FIRST_PAGE">Muat lagi</Button>
        </div>
      </div>
    </div>
  </div>
</template>
```

**Flutter**
```dart
// The notifications page: the title and "Tandai semua dibaca" for the selected category, category chips with unread
// counts, then a card with the Semua / Belum dibaca switch, rows grouped by time and "Muat lagi".
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _categories = ['Pembayaran', 'Clearance', 'Laporan', 'Rilis', 'Umum'];
const _icons = {
  'Pembayaran': LucideIcons.wallet,
  'Clearance': LucideIcons.fileCheck,
  'Laporan': LucideIcons.fileText,
  'Rilis': LucideIcons.disc,
  'Umum': LucideIcons.info,
};

/// One notification. `time` is relative and `at` the full date and time for its tooltip. `href` is the page it is
/// about; without one, a tap only marks it read.
class _Notification {
  _Notification(
    this.id,
    this.category,
    this.title,
    this.body,
    this.time,
    this.today, {
    required this.at,
    this.read = true,
    this.href,
  });

  final int id;
  final String category, title, body, time, at;
  final bool today;
  final String? href;
  bool read;
}

List<_Notification> _notifications() => [
  _Notification(
    1,
    at: '17 Nov 2026, 14.20',
    'Pembayaran',
    'Royalti Oktober sudah masuk',
    'Rp1.250.000,00 masuk ke saldomu.',
    '5 menit lalu',
    true,
    read: false,
    href: '/saldo',
  ),
  _Notification(
    2,
    at: '17 Nov 2026, 13.25',
    'Clearance',
    'Clearance "Langit Jingga" disetujui',
    'Videomu siap tayang.',
    '1 jam lalu',
    true,
    read: false,
    href: '/clearance',
  ),
  _Notification(
    3,
    at: '17 Nov 2026, 11.05',
    'Laporan',
    'Laporan royalti Oktober siap',
    'Cek pendapatan tiap platform.',
    '3 jam lalu',
    true,
    read: false,
    href: '/laporan',
  ),
  _Notification(
    4,
    at: '16 Nov 2026, 19.40',
    'Rilis',
    '"Senja di Kota" tayang di Spotify',
    'Rilismu sudah bisa diputar.',
    'Kemarin',
    false,
    href: '/rilis',
  ),
  _Notification(
    5,
    at: '16 Nov 2026, 09.00',
    'Pembayaran',
    'Tagihan langganan November',
    'Bayar sebelum 30 Nov 2026 supaya layananmu tetap jalan.',
    'Kemarin',
    false,
    href: '/tagihan',
  ),
  _Notification(
    6,
    at: '15 Nov 2026, 10.15',
    'Clearance',
    'Clearance "Kaset Pertama" perlu diperbaiki',
    'Cek catatan dari tim kami, lalu kirim ulang.',
    '2 hari lalu',
    false,
    href: '/clearance',
  ),
  _Notification(
    7,
    at: '14 Nov 2026, 08.30',
    'Umum',
    'Kata sandimu baru saja diganti',
    'Bukan kamu? Segera hubungi kami.',
    '3 hari lalu',
    false,
  ),
  _Notification(
    8,
    at: '13 Nov 2026, 16.45',
    'Rilis',
    '"Pulang Sore" dijadwalkan 28 Nov 2026',
    'Kami kirim ke semua platform di tanggal itu.',
    '4 hari lalu',
    false,
    href: '/rilis',
  ),
  _Notification(
    9,
    at: '14 Okt 2026, 10.00',
    'Laporan',
    'Laporan royalti September siap',
    'Cek pendapatan tiap platform.',
    '14 Okt 2026',
    false,
    href: '/laporan',
  ),
  _Notification(
    10,
    at: '13 Okt 2026, 15.10',
    'Pembayaran',
    'Royalti September sudah masuk',
    'Rp980.000,00 masuk ke saldomu.',
    '13 Okt 2026',
    false,
    href: '/saldo',
  ),
];

class NotificationsPageDemo extends StatefulWidget {
  const NotificationsPageDemo({super.key});

  @override
  State<NotificationsPageDemo> createState() => _NotificationsPageDemoState();
}

class _NotificationsPageDemoState extends State<NotificationsPageDemo> {
  static const _pageSize = 8;
  final _items = _notifications();
  final _pageMenu = ShadContextMenuController();
  var _visible = _pageSize;
  var _category = 'semua';
  var _unreadOnly = false;

  bool _inCategory(_Notification n) =>
      _category == 'semua' || n.category == _category;
  int _unread(String category) => _items
      .where((n) => !n.read && (category == 'semua' || n.category == category))
      .length;

  @override
  void dispose() {
    _pageMenu.dispose();
    super.dispose();
  }

  /// Deleting is final, so ask first. Cancel takes the focus; the destructive action sits last.
  Future<void> _confirmRemoveRead() async {
    _pageMenu.hide();
    final count = _items.where((n) => n.read && _inCategory(n)).length;
    final confirmed = await showShadDialog<bool>(
      context: context,
      builder: (context) => ShadDialog.alert(
        title: Text('Hapus $count notifikasi yang sudah dibaca?'),
        description: const Text(
          'Notifikasi yang dihapus tidak bisa dikembalikan.',
        ),
        actions: [
          ShadButton.outline(
            autofocus: true,
            child: const Text('Batal'),
            onPressed: () => Navigator.of(context).pop(false),
          ),
          ShadButton.destructive(
            child: const Text('Hapus'),
            onPressed: () => Navigator.of(context).pop(true),
          ),
        ],
      ),
    );
    if (confirmed == true) {
      setState(() => _items.removeWhere((n) => n.read && _inCategory(n)));
    }
  }

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    // Filter first, then page: "Muat lagi" shows only while more of the filtered rows exist.
    final filtered = _items
        .where((n) => _inCategory(n) && (!_unreadOnly || !n.read))
        .toList();
    final shown = filtered.take(_visible).toList();
    final groups = [
      ('Hari ini', shown.where((n) => n.today).toList()),
      ('Sebelumnya', shown.where((n) => !n.today).toList()),
    ].where((g) => g.$2.isNotEmpty);
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 720),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          Row(
            children: [
              Expanded(
                child: Column(
                  crossAxisAlignment: CrossAxisAlignment.start,
                  children: [
                    Text('Notifikasi', style: theme.textTheme.h3),
                    Text(
                      'Kabar terbaru soal akunmu.',
                      style: theme.textTheme.muted,
                    ),
                  ],
                ),
              ),
              ShadButton.outline(
                leading: const Icon(LucideIcons.checkCheck, size: 16),
                enabled: _unread(_category) > 0,
                onPressed: () => setState(() {
                  for (final n in _items.where(_inCategory)) {
                    n.read = true;
                  }
                }),
                child: const Text('Tandai semua dibaca'),
              ),
            ],
          ),
          const SizedBox(height: 16),
          // A category filter always has one value: allowDeselection keeps the active chip on. On phones the chips
          // scroll sideways.
          Semantics(
            label: 'Filter kategori',
            child: SingleChildScrollView(
              scrollDirection: Axis.horizontal,
              child: ShadToggleGroup<String>(
                initialValue: 'semua',
                allowDeselection: false,
                variant: ShadToggleVariant.outline,
                spacing: 8,
                // A new filter starts again from the first page.
                onChanged: (value) => setState(() {
                  _category = value ?? 'semua';
                  _visible = _pageSize;
                }),
                items: [
                  for (final c in ['semua', ..._categories])
                    ShadToggleGroupItem(
                      value: c,
                      // The count reads as words: "Pembayaran (1 belum dibaca)".
                      child: Semantics(
                        label: _unread(c) > 0
                            ? '${c == 'semua' ? 'Semua' : c} (${_unread(c)} belum dibaca)'
                            : null,
                        excludeSemantics: _unread(c) > 0,
                        child: Row(
                          mainAxisSize: MainAxisSize.min,
                          spacing: 6,
                          children: [
                            Text(c == 'semua' ? 'Semua' : c),
                            if (_unread(c) > 0)
                              Text(
                                '${_unread(c)}',
                                style: theme.textTheme.muted,
                              ),
                          ],
                        ),
                      ),
                    ),
                ],
              ),
            ),
          ),
          const SizedBox(height: 16),
          ShadCard(
            padding: EdgeInsets.zero,
            child: Column(
              crossAxisAlignment: CrossAxisAlignment.stretch,
              children: [
                Padding(
                  padding: const EdgeInsets.fromLTRB(16, 8, 8, 8),
                  child: Row(
                    children: [
                      Expanded(
                        child: Semantics(
                          label: 'Tampilkan',
                          child: Align(
                            alignment: Alignment.centerLeft,
                            child: ShadToggleGroup<bool>(
                              initialValue: false,
                              allowDeselection: false,
                              size: ShadButtonSize.sm,
                              onChanged: (value) => setState(() {
                                _unreadOnly = value ?? false;
                                _visible = _pageSize;
                              }),
                              items: const [
                                ShadToggleGroupItem(
                                  value: false,
                                  child: Text('Semua'),
                                ),
                                ShadToggleGroupItem(
                                  value: true,
                                  child: Text('Belum dibaca'),
                                ),
                              ],
                            ),
                          ),
                        ),
                      ),
                      ShadContextMenu(
                        controller: _pageMenu,
                        items: [
                          // Opens the notification settings; call your router here.
                          const ShadContextMenuItem(
                            child: Text('Pengaturan notifikasi'),
                          ),
                          const ShadSeparator.horizontal(
                            margin: EdgeInsets.symmetric(vertical: 4),
                          ),
                          ShadContextMenuItem(
                            enabled: _items.any(
                              (n) => n.read && _inCategory(n),
                            ),
                            onPressed: _confirmRemoveRead,
                            child: Text(
                              'Hapus yang sudah dibaca',
                              style: TextStyle(
                                color: context.sosialoka.destructive,
                              ),
                            ),
                          ),
                        ],
                        child: Semantics(
                          label: 'Opsi notifikasi',
                          child: ShadIconButton.ghost(
                            icon: const Icon(LucideIcons.ellipsis),
                            onPressed: _pageMenu.toggle,
                          ),
                        ),
                      ),
                    ],
                  ),
                ),
                const ShadSeparator.horizontal(margin: EdgeInsets.zero),
                if (groups.isEmpty)
                  Padding(
                    padding: const EdgeInsets.symmetric(vertical: 48),
                    child: Text(
                      _unreadOnly
                          ? 'Semua notifikasi sudah kamu baca.'
                          : 'Belum ada notifikasi di kategori ini.',
                      textAlign: TextAlign.center,
                      style: theme.textTheme.muted,
                    ),
                  ),
                for (final (label, rows) in groups) ...[
                  Padding(
                    padding: const EdgeInsets.fromLTRB(16, 8, 16, 2),
                    child: Text(
                      label,
                      style: theme.textTheme.muted.copyWith(fontSize: 12),
                    ),
                  ),
                  for (final n in rows)
                    _NotificationRow(
                      notification: n,
                      onOpen: () => setState(() => n.read = true),
                      onToggleRead: () => setState(() => n.read = !n.read),
                      onRemove: () => setState(() => _items.remove(n)),
                    ),
                ],
                if (filtered.length > _visible)
                  Padding(
                    padding: const EdgeInsets.all(8),
                    child: Center(
                      child: ShadButton.ghost(
                        onPressed: () => setState(() => _visible += _pageSize),
                        child: const Text('Muat lagi'),
                      ),
                    ),
                  ),
              ],
            ),
          ),
        ],
      ),
    );
  }
}

/// One notification: category icon, title (bold while unread), body clamped to two lines, time and category, an
/// unread dot, and the row menu beside it.
class _NotificationRow extends StatefulWidget {
  const _NotificationRow({
    required this.notification,
    required this.onOpen,
    required this.onToggleRead,
    required this.onRemove,
  });

  final _Notification notification;
  final VoidCallback onOpen, onToggleRead, onRemove;

  @override
  State<_NotificationRow> createState() => _NotificationRowState();
}

class _NotificationRowState extends State<_NotificationRow> {
  final menu = ShadContextMenuController();
  var _focused = false;

  @override
  void dispose() {
    menu.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final n = widget.notification;
    return ColoredBox(
      color: n.read
          ? const Color(0x00000000)
          : theme.colorScheme.muted.withValues(alpha: 0.5),
      child: Padding(
        padding: const EdgeInsets.symmetric(horizontal: 12, vertical: 6),
        child: Row(
          crossAxisAlignment: CrossAxisAlignment.start,
          spacing: 12,
          children: [
            Expanded(
              child: Semantics(
                // A row with a target opens it (call your router here); every row is marked read. Enter and Space
                // open a focused row, as a tap does.
                link: n.href != null,
                button: n.href == null,
                child: FocusableActionDetector(
                  mouseCursor: SystemMouseCursors.click,
                  onShowFocusHighlight: (value) =>
                      setState(() => _focused = value),
                  actions: {
                    ActivateIntent: CallbackAction<ActivateIntent>(
                      onInvoke: (_) => widget.onOpen(),
                    ),
                  },
                  child: GestureDetector(
                    behavior: HitTestBehavior.opaque,
                    onTap: widget.onOpen,
                    child: DecoratedBox(
                      decoration: BoxDecoration(
                        borderRadius: BorderRadius.circular(8),
                        border: Border.all(
                          color: _focused
                              ? theme.colorScheme.ring
                              : const Color(0x00000000),
                          width: 2,
                        ),
                      ),
                      child: Row(
                        crossAxisAlignment: CrossAxisAlignment.start,
                        spacing: 12,
                        children: [
                          Container(
                            width: 36,
                            height: 36,
                            decoration: BoxDecoration(
                              color: theme.colorScheme.muted,
                              shape: BoxShape.circle,
                            ),
                            child: Icon(
                              _icons[n.category],
                              size: 16,
                              color: theme.colorScheme.mutedForeground,
                            ),
                          ),
                          Expanded(
                            child: Column(
                              crossAxisAlignment: CrossAxisAlignment.start,
                              spacing: 2,
                              children: [
                                Text(
                                  n.title,
                                  style: theme.textTheme.small.copyWith(
                                    fontWeight: n.read
                                        ? FontWeight.w400
                                        : FontWeight.w600,
                                  ),
                                ),
                                Text(
                                  n.body,
                                  maxLines: 2,
                                  overflow: TextOverflow.ellipsis,
                                  style: theme.textTheme.muted,
                                ),
                                Row(
                                  children: [
                                    ShadTooltip(
                                      builder: (context) => Text(n.at),
                                      child: Text(
                                        n.time,
                                        style: theme.textTheme.muted.copyWith(
                                          fontSize: 12,
                                        ),
                                      ),
                                    ),
                                    Flexible(
                                      child: Text(
                                        ' · ${n.category}',
                                        maxLines: 1,
                                        overflow: TextOverflow.ellipsis,
                                        style: theme.textTheme.muted.copyWith(
                                          fontSize: 12,
                                        ),
                                      ),
                                    ),
                                  ],
                                ),
                              ],
                            ),
                          ),
                          if (!n.read)
                            Semantics(
                              label: 'Belum dibaca',
                              child: Container(
                                margin: const EdgeInsets.only(top: 6),
                                width: 8,
                                height: 8,
                                decoration: BoxDecoration(
                                  color: theme.colorScheme.primary,
                                  shape: BoxShape.circle,
                                ),
                              ),
                            ),
                        ],
                      ),
                    ),
                  ),
                ),
              ),
            ),
            ShadContextMenu(
              controller: menu,
              items: [
                ShadContextMenuItem(
                  onPressed: widget.onToggleRead,
                  child: Text(n.read ? 'Tandai belum dibaca' : 'Tandai dibaca'),
                ),
                const ShadSeparator.horizontal(
                  margin: EdgeInsets.symmetric(vertical: 4),
                ),
                ShadContextMenuItem(
                  onPressed: widget.onRemove,
                  child: Text(
                    'Hapus',
                    style: TextStyle(color: context.sosialoka.destructive),
                  ),
                ),
              ],
              child: Semantics(
                label: 'Aksi untuk ${n.title}',
                child: ShadIconButton.ghost(
                  icon: const Icon(LucideIcons.ellipsis),
                  onPressed: menu.toggle,
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }
}
```

## Panel

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/notifications/_

**React**
```tsx
import { useState } from "react"
import {
  BellIcon,
  DiscIcon,
  FileCheckIcon,
  FileTextIcon,
  InfoIcon,
  MoreHorizontalIcon,
  WalletIcon,
  type LucideIcon,
} from "lucide-react"
import { DashboardIconButton } from "@/components/blocks/dashboard-shell"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Popover, PopoverContent, PopoverTitle, PopoverTrigger } from "@/components/ui/popover"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"

type Category = "Pembayaran" | "Clearance" | "Laporan" | "Rilis" | "Umum"

interface Notification {
  id: number
  category: Category
  title: string
  body: string
  /** Relative time shown in the row. */
  time: string
  /** Full date and time, shown as the tooltip of the relative time. */
  at: string
  /** ISO date for the <time> element. */
  iso: string
  group: "Hari ini" | "Sebelumnya"
  read: boolean
  /** The page the notification is about. Without one, a click only marks it read. */
  href?: string
}

const ICONS: Record<Category, LucideIcon> = {
  Pembayaran: WalletIcon,
  Clearance: FileCheckIcon,
  Laporan: FileTextIcon,
  Rilis: DiscIcon,
  Umum: InfoIcon,
}

/** The newest notifications; the panel shows at most 8, the page shows the rest. */
const NOTIFICATIONS: Notification[] = [
  { id: 1, category: "Pembayaran", title: "Royalti Oktober sudah masuk", body: "Rp1.250.000,00 masuk ke saldomu.", time: "5 menit lalu", at: "17 Nov 2026, 14.20", iso: "2026-11-17T14:20", group: "Hari ini", read: false, href: "#saldo" },
  { id: 2, category: "Clearance", title: 'Clearance "Langit Jingga" disetujui', body: "Videomu siap tayang.", time: "1 jam lalu", at: "17 Nov 2026, 13.25", iso: "2026-11-17T13:25", group: "Hari ini", read: false, href: "#clearance" },
  { id: 3, category: "Laporan", title: "Laporan royalti Oktober siap", body: "Cek pendapatan tiap platform.", time: "3 jam lalu", at: "17 Nov 2026, 11.05", iso: "2026-11-17T11:05", group: "Hari ini", read: false, href: "#laporan" },
  { id: 4, category: "Rilis", title: '"Senja di Kota" tayang di Spotify', body: "Rilismu sudah bisa diputar.", time: "Kemarin", at: "16 Nov 2026, 19.40", iso: "2026-11-16T19:40", group: "Sebelumnya", read: true, href: "#rilis" },
  { id: 5, category: "Pembayaran", title: "Tagihan langganan November", body: "Bayar sebelum 30 Nov 2026 supaya layananmu tetap jalan.", time: "Kemarin", at: "16 Nov 2026, 09.00", iso: "2026-11-16T09:00", group: "Sebelumnya", read: true, href: "#tagihan" },
  { id: 6, category: "Clearance", title: 'Clearance "Kaset Pertama" perlu diperbaiki', body: "Cek catatan dari tim kami, lalu kirim ulang.", time: "2 hari lalu", at: "15 Nov 2026, 10.15", iso: "2026-11-15T10:15", group: "Sebelumnya", read: true, href: "#clearance" },
  { id: 7, category: "Umum", title: "Kata sandimu baru saja diganti", body: "Bukan kamu? Segera hubungi kami.", time: "3 hari lalu", at: "14 Nov 2026, 08.30", iso: "2026-11-14T08:30", group: "Sebelumnya", read: true },
  { id: 8, category: "Rilis", title: '"Pulang Sore" dijadwalkan 28 Nov 2026', body: "Kami kirim ke semua platform di tanggal itu.", time: "4 hari lalu", at: "13 Nov 2026, 16.45", iso: "2026-11-13T16:45", group: "Sebelumnya", read: true, href: "#rilis" },
]

/** The most rows the panel shows; "Lihat semua notifikasi" opens the page for the rest. */
const PANEL_ROWS = 8

/**
 * One notification: category icon, title (bold while unread), body, time and category, an unread dot, and a menu
 * beside the row. The row is a link when it has a target, otherwise a button that only marks it read.
 */
function NotificationRow({
  notification: n,
  onOpen,
  onToggleRead,
  onRemove,
}: {
  notification: Notification
  onOpen: () => void
  onToggleRead: () => void
  onRemove: () => void
}) {
  const Icon = ICONS[n.category]
  const content = (
    <>
      <span className="flex size-8 shrink-0 items-center justify-center rounded-full bg-muted text-muted-foreground">
        <Icon className="size-4" />
      </span>
      <span className="min-w-0 flex-1">
        <span className={n.read ? "block text-sm" : "block text-sm font-semibold"}>{n.title}</span>
        <span className="mt-0.5 line-clamp-2 block text-xs text-muted-foreground">{n.body}</span>
        <span className="mt-1 block text-xs text-muted-foreground">
          <time dateTime={n.iso} title={n.at}>
            {n.time}
          </time>
          <span className="sr-only">, {n.at}</span>
          {" · "}
          {n.category}
        </span>
      </span>
      {n.read ? null : (
        <>
          <span aria-hidden="true" className="mt-1.5 size-2 shrink-0 rounded-full bg-primary" />
          <span className="sr-only">Belum dibaca</span>
        </>
      )}
    </>
  )
  const rowClass = "flex min-w-0 flex-1 items-start gap-3 rounded-lg px-2 py-2 text-left outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
  return (
    <li className={n.read ? "flex items-start gap-1 px-2 py-0.5" : "flex items-start gap-1 bg-muted/50 px-2 py-0.5"}>
      {n.href ? (
        <a href={n.href} className={rowClass} onClick={onOpen}>
          {content}
        </a>
      ) : (
        <button type="button" className={rowClass} onClick={onOpen}>
          {content}
        </button>
      )}
      <DropdownMenu>
        <DropdownMenuTrigger
          render={<Button variant="ghost" size="icon-sm" className="mt-1.5" aria-label={`Aksi untuk ${n.title}`} />}
        >
          <MoreHorizontalIcon />
        </DropdownMenuTrigger>
        <DropdownMenuContent align="end">
          <DropdownMenuItem onClick={onToggleRead}>{n.read ? "Tandai belum dibaca" : "Tandai dibaca"}</DropdownMenuItem>
          <DropdownMenuSeparator />
          <DropdownMenuItem variant="destructive" onClick={onRemove}>
            Hapus
          </DropdownMenuItem>
        </DropdownMenuContent>
      </DropdownMenu>
    </li>
  )
}

/**
 * The bell panel: the Dashboard header's bell with the unread count opens a 360px popover with "Tandai semua
 * dibaca", the Semua / Belum dibaca switch, at most 8 rows grouped by time, and a link to the notifications page.
 * On phones, let the bell open the page instead.
 */
export default function NotificationPanelDemo() {
  const [items, setItems] = useState(NOTIFICATIONS)
  const [show, setShow] = useState<"semua" | "belum">("semua")

  const unread = items.filter((n) => !n.read).length
  const update = (id: number, read: boolean) => setItems((all) => all.map((n) => (n.id === id ? { ...n, read } : n)))

  // Filter first, then cap at 8 rows.
  const shown = items.filter((n) => show === "semua" || !n.read).slice(0, PANEL_ROWS)
  const groups = (["Hari ini", "Sebelumnya"] as const)
    .map((label) => ({ label, rows: shown.filter((n) => n.group === label) }))
    .filter((g) => g.rows.length > 0)

  return (
    <div className="flex justify-end p-4">
      <Popover>
        <PopoverTrigger
          render={
            <DashboardIconButton label="Notifikasi" badge={unread}>
              <BellIcon />
            </DashboardIconButton>
          }
        />
        <PopoverContent align="end" className="w-[360px] max-w-[calc(100vw-2rem)] gap-0 p-0">
          <div className="flex items-center justify-between gap-2 border-b border-border px-4 py-3">
            <PopoverTitle className="text-sm font-semibold">Notifikasi</PopoverTitle>
            <Button
              variant="link"
              size="xs"
              disabled={unread === 0}
              onClick={() => setItems((all) => all.map((n) => ({ ...n, read: true })))}
            >
              Tandai semua dibaca
            </Button>
          </div>
          <div className="border-b border-border px-4 py-2">
            <ToggleGroup
              size="sm"
              aria-label="Tampilkan"
              value={[show]}
              onValueChange={(value) => value.length > 0 && setShow(value[value.length - 1] as "semua" | "belum")}
            >
              <ToggleGroupItem value="semua">Semua</ToggleGroupItem>
              <ToggleGroupItem value="belum" aria-label={unread > 0 ? `Belum dibaca (${unread})` : undefined}>
                Belum dibaca
                {unread > 0 ? <span className="tabular-nums text-muted-foreground">{unread}</span> : null}
              </ToggleGroupItem>
            </ToggleGroup>
          </div>
          <div className="max-h-[420px] overflow-y-auto">
            {groups.length === 0 ? (
              <p className="px-4 py-10 text-center text-sm text-muted-foreground">Semua notifikasi sudah kamu baca.</p>
            ) : (
              groups.map((g) => (
                <section key={g.label} aria-label={g.label} className="py-1.5">
                  <h3 className="px-4 py-1 text-xs font-medium text-muted-foreground">{g.label}</h3>
                  <ul>
                    {g.rows.map((n) => (
                      <NotificationRow
                        key={n.id}
                        notification={n}
                        onOpen={() => update(n.id, true)}
                        onToggleRead={() => update(n.id, !n.read)}
                        onRemove={() => setItems((all) => all.filter((x) => x.id !== n.id))}
                      />
                    ))}
                  </ul>
                </section>
              ))
            )}
          </div>
          <a
            href="#notifikasi"
            className="block border-t border-border px-4 py-3 text-center text-sm font-medium text-primary-text hover:underline"
          >
            Lihat semua notifikasi
          </a>
        </PopoverContent>
      </Popover>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { computed, ref, type Component } from "vue"
import { Bell, Disc, FileCheck, FileText, Info, MoreHorizontal, Wallet } from "@lucide/vue"
import { DashboardIconButton } from "@/components/blocks/dashboard-shell"
import { Button } from "@/components/ui/button"
import {
  DropdownMenu,
  DropdownMenuContent,
  DropdownMenuItem,
  DropdownMenuSeparator,
  DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu"
import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"
import { TooltipProvider } from "@/components/ui/tooltip"

/**
 * The bell panel: the Dashboard header's bell with the unread count opens a 360px popover with "Tandai semua
 * dibaca", the Semua / Belum dibaca switch, at most 8 rows grouped by time, and a link to the notifications page.
 * On phones, let the bell open the page instead.
 */
type Category = "Pembayaran" | "Clearance" | "Laporan" | "Rilis" | "Umum"

interface Notification {
  id: number
  category: Category
  title: string
  body: string
  /** Relative time shown in the row. */
  time: string
  /** Full date and time, shown as the tooltip of the relative time. */
  at: string
  /** ISO date for the <time> element. */
  iso: string
  group: "Hari ini" | "Sebelumnya"
  read: boolean
  /** The page the notification is about. Without one, a click only marks it read. */
  href?: string
}

const ICONS: Record<Category, Component> = { Pembayaran: Wallet, Clearance: FileCheck, Laporan: FileText, Rilis: Disc, Umum: Info }

/** The newest notifications; the panel shows at most 8, the page shows the rest. */
const NOTIFICATIONS: Notification[] = [
  { id: 1, category: "Pembayaran", title: "Royalti Oktober sudah masuk", body: "Rp1.250.000,00 masuk ke saldomu.", time: "5 menit lalu", at: "17 Nov 2026, 14.20", iso: "2026-11-17T14:20", group: "Hari ini", read: false, href: "#saldo" },
  { id: 2, category: "Clearance", title: 'Clearance "Langit Jingga" disetujui', body: "Videomu siap tayang.", time: "1 jam lalu", at: "17 Nov 2026, 13.25", iso: "2026-11-17T13:25", group: "Hari ini", read: false, href: "#clearance" },
  { id: 3, category: "Laporan", title: "Laporan royalti Oktober siap", body: "Cek pendapatan tiap platform.", time: "3 jam lalu", at: "17 Nov 2026, 11.05", iso: "2026-11-17T11:05", group: "Hari ini", read: false, href: "#laporan" },
  { id: 4, category: "Rilis", title: '"Senja di Kota" tayang di Spotify', body: "Rilismu sudah bisa diputar.", time: "Kemarin", at: "16 Nov 2026, 19.40", iso: "2026-11-16T19:40", group: "Sebelumnya", read: true, href: "#rilis" },
  { id: 5, category: "Pembayaran", title: "Tagihan langganan November", body: "Bayar sebelum 30 Nov 2026 supaya layananmu tetap jalan.", time: "Kemarin", at: "16 Nov 2026, 09.00", iso: "2026-11-16T09:00", group: "Sebelumnya", read: true, href: "#tagihan" },
  { id: 6, category: "Clearance", title: 'Clearance "Kaset Pertama" perlu diperbaiki', body: "Cek catatan dari tim kami, lalu kirim ulang.", time: "2 hari lalu", at: "15 Nov 2026, 10.15", iso: "2026-11-15T10:15", group: "Sebelumnya", read: true, href: "#clearance" },
  { id: 7, category: "Umum", title: "Kata sandimu baru saja diganti", body: "Bukan kamu? Segera hubungi kami.", time: "3 hari lalu", at: "14 Nov 2026, 08.30", iso: "2026-11-14T08:30", group: "Sebelumnya", read: true },
  { id: 8, category: "Rilis", title: '"Pulang Sore" dijadwalkan 28 Nov 2026', body: "Kami kirim ke semua platform di tanggal itu.", time: "4 hari lalu", at: "13 Nov 2026, 16.45", iso: "2026-11-13T16:45", group: "Sebelumnya", read: true, href: "#rilis" },
]

/** The most rows the panel shows; "Lihat semua notifikasi" opens the page for the rest. */
const PANEL_ROWS = 8

const items = ref(NOTIFICATIONS.map((n) => ({ ...n })))
const show = ref<"semua" | "belum">("semua")

const unread = computed(() => items.value.filter((n) => !n.read).length)
const update = (id: number, read: boolean) => {
  items.value = items.value.map((n) => (n.id === id ? { ...n, read } : n))
}
const remove = (id: number) => {
  items.value = items.value.filter((n) => n.id !== id)
}
const markAllRead = () => {
  items.value = items.value.map((n) => ({ ...n, read: true }))
}
function pickShow(value: unknown) {
  if (typeof value === "string" && value) show.value = value as "semua" | "belum"
}

const groups = computed(() => {
  // Filter first, then cap at 8 rows.
  const shown = items.value.filter((n) => show.value === "semua" || !n.read).slice(0, PANEL_ROWS)
  return (["Hari ini", "Sebelumnya"] as const)
    .map((label) => ({ label, rows: shown.filter((n) => n.group === label) }))
    .filter((g) => g.rows.length > 0)
})
const rowClass = "flex min-w-0 flex-1 items-start gap-3 rounded-lg px-2 py-2 text-left outline-none focus-visible:ring-[3px] focus-visible:ring-ring/50"
</script>

<template>
  <!-- The Dashboard shell already provides tooltips; this demo shows the bell on its own. -->
  <TooltipProvider>
    <div class="flex justify-end p-4">
      <Popover>
        <PopoverTrigger as-child>
          <DashboardIconButton label="Notifikasi" :badge="unread"><Bell /></DashboardIconButton>
        </PopoverTrigger>
        <PopoverContent align="end" class="w-[360px] max-w-[calc(100vw-2rem)] p-0">
          <div class="flex items-center justify-between gap-2 border-b border-border px-4 py-3">
            <h2 class="text-sm font-semibold">Notifikasi</h2>
            <Button variant="link" size="xs" :disabled="unread === 0" @click="markAllRead">Tandai semua dibaca</Button>
          </div>
          <div class="border-b border-border px-4 py-2">
            <ToggleGroup type="single" size="sm" aria-label="Tampilkan" :model-value="show" @update:model-value="pickShow">
              <ToggleGroupItem value="semua">Semua</ToggleGroupItem>
              <ToggleGroupItem value="belum" :aria-label="unread > 0 ? `Belum dibaca (${unread})` : undefined">
                Belum dibaca
                <span v-if="unread > 0" class="tabular-nums text-muted-foreground">{{ unread }}</span>
              </ToggleGroupItem>
            </ToggleGroup>
          </div>
          <div class="max-h-[420px] overflow-y-auto">
            <p v-if="groups.length === 0" class="px-4 py-10 text-center text-sm text-muted-foreground">Semua notifikasi sudah kamu baca.</p>
            <section v-for="g in groups" v-else :key="g.label" :aria-label="g.label" class="py-1.5">
              <h3 class="px-4 py-1 text-xs font-medium text-muted-foreground">{{ g.label }}</h3>
              <ul>
                <!-- One notification: the row is a link when it has a target, otherwise a button that only marks it read;
                     the menu sits beside it, never inside. -->
                <li
                  v-for="n in g.rows"
                  :key="n.id"
                  :class="n.read ? 'flex items-start gap-1 px-2 py-0.5' : 'flex items-start gap-1 bg-muted/50 px-2 py-0.5'"
                >
                  <component
                    :is="n.href ? 'a' : 'button'"
                    :href="n.href"
                    :type="n.href ? undefined : 'button'"
                    :class="rowClass"
                    @click="update(n.id, true)"
                  >
                    <span class="flex size-8 shrink-0 items-center justify-center rounded-full bg-muted text-muted-foreground">
                      <component :is="ICONS[n.category]" class="size-4" />
                    </span>
                    <span class="min-w-0 flex-1">
                      <span :class="n.read ? 'block text-sm' : 'block text-sm font-semibold'">{{ n.title }}</span>
                      <span class="mt-0.5 line-clamp-2 block text-xs text-muted-foreground">{{ n.body }}</span>
                      <span class="mt-1 block text-xs text-muted-foreground">
                        <time :datetime="n.iso" :title="n.at">{{ n.time }}</time><span class="sr-only">, {{ n.at }}</span> · {{ n.category }}
                      </span>
                    </span>
                    <template v-if="!n.read">
                    <span aria-hidden="true" class="mt-1.5 size-2 shrink-0 rounded-full bg-primary" />
                    <span class="sr-only">Belum dibaca</span>
                  </template>
                  </component>
                  <DropdownMenu>
                    <DropdownMenuTrigger as-child>
                      <Button variant="ghost" size="icon-sm" class="mt-1.5" :aria-label="`Aksi untuk ${n.title}`"><MoreHorizontal /></Button>
                    </DropdownMenuTrigger>
                    <DropdownMenuContent align="end">
                      <DropdownMenuItem @select="update(n.id, !n.read)">{{ n.read ? "Tandai belum dibaca" : "Tandai dibaca" }}</DropdownMenuItem>
                      <DropdownMenuSeparator />
                      <DropdownMenuItem variant="destructive" @select="remove(n.id)">Hapus</DropdownMenuItem>
                    </DropdownMenuContent>
                  </DropdownMenu>
                </li>
              </ul>
            </section>
          </div>
          <a
            href="#notifikasi"
            class="block border-t border-border px-4 py-3 text-center text-sm font-medium text-primary-text hover:underline"
          >Lihat semua notifikasi</a>
        </PopoverContent>
      </Popover>
    </div>
  </TooltipProvider>
</template>
```

**Flutter**
```dart
// The bell panel for tablets and desktop: the bell with the unread count opens a 360-wide popover with
// "Tandai semua dibaca", the Semua / Belum dibaca switch, at most 8 rows grouped by time, and a link to the page.
// On phones, let the bell open the notifications page instead.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _icons = {
  'Pembayaran': LucideIcons.wallet,
  'Clearance': LucideIcons.fileCheck,
  'Laporan': LucideIcons.fileText,
  'Rilis': LucideIcons.disc,
  'Umum': LucideIcons.info,
};

/// One notification. `time` is relative and `at` the full date and time for its tooltip. `href` is the page it is
/// about; without one, a tap only marks it read.
class _Notification {
  _Notification(
    this.category,
    this.title,
    this.body,
    this.time,
    this.today, {
    required this.at,
    this.read = true,
    this.href,
  });

  final String category, title, body, time, at;
  final bool today;
  final String? href;
  bool read;
}

/// The newest notifications; the panel shows at most 8, the page shows the rest.
List<_Notification> _notifications() => [
  _Notification(
    'Pembayaran',
    at: '17 Nov 2026, 14.20',
    'Royalti Oktober sudah masuk',
    'Rp1.250.000,00 masuk ke saldomu.',
    '5 menit lalu',
    true,
    read: false,
    href: '/saldo',
  ),
  _Notification(
    'Clearance',
    at: '17 Nov 2026, 13.25',
    'Clearance "Langit Jingga" disetujui',
    'Videomu siap tayang.',
    '1 jam lalu',
    true,
    read: false,
    href: '/clearance',
  ),
  _Notification(
    'Laporan',
    at: '17 Nov 2026, 11.05',
    'Laporan royalti Oktober siap',
    'Cek pendapatan tiap platform.',
    '3 jam lalu',
    true,
    read: false,
    href: '/laporan',
  ),
  _Notification(
    'Rilis',
    at: '16 Nov 2026, 19.40',
    '"Senja di Kota" tayang di Spotify',
    'Rilismu sudah bisa diputar.',
    'Kemarin',
    false,
    href: '/rilis',
  ),
  _Notification(
    'Pembayaran',
    at: '16 Nov 2026, 09.00',
    'Tagihan langganan November',
    'Bayar sebelum 30 Nov 2026 supaya layananmu tetap jalan.',
    'Kemarin',
    false,
    href: '/tagihan',
  ),
  _Notification(
    'Clearance',
    at: '15 Nov 2026, 10.15',
    'Clearance "Kaset Pertama" perlu diperbaiki',
    'Cek catatan dari tim kami, lalu kirim ulang.',
    '2 hari lalu',
    false,
    href: '/clearance',
  ),
  _Notification(
    'Umum',
    at: '14 Nov 2026, 08.30',
    'Kata sandimu baru saja diganti',
    'Bukan kamu? Segera hubungi kami.',
    '3 hari lalu',
    false,
  ),
  _Notification(
    'Rilis',
    at: '13 Nov 2026, 16.45',
    '"Pulang Sore" dijadwalkan 28 Nov 2026',
    'Kami kirim ke semua platform di tanggal itu.',
    '4 hari lalu',
    false,
    href: '/rilis',
  ),
];

class NotificationPanelDemo extends StatefulWidget {
  const NotificationPanelDemo({super.key});

  @override
  State<NotificationPanelDemo> createState() => _NotificationPanelDemoState();
}

class _NotificationPanelDemoState extends State<NotificationPanelDemo> {
  final popover = ShadPopoverController();
  final _items = _notifications();
  var _unreadOnly = false;

  int get _unread => _items.where((n) => !n.read).length;

  @override
  void dispose() {
    popover.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    return ShadPopover(
      controller: popover,
      padding: EdgeInsets.zero,
      popover: (context) => StatefulBuilder(
        builder: (context, setPanelState) {
          void update(VoidCallback change) {
            setPanelState(change);
            setState(() {});
          }

          // Filter first, then cap at 8 rows.
          final shown = _items
              .where((n) => !_unreadOnly || !n.read)
              .take(8)
              .toList();
          final groups = [
            ('Hari ini', shown.where((n) => n.today).toList()),
            ('Sebelumnya', shown.where((n) => !n.today).toList()),
          ].where((g) => g.$2.isNotEmpty);
          return SizedBox(
            width: 360,
            child: Column(
              mainAxisSize: MainAxisSize.min,
              crossAxisAlignment: CrossAxisAlignment.stretch,
              children: [
                Padding(
                  padding: const EdgeInsets.fromLTRB(16, 8, 8, 8),
                  child: Row(
                    children: [
                      Expanded(
                        child: Text('Notifikasi', style: theme.textTheme.large),
                      ),
                      ShadButton.link(
                        size: ShadButtonSize.sm,
                        enabled: _unread > 0,
                        onPressed: () => update(() {
                          for (final n in _items) {
                            n.read = true;
                          }
                        }),
                        child: const Text('Tandai semua dibaca'),
                      ),
                    ],
                  ),
                ),
                const ShadSeparator.horizontal(margin: EdgeInsets.zero),
                Padding(
                  padding: const EdgeInsets.symmetric(
                    horizontal: 16,
                    vertical: 8,
                  ),
                  child: Semantics(
                    label: 'Tampilkan',
                    child: Align(
                      alignment: Alignment.centerLeft,
                      child: ShadToggleGroup<bool>(
                        initialValue: _unreadOnly,
                        allowDeselection: false,
                        size: ShadButtonSize.sm,
                        onChanged: (value) =>
                            update(() => _unreadOnly = value ?? false),
                        items: [
                          const ShadToggleGroupItem(
                            value: false,
                            child: Text('Semua'),
                          ),
                          ShadToggleGroupItem(
                            value: true,
                            child: Semantics(
                              label: _unread > 0
                                  ? 'Belum dibaca ($_unread)'
                                  : null,
                              excludeSemantics: _unread > 0,
                              child: Text(
                                _unread > 0
                                    ? 'Belum dibaca $_unread'
                                    : 'Belum dibaca',
                              ),
                            ),
                          ),
                        ],
                      ),
                    ),
                  ),
                ),
                const ShadSeparator.horizontal(margin: EdgeInsets.zero),
                ConstrainedBox(
                  constraints: const BoxConstraints(maxHeight: 420),
                  child: groups.isEmpty
                      ? Padding(
                          padding: const EdgeInsets.symmetric(vertical: 40),
                          child: Text(
                            'Semua notifikasi sudah kamu baca.',
                            textAlign: TextAlign.center,
                            style: theme.textTheme.muted,
                          ),
                        )
                      : ListView(
                          shrinkWrap: true,
                          children: [
                            for (final (label, rows) in groups) ...[
                              Padding(
                                padding: const EdgeInsets.fromLTRB(
                                  16,
                                  10,
                                  16,
                                  4,
                                ),
                                child: Text(
                                  label,
                                  style: theme.textTheme.muted.copyWith(
                                    fontSize: 12,
                                  ),
                                ),
                              ),
                              for (final n in rows)
                                _PanelRow(
                                  notification: n,
                                  onOpen: () => update(() => n.read = true),
                                  onToggleRead: () =>
                                      update(() => n.read = !n.read),
                                  onRemove: () =>
                                      update(() => _items.remove(n)),
                                ),
                            ],
                          ],
                        ),
                ),
                const ShadSeparator.horizontal(margin: EdgeInsets.zero),
                // Opens the notifications page; call your router here.
                ShadButton.ghost(
                  onPressed: popover.hide,
                  child: const Text('Lihat semua notifikasi'),
                ),
              ],
            ),
          );
        },
      ),
      child: Semantics(
        label: _unread > 0 ? 'Notifikasi ($_unread)' : 'Notifikasi',
        button: true,
        child: Stack(
          clipBehavior: Clip.none,
          children: [
            ShadIconButton.ghost(
              icon: const Icon(LucideIcons.bell),
              onPressed: popover.toggle,
            ),
            if (_unread > 0)
              Positioned(
                top: 2,
                right: 2,
                child: ExcludeSemantics(
                  child: Container(
                    padding: const EdgeInsets.symmetric(horizontal: 4),
                    constraints: const BoxConstraints(
                      minWidth: 16,
                      minHeight: 16,
                    ),
                    decoration: BoxDecoration(
                      color: theme.colorScheme.destructive,
                      borderRadius: BorderRadius.circular(6),
                    ),
                    alignment: Alignment.center,
                    child: Text(
                      _unread > 99 ? '99+' : '$_unread',
                      style: TextStyle(
                        fontSize: 10,
                        fontWeight: FontWeight.w600,
                        color: theme.colorScheme.destructiveForeground,
                      ),
                    ),
                  ),
                ),
              ),
          ],
        ),
      ),
    );
  }
}

/// A panel row: category icon, title (bold while unread), body clamped to two lines, time and category, the unread
/// dot, and the row menu beside it.
class _PanelRow extends StatefulWidget {
  const _PanelRow({
    required this.notification,
    required this.onOpen,
    required this.onToggleRead,
    required this.onRemove,
  });

  final _Notification notification;
  final VoidCallback onOpen, onToggleRead, onRemove;

  @override
  State<_PanelRow> createState() => _PanelRowState();
}

class _PanelRowState extends State<_PanelRow> {
  final menu = ShadContextMenuController();
  var _focused = false;

  @override
  void dispose() {
    menu.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final n = widget.notification;
    return ColoredBox(
      color: n.read
          ? const Color(0x00000000)
          : theme.colorScheme.muted.withValues(alpha: 0.5),
      child: Padding(
        padding: const EdgeInsets.fromLTRB(16, 8, 8, 8),
        child: Row(
          crossAxisAlignment: CrossAxisAlignment.start,
          spacing: 8,
          children: [
            Expanded(
              child: Semantics(
                // A row with a target opens it (call your router here); every row is marked read. Enter and Space
                // open a focused row, as a tap does.
                link: n.href != null,
                button: n.href == null,
                child: FocusableActionDetector(
                  mouseCursor: SystemMouseCursors.click,
                  onShowFocusHighlight: (value) =>
                      setState(() => _focused = value),
                  actions: {
                    ActivateIntent: CallbackAction<ActivateIntent>(
                      onInvoke: (_) => widget.onOpen(),
                    ),
                  },
                  child: GestureDetector(
                    behavior: HitTestBehavior.opaque,
                    onTap: widget.onOpen,
                    child: DecoratedBox(
                      decoration: BoxDecoration(
                        borderRadius: BorderRadius.circular(8),
                        border: Border.all(
                          color: _focused
                              ? theme.colorScheme.ring
                              : const Color(0x00000000),
                          width: 2,
                        ),
                      ),
                      child: Row(
                        crossAxisAlignment: CrossAxisAlignment.start,
                        spacing: 12,
                        children: [
                          Container(
                            width: 32,
                            height: 32,
                            decoration: BoxDecoration(
                              color: theme.colorScheme.muted,
                              shape: BoxShape.circle,
                            ),
                            child: Icon(
                              _icons[n.category],
                              size: 16,
                              color: theme.colorScheme.mutedForeground,
                            ),
                          ),
                          Expanded(
                            child: Column(
                              crossAxisAlignment: CrossAxisAlignment.start,
                              spacing: 2,
                              children: [
                                Text(
                                  n.title,
                                  style: theme.textTheme.small.copyWith(
                                    fontWeight: n.read
                                        ? FontWeight.w400
                                        : FontWeight.w600,
                                  ),
                                ),
                                Text(
                                  n.body,
                                  maxLines: 2,
                                  overflow: TextOverflow.ellipsis,
                                  style: theme.textTheme.muted.copyWith(
                                    fontSize: 12,
                                  ),
                                ),
                                Row(
                                  children: [
                                    ShadTooltip(
                                      builder: (context) => Text(n.at),
                                      child: Text(
                                        n.time,
                                        style: theme.textTheme.muted.copyWith(
                                          fontSize: 12,
                                        ),
                                      ),
                                    ),
                                    Flexible(
                                      child: Text(
                                        ' · ${n.category}',
                                        maxLines: 1,
                                        overflow: TextOverflow.ellipsis,
                                        style: theme.textTheme.muted.copyWith(
                                          fontSize: 12,
                                        ),
                                      ),
                                    ),
                                  ],
                                ),
                              ],
                            ),
                          ),
                          if (!n.read)
                            Semantics(
                              label: 'Belum dibaca',
                              child: Container(
                                margin: const EdgeInsets.only(top: 6),
                                width: 8,
                                height: 8,
                                decoration: BoxDecoration(
                                  color: theme.colorScheme.primary,
                                  shape: BoxShape.circle,
                                ),
                              ),
                            ),
                        ],
                      ),
                    ),
                  ),
                ),
              ),
            ),
            ShadContextMenu(
              controller: menu,
              items: [
                ShadContextMenuItem(
                  onPressed: widget.onToggleRead,
                  child: Text(n.read ? 'Tandai belum dibaca' : 'Tandai dibaca'),
                ),
                const ShadSeparator.horizontal(
                  margin: EdgeInsets.symmetric(vertical: 4),
                ),
                ShadContextMenuItem(
                  onPressed: widget.onRemove,
                  child: Text(
                    'Hapus',
                    style: TextStyle(color: context.sosialoka.destructive),
                  ),
                ),
              ],
              child: Semantics(
                label: 'Aksi untuk ${n.title}',
                child: ShadIconButton.ghost(
                  icon: const Icon(LucideIcons.ellipsis),
                  onPressed: menu.toggle,
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }
}
```

## Dibangun dari

[Toggle Group](https://design.sosialoka.tech/id/components/toggle-group/), [Dropdown Menu](https://design.sosialoka.tech/id/components/dropdown-menu/), [Alert Dialog](https://design.sosialoka.tech/id/components/alert-dialog/), [Popover](https://design.sosialoka.tech/id/components/popover/), [Button](https://design.sosialoka.tech/id/components/button/), [Tooltip](https://design.sosialoka.tech/id/components/tooltip/), dan `DashboardIconButton` dari blok [Dasbor](https://design.sosialoka.tech/id/patterns/dashboard/).

## Flutter

Chip kategori berupa `ShadToggleGroup` dengan `allowDeselection: false`, di dalam scroll horizontal supaya muat di HP. Di HP, lonceng membuka halaman; di tablet dan desktop, lonceng membuka `ShadPopover`. Buka aksi baris lewat `ShadContextMenu`, dan beri tombolnya label semantik.


---

# Halaman artist

> Halaman artist My Loka Link. Kolomnya selebar 440px, dengan hero dan ajakan utama memakai warna aksen artist.

Fans membuka halaman My Loka Link seorang artist lewat ponsel, jadi halaman ini berupa satu kolom selebar 440px. Warna artist datang dari preset aksen tenant, sedangkan bagian lainnya tetap memakai tema My Loka Link.

## Kapan dipakai

- Pakai untuk halaman publik milik satu artist atau tenant, di My Loka Link dan Ruang Loka Musik.
- Jangan pakai aksen tenant di layar admin.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/patterns/artist-page/_

## Anatomi

1. **Hero** di atas `tenant-accent-soft`: avatar, nama artist dengan font display brand, dan satu kalimat bio.
2. **Ajakan utama** di atas `tenant-accent`, selebar kolom.
3. **Tautan** berupa baris outline selebar kolom, dengan ikon Lucide dan tanda panah.
4. **Kartu jadwal** berisi tanggal dan tempat.
5. **Footer:** "from Sosialoka".

## Aturan

- **Aksen hanya di hero dan ajakan utama.** Tautan, kartu, dan teks tetap memakai tema brand.
- **Teks di hero** memakai `foreground` atau `tenant-accent-text`. `muted-foreground` turun di bawah 4.5:1 pada beberapa preset.
- **Preset:** isi `data-tenant-accent` di root halaman dengan `blue`, `orange`, `teal`, atau `red`. Semua preset lolos cek kontras di mode terang dan gelap. Lihat [Warna](https://design.sosialoka.tech/id/foundations/color/).
- **Ikon:** pakai Lucide untuk antarmuka. Jangan pakai logo platform pihak ketiga.
- **Kolom:** maksimal 440px dan berada di tengah, juga di desktop.

## Kode

**React**
```tsx
import { CalendarIcon, ChevronRightIcon, DiscIcon, PlayIcon, ShirtIcon, VideoIcon } from "lucide-react"
import { Avatar, AvatarFallback } from "@/components/ui/avatar"
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"

const links = [
  { label: "Rilis terbaru", icon: DiscIcon },
  { label: "Video", icon: VideoIcon },
  { label: "Jadwal manggung", icon: CalendarIcon },
  { label: "Merchandise", icon: ShirtIcon },
]

const shows = [
  { date: "Sab, 22 Nov 2026", place: "Kafe Lentera, Bandung" },
  { date: "Jum, 5 Des 2026", place: "Ruang Dengar, Yogyakarta" },
]

/**
 * A My Loka Link artist page: a 440px column on the artist's accent (data-tenant-accent). The accent colors
 * only the hero and the main call to action; everything else stays on the brand theme.
 */
export default function ArtistPageDemo() {
  return (
    <div data-tenant-accent="orange" className="mx-auto min-h-svh max-w-[440px] bg-background text-foreground">
      <header className="flex flex-col items-center gap-3 bg-tenant-accent-soft px-6 pt-10 pb-8 text-center">
        <Avatar className="size-24">
          <AvatarFallback className="bg-tenant-accent text-2xl text-tenant-accent-foreground">NS</AvatarFallback>
        </Avatar>
        <h1
          className="text-3xl"
          style={{
            fontFamily: "var(--font-brand)",
            fontWeight: "var(--font-brand-weight)",
            letterSpacing: "var(--font-brand-tracking)",
          }}
        >
          Nadia Senja
        </h1>
        <p className="text-sm text-foreground">Penyanyi folk dari Bandung. Lagu tentang kota dan pulang.</p>
        <a
          href="#"
          className="mt-2 inline-flex h-10 w-full items-center justify-center gap-2 rounded-md bg-tenant-accent px-4 text-sm font-medium text-tenant-accent-foreground outline-none hover:bg-tenant-accent/90 focus-visible:ring-[3px] focus-visible:ring-ring/50"
        >
          <PlayIcon className="size-4 fill-current" />
          Dengarkan rilis terbaru
        </a>
      </header>

      <nav aria-label="Tautan" className="grid gap-2 px-4 py-6">
        {links.map((link) => (
          <a
            key={link.label}
            href="#"
            className="flex h-12 items-center gap-3 rounded-lg border border-border bg-card px-4 text-sm font-medium outline-none hover:bg-muted focus-visible:ring-[3px] focus-visible:ring-ring/50"
          >
            <link.icon className="size-4 text-muted-foreground" />
            <span className="flex-1">{link.label}</span>
            <ChevronRightIcon className="size-4 text-muted-foreground" />
          </a>
        ))}
      </nav>

      <div className="px-4">
        <Card>
          <CardHeader>
            <CardTitle>Jadwal manggung</CardTitle>
          </CardHeader>
          <CardContent className="grid gap-3">
            {shows.map((show) => (
              <div key={show.date} className="grid gap-0.5">
                <span className="text-sm font-medium">{show.date}</span>
                <span className="text-sm text-muted-foreground">{show.place}</span>
              </div>
            ))}
          </CardContent>
        </Card>
      </div>

      <footer className="flex items-center justify-center gap-1.5 py-8 text-xs text-muted-foreground">
        <span>from</span> <img src="/brand/sosialoka.png" alt="" className="size-4" />{" "}
        <span className="font-semibold text-foreground">Sosialoka</span>
      </footer>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Calendar, ChevronRight, Disc, Play, Shirt, Video } from "@lucide/vue"
import { Avatar, AvatarFallback } from "@/components/ui/avatar"
import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card"

/**
 * A My Loka Link artist page: a 440px column on the artist's accent (data-tenant-accent). The accent colors
 * only the hero and the main call to action; everything else stays on the brand theme.
 */
const links = [
  { label: "Rilis terbaru", icon: Disc },
  { label: "Video", icon: Video },
  { label: "Jadwal manggung", icon: Calendar },
  { label: "Merchandise", icon: Shirt },
]

/** The Sosialoka mark; a binding, so the SFC compiler leaves the URL alone instead of importing it. */
const markSrc = "/brand/sosialoka.png"

const shows = [
  { date: "Sab, 22 Nov 2026", place: "Kafe Lentera, Bandung" },
  { date: "Jum, 5 Des 2026", place: "Ruang Dengar, Yogyakarta" },
]
</script>

<template>
  <div data-tenant-accent="orange" class="mx-auto min-h-svh max-w-[440px] bg-background text-foreground">
    <header class="flex flex-col items-center gap-3 bg-tenant-accent-soft px-6 pt-10 pb-8 text-center">
      <Avatar class="size-24">
        <AvatarFallback class="bg-tenant-accent text-2xl text-tenant-accent-foreground">NS</AvatarFallback>
      </Avatar>
      <h1
        class="text-3xl"
        style="font-family: var(--font-brand); font-weight: var(--font-brand-weight); letter-spacing: var(--font-brand-tracking)"
      >
        Nadia Senja
      </h1>
      <p class="text-sm text-foreground">Penyanyi folk dari Bandung. Lagu tentang kota dan pulang.</p>
      <a
        href="#"
        class="mt-2 inline-flex h-10 w-full items-center justify-center gap-2 rounded-md bg-tenant-accent px-4 text-sm font-medium text-tenant-accent-foreground outline-none hover:bg-tenant-accent/90 focus-visible:ring-[3px] focus-visible:ring-ring/50"
      >
        <Play class="size-4 fill-current" />
        Dengarkan rilis terbaru
      </a>
    </header>

    <nav aria-label="Tautan" class="grid gap-2 px-4 py-6">
      <a
        v-for="link in links"
        :key="link.label"
        href="#"
        class="flex h-12 items-center gap-3 rounded-lg border border-border bg-card px-4 text-sm font-medium outline-none hover:bg-muted focus-visible:ring-[3px] focus-visible:ring-ring/50"
      >
        <component :is="link.icon" class="size-4 text-muted-foreground" />
        <span class="flex-1">{{ link.label }}</span>
        <ChevronRight class="size-4 text-muted-foreground" />
      </a>
    </nav>

    <div class="px-4">
      <Card>
        <CardHeader>
          <CardTitle>Jadwal manggung</CardTitle>
        </CardHeader>
        <CardContent class="grid gap-3">
          <div v-for="show in shows" :key="show.date" class="grid gap-0.5">
            <span class="text-sm font-medium">{{ show.date }}</span>
            <span class="text-sm text-muted-foreground">{{ show.place }}</span>
          </div>
        </CardContent>
      </Card>
    </div>

    <footer class="flex items-center justify-center gap-1.5 py-8 text-xs text-muted-foreground">
      <span>from</span> <img :src="markSrc" alt="" class="size-4"> <span class="font-semibold text-foreground">Sosialoka</span>
    </footer>
  </div>
</template>
```

**Flutter**
```dart
// A My Loka Link artist page: a 440 px column on the artist's accent. The accent colors only the hero and
// the main call to action. sosialoka_ui has no tenant parameter yet, so read the preset from
// SosialokaColors.tenant for the current mode.
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';
import 'package:sosialoka_ui/sosialoka_ui.dart';

const _links = [
  ('Rilis terbaru', LucideIcons.disc),
  ('Video', LucideIcons.video),
  ('Jadwal manggung', LucideIcons.calendar),
  ('Merchandise', LucideIcons.shirt),
];

class ArtistPageDemo extends StatelessWidget {
  const ArtistPageDemo({super.key, this.accent = 'orange'});

  /// One of the tenant presets: blue, orange, teal or red.
  final String accent;

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    final mode = theme.brightness == Brightness.dark ? 'dark' : 'light';
    final tenant = SosialokaColors.tenant[accent]![mode]!;
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 440),
      child: Column(
        mainAxisSize: MainAxisSize.min,
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          ColoredBox(
            color: tenant['tenant-accent-soft']!,
            child: Padding(
              padding: const EdgeInsets.fromLTRB(24, 32, 24, 24),
              child: Column(
                children: [
                  ShadAvatar(
                    '',
                    size: const Size.square(96),
                    backgroundColor: tenant['tenant-accent'],
                    placeholder: Text('NS', style: TextStyle(color: tenant['tenant-accent-foreground'], fontSize: 24)),
                  ),
                  const SizedBox(height: 12),
                  Text('Nadia Senja', style: theme.textTheme.h2),
                  const SizedBox(height: 4),
                  Text(
                    'Penyanyi folk dari Bandung. Lagu tentang kota dan pulang.',
                    // foreground, not muted: muted text drops under 4.5:1 on some tenant presets.
                    style: theme.textTheme.p.copyWith(color: theme.colorScheme.foreground),
                    textAlign: TextAlign.center,
                  ),
                  const SizedBox(height: 16),
                  ShadButton(
                    width: double.infinity,
                    backgroundColor: tenant['tenant-accent'],
                    foregroundColor: tenant['tenant-accent-foreground'],
                    leading: const Icon(LucideIcons.play, size: 16),
                    onPressed: () {},
                    child: const Text('Dengarkan rilis terbaru'),
                  ),
                ],
              ),
            ),
          ),
          const SizedBox(height: 16),
          for (final (label, icon) in _links)
            Padding(
              padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 4),
              child: ShadButton.outline(
                height: 48,
                mainAxisAlignment: MainAxisAlignment.start,
                leading: Icon(icon, size: 16),
                trailing: const Icon(LucideIcons.chevronRight, size: 16),
                onPressed: () {},
                child: Expanded(child: Text(label)),
              ),
            ),
        ],
      ),
    );
  }
}
```

## Dibangun dari

[Avatar](https://design.sosialoka.tech/id/components/avatar/) dan [Card](https://design.sosialoka.tech/id/components/card/), ditambah token aksen tenant.

## Flutter

`sosialoka_ui` belum punya opsi tenant. Ambil warna preset dari `SosialokaColors.tenant[accent][mode]`, lalu pakai untuk hero dan tombol utama.


---

# Konten

> Gaya bahasa di produk Sosialoka. Pakai "kamu", kalimat pendek dan aktif, tanpa istilah legal, dan pesan error dari backend.

Aturan ini berlaku untuk semua copy antarmuka di semua produk dan peran. Ini mencakup label, judul, hint, tooltip, toast, pesan error, state kosong, dialog, notifikasi, dan email. Dokumen legal seperti template perjanjian bukan copy antarmuka.

## Sapaan

- **Pakai "kamu" / "-mu",** bukan "Anda". Contoh: "Akunmu sedang kami periksa."
- **Perusahaan menyebut dirinya "kami"** hanya di layar yang dibaca klien. Layar admin dibaca staf sendiri, jadi sebut nama produknya ("Cover Clearance"), atau hilangkan pemiliknya.
- **Ramah, tapi tidak lebay.** Ajakan ringan boleh ("Simpan dulu, lanjutkan kapan saja."). Hindari slang berlebihan, misalnya "gak", "banget", atau "yuk" di setiap kalimat.

## Kalimat

- Pendek dan aktif, satu ide per kalimat.
- Sebutkan apa yang dilakukan kontrolnya, bukan cara kerja fiturnya.
- Jangan pakai nomor pasal, istilah legal, atau kata "perjanjian" di copy biasa. Tulis apa tujuannya.

| Jangan | Pakai |
| --- | --- |
| Ke mana surat dan pemberitahuan terkait perjanjian dikirim. | Ke sini kami kirim surat dan kabar penting untukmu. |
| Mohon maaf, data yang Anda masukkan tidak valid. | Format email-nya belum pas. |

## Hint dan tooltip

- Hint isian cukup satu kalimat praktis: apa yang diisi, contoh, atau batasan.
- Tooltip cukup satu kalimat. Isinya nama kontrol, bukan alasan kebijakan di baliknya.

## Pesan error

- **Backend yang menulisnya.** Backend memeriksa setiap isian dan mengirim pesannya, jadi web dan aplikasi mobile menampilkan kata-kata yang sama.
- **Klien hanya mengatur tombol.** Misalnya, "Kirim" dinonaktifkan sampai isian wajib terisi. Klien tidak pernah menampilkan pesan error buatannya sendiri.
- **Sebutkan apa yang perlu diperbaiki,** dengan gaya kamu: "Email-nya belum diisi.", "Judul lagunya belum diisi."

## Angka dan tanggal

- Rupiah ditulis dengan dua desimal: `Rp4.812.500,00`.
- Tanggal ditulis `14 Nov 2026`. Untuk jadwal, tambahkan harinya: `Sab, 22 Nov 2026`.
- Pakai `tabular-nums` untuk angka di tabel dan statistik.

## Tombol umum

| Bahasa Indonesia | Bahasa Inggris |
| --- | --- |
| Simpan | Save |
| Batal | Cancel |
| Kirim | Send |
| Hapus | Delete |
| Coba lagi | Try again |
| Keluar | Sign out |

## Copy bahasa Inggris

Copy bahasa Inggris memakai gaya santai yang sama: "you" dan "your", kalimat pendek, dan tanpa istilah legal di copy biasa.
