Lewati ke konten

Aplikasi mobile

Unduh .md

Kerangka aplikasi mobile adalah versi HP dari Dasbor: judul, pencarian, dan tujuan utama ada di tempat yang sama di setiap aplikasi Sosialoka, dari Cover Clearance sampai My Loka Link.

  • 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.
  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.
  • 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.
  • Bottom nav: 3 sampai 5 tujuan, label selalu tampil, target setinggi minimal 48px. Taruh Akun paling akhir.
  • Urutkan dan filter membuka Drawer dari bawah, bukan halaman.
  • Baris memakai Item; status ditaruh di Badge pada barisnya.
  • Safe area: top bar dan bottom nav menjauhi notch dan garis home (env(safe-area-inset-*)).
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.
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>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/mobile-shell.json

Blok ini masuk ke components/blocks/. Pasang Item, Drawer, Badge, Input Group, Button, Label, dan Radio Group untuk isi yang ditampilkan di sini.

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.

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