# 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 ``` | 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
``` 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/.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/.json` - Vue: `npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/.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/.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: ``. - 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 ``` ```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 (
) } ``` **Vue** ```vue ``` **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 (

Ke sini kami kirim kabar penting untukmu.

) } ``` **Vue** ```vue ``` **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 (
Kata sandi setVisible((v) => !v)} > {visible ? : }
) } ``` **Vue** ```vue ``` **Flutter** ```dart import 'package:flutter/widgets.dart'; import 'package:shadcn_ui/shadcn_ui.dart'; class InputGroupDemo extends StatefulWidget { const InputGroupDemo({super.key}); @override State createState() => _InputGroupDemoState(); } class _InputGroupDemoState extends State { 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 ( Catatan untuk tim