Design System
Satu sumber kebenaran untuk tampilan proyek.
Semua warna, tipografi, radius, dan komponen inti terdokumentasi di halaman ini. Setiap token, komponen, atau varian baru wajib ditambahkan ke sini agar desain proyek tetap konsisten.
Warna
Warna hanya berasal dari token di styles/theme.css. Ganti nilai token untuk mengubah brand, bukan class di komponen.
--background
Latar halaman.
--foreground
Teks utama dan elemen gelap.
--primary
Aksi utama seperti tombol dan tautan penting.
--primary-foreground
Teks dan ikon di atas warna primary.
--muted
Latar sekunder, hover, dan kartu.
--muted-foreground
Teks sekunder dan keterangan.
--border
Garis batas dan pemisah.
--ring
Ring fokus untuk navigasi keyboard.
--destructive
Error validasi dan aksi berbahaya.
--navy
Latar kontras tinggi untuk footer dan CTA akhir.
--navy-foreground
Teks di atas latar navy.
--surface-card
Latar kartu konten.
Tema
Light dan dark mode memakai token yang sama; nilai gelap ada di blok .dark di styles/theme.css. Pasang ThemeToggle di header atau footer, dan pastikan semua halaman tetap nyaman serta kontras di dua mode.
Klik tombol untuk mencoba light/dark.
Tipografi
Gunakan skala bawaan Tailwind. Judul memakai font-semibold dan tracking-tight, teks isi memakai leading yang lega.
Font
Contoh tampilan font proyek.
--font-sans
Font dipilih per proyek lewat next/font di app/layout.tsx, lalu dipetakan ke token --font-sans di styles/theme.css. Bawaan starter memakai system font stack.
Skala teks
Judul utama halaman.
Display
Satu per halaman, dipakai di hero.
Judul bagian konten.
Judul section
Pembuka setiap section.
Nama kartu atau item.
Judul kartu
Judul di dalam kartu dan daftar.
Paragraf untuk penjelasan panjang.
Isi
Teks isi utama.
Catatan pendukung yang lebih kecil.
Keterangan
Teks sekunder dan bantuan.
Radius
Radius mengikuti satu token dasar --radius di styles/theme.css, sehingga satu perubahan terasa di seluruh komponen.
--radius-sm
Elemen kecil seperti badge.
--radius-md
Default untuk tombol, input, dan kartu kecil.
--radius-lg
Kartu dan panel besar.
Layout
Section mengatur ritme jarak vertikal, Container mengatur lebar dan padding horizontal, dan melebar di layar besar (2xl). Semua section memakai keduanya.
Section
py-16 sm:py-20 lg:py-24
Container
max-w-6xl · 2xl:max-w-7xl · px-4 sm:px-6 lg:px-8
Tombol
Tombol dan tautan bergaya tombol selalu memakai Button atau buttonStyles() dari components/ui/button.tsx, bukan class buatan sendiri.
Varian
Aksi utama. Maksimal satu per layar.
Aksi pendukung dengan latar lembut.
Aksi alternatif dengan garis batas.
Aksi tersier tanpa latar.
Aksi dengan latar navy gelap.
Ukuran
Untuk area rapat.
Ukuran default.
Untuk CTA utama.
Tautan bergaya tombol
Tautan yang terlihat seperti tombol memakai buttonStyles() agar gayanya identik dengan Button.
Badge
Label kecil untuk kategori, promo, atau status. Gunakan varian yang tersedia, bukan warna baru.
- Neutral
Kategori dan label umum.
- Primary
Status atau penawaran utama.
- Outline
Label ringan di atas latar terang.
- Navy
Label berlatar navy untuk sorotan khusus.
Form
Input selalu dibungkus Field agar label, hint, error, dan aria-describedby ditangani otomatis.
Tulis sesuai kartu identitas.
Email wajib diisi.
Card
Pembungkus standar untuk produk, berita, atau program. Gunakan Card agar border, radius, dan padding konsisten.
Ikon
Beberapa paket react-icons tersedia supaya desain tiap project bisa bervariasi: lu (Lucide), tb (Tabler), pi (Phosphor), ri (Remix), hi2 (Heroicons), bs (Bootstrap), dan fa6/si untuk logo brand. Pilih maksimal dua paket UI per project; ikon mewarisi warna teks dan ukurannya diatur dengan utility size-*.
Ukuran
size-4
Ikon kecil di dalam teks.
size-5
Default di dalam tombol dan tautan.
size-6
Ikon mandiri di kartu.
size-8
Ikon dekoratif besar.
Paket dan contoh
lu
LuPhone
Kontak telepon.
lu
LuMapPin
Alamat dan lokasi.
tb
TbChefHat
Kuliner dan F&B.
pi
PiStorefront
Toko dan retail.
ri
RiScissorsLine
Fashion dan jasa.
hi2
HiMiniSparkles
Aksen dekoratif.
fa6
FaWhatsapp
Logo WhatsApp.
fa6
FaInstagram
Logo Instagram.
Motion
Animasi dipakai saat brand menuntut (fashion, footwear, portfolio elegan). Satu bahasa gerak per proyek: durasi dan easing yang sama di semua animasi, dan selalu hormati prefers-reduced-motion.
Durasi
150ms
Micro-interaction: hover, fokus, tombol.
250ms
Transisi komponen: dropdown, kartu, tab.
400ms
Reveal section dan transisi halaman yang lembut.
Easing
ease-smooth
Easing default proyek untuk semua gerakan.
Arahkan kursor ke kotak untuk melihat easing.