Dasbor
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
Section titled “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
Section titled “Lakukan dan jangan”Anatomi
Section titled “Anatomi”- 1Sidebar dengan logo produk
- 2Kartu header, melayang di atas blur
- 3Pencarian: membuka command palette
- 4Dropdown kode bahasa, lalu aksi ikon dengan tooltip
- 5Avatar dan menu akun, selalu paling akhir
- 6Isi di background
- Sidebar: lebar 16rem di permukaan putih
sidebar, dengan logo produk di atas. Menu yang aktif memakaisidebar-accentdan punyaaria-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
Section titled “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.
- Menu: lima sampai tujuh item dengan ikon. Pengaturan ditaruh paling bawah. Produk dengan lebih banyak halaman mengikuti Menu navigasi.
- Aksi: bahasa paling depan, lalu maksimal tiga aksi ikon dengan urutan: mode, bantuan, notifikasi. Susun mode dengan
DashboardModeSelectdan aksi lain denganDashboardIconButton;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()memasangdata-themedi<html>dan mengingat pilihannya; pasang mode yang sama lewat script inline di<head>supaya halaman tidak berkedip. Flutter:ThemeMode.light,ThemeMode.dark, danThemeMode.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:
badgemenampilkan jumlah yang belum dibaca; jangan tampilkan saat nol. Lonceng membuka panel dari Notifikasi. - 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.
| 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. |
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. |
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> )}<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 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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/dashboard-shell.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/dashboard-shell.jsonBlok ini dipasang di components/blocks/. Sidebar, Command, Dropdown Menu, dan Avatar versi Sosialoka ikut terpasang.
Flutter
Section titled “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
Section titled “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.
