Prinsip & Karakter
Section 01 dari 15 · Aturan & Fondasi

Prinsip & Karakter

Enam aturan non-negotiable yang membentuk seluruh sistem. AI hanya boleh menghasilkan output yang konsisten dengan prinsip ini — jika ragu, kembali ke sini.

01 · Hairline sebagai bahasa utama
1px border adalah penanda hierarki, bukan shadow. Card tanpa alasan jelas = pelanggaran.
02 · Density > dekorasi
Informasi padat tapi terorganisir. Tidak ada hero besar di dalam app.
03 · Motion hanya untuk feedback
Transisi 120–200ms. Tanpa bounce, gradient animation, atau parallax di app.
04 · Warna aksi itu langka
Satu accent (blue). Semua warna lain neutral. Feedback color hanya untuk status.
05 · Tipografi membawa hierarki
Weight + size + color. Bukan gradient, bukan border tebal, bukan background color.
06 · Zero marketing-speak di app
"Unlock", "Seamless", "Revolutionize" dilarang. Verb langsung, sentence case.
Dua Watak: App vs Marketing
AspekApp (Operasional)Marketing (Publik)
DensityCompactSpacious
Body size13px16px
Display max28px72px
MotionFeedback onlyEntrance allowed
VoiceDirektif, fungsionalPersuasif, storytelling
Hero sectionDilarangDiperbolehkan
Mega menuDilarangDiperbolehkan

Warna & Color Lab

Primitive ramp (nilai mentah) dan semantic token (mapping per mode). Color Lab di bawah memungkinkan lo tuning accent secara live menggunakan OKLCH interpolation.

Primitive — Gray
Primitive — Blue (Accent)
Color Lab v1.0 — Tuning Accent & Palet Live

2 anchor (lightest 50 & darkest 950) → 11-step ramp via OKLCH interpolation · Live · Export JSON & CSS

Semantic Preview

Mapping ramp ke token semantik di light & dark mode. Live mengikuti perubahan di atas.

Export Tokens

Copy token hasil lab ke tokens.json atau tailwind.config.js / tokens.css

Tipografi

Inter untuk semua UI. Inter Tight untuk display marketing. JetBrains Mono untuk kode dan angka tabular.

App Scale
--text-xs · 12/16 · 400Helper text, caption, timestamp
--text-sm · 13/18 · 400Body default untuk data-dense UI
--text-base · 14/20 · 400Body untuk comfortable mode
--text-lg · 16/24 · 500Section title
--text-xl · 20/28 · 600Page heading
--text-2xl · 28/36 · 600Dashboard title
Marketing Scale
--m-body · 16/26 · 400Long-form body untuk marketing dengan readability lebih tinggi.
--m-lg · 18/28 · 400Lead paragraph
--m-xl · 20/30 · 500Sub-heading
--m-3xl · 40/48 · 600Page headline
--m-display · 72/80 · 600Hero
Mono
--mono-sm · 12/16 · 500const tokens = { primary: '#2563EB' }
--mono-base · 13/20 · 4001.234.567 · 98,5% · IDR 4.500.000

Density & Spacing

Tiga skala density. App default = Compact. Marketing default = Spacious. Token spacing berbasis 4px grid.

Compact · row 36px

NamaNilai
Proyek A12.500
Proyek B8.200
Proyek C3.100

Comfortable · row 44px

NamaNilai
Proyek A12.500
Proyek B8.200
Proyek C3.100

Spacious · row 56px

NamaNilai
Proyek A12.500
Proyek B8.200
Proyek C3.100
Spacing Scale (base 4px)
TokenValuePemakaian Umum
--space-14pxIcon + text gap
--space-28pxTight inline gap
--space-312pxCard padding (compact)
--space-416pxCard padding (comfortable)
--space-624pxSection gap
--space-832pxPage padding desktop
--space-1248pxMarketing section gap
--space-1664pxMarketing section padding

Radius & Shadow

Skala penuh + hierarki per elemen. Radius bukan selera per halaman — ia mengikuti semantik elemen.

Radius Scale
none · 0
xs · 2px
sm · 4px
md · 6px
lg · 8px
xl · 12px
full
Hierarki Pemakaian
ElemenRadiusAlasan
Table, data gridnonePresisi, alignment kolom
Input, button (app)md (6px)Sedikit lembut, tidak playful
Card (app)md (6px)Standar modern app
Card (marketing)lg–xlLebih lembut, editorial
Modallg (8px)Konsisten dengan card
Avatar, badge, pillfullBentuk semantik
Shadow Scale
xs · tooltip
sm · dropdown
md · sticky header
lg · modal
Aturan
  • Card biasa → border hairline, tanpa shadow.
  • Elevation (modal, dropdown) → shadow.
  • Dark mode → pakai lightness (surface lebih terang), bukan shadow.
  • Dilarang → shadow berwarna, shadow ganda, shadow dekoratif.

Opacity & Blend Mode

Opacity masuk design system (primitive + semantic). Blend mode tidak masuk token — hanya pattern guide untuk marketing image treatment.

Primitive Scale
Semantic Opacity
Disabled State · 0.4
Skeleton Loading · 0.6 pulsing
Modal Backdrop · 0.5
Blend Mode — Pattern Guide

✅ Diizinkan (marketing only): overlay untuk duotone image treatment, multiply untuk texture overlay di hero.

❌ Dilarang: difference, exclusion, color-dodge, color-burn. Teks dengan mix-blend-mode.

Rekomendasi: untuk overlay di hero image, pakai background: linear-gradient(rgba(0,0,0,0.5), rgba(0,0,0,0.7)), bukan mix-blend-mode.

Buttons & Actions

Empat varian: primary, secondary, ghost, danger. Radius 6px. Focus ring 2px accent dengan offset 2px.

Varian

States

Ukuran

Aturan: Satu primary button per view/section. Jika lebih dari satu, demote ke secondary. Verb langsung ("Simpan", "Hapus") — bukan "Submit" atau "OK".

Form Inputs

Input text, textarea, select, checkbox, radio, toggle. Label selalu di atas, helper text di bawah, error state inline per field.

Text Input

Akan muncul di sidebar.
Format email tidak valid.

Textarea & Select

Checkbox, Radio, Toggle

Aturan: Setiap field wajib punya label. Placeholder bukan pengganti label. Error message: apa + kenapa + solusi.

Cards & Data

Card dengan hairline only (no shadow). Table dengan row height ikut density. Badge pill untuk status.

Cards
Indosewa.com

Rental sound system & LED. 12 pesanan bulan ini.

Jack OS

Personal hybrid OS. Status: in development.

Jack Force

App factory: social studio, CMS, ops.

Badges
Draft In Review Active Pending Failed
Table
ProyekStatusViewsRevenue
Indosewa.com Active 12.500 4.500.000
Jack OS In Review 8.200 —
Jack Force Draft 3.100 —
Aturan: Jangan nested card. Jika butuh grouping di dalam card, pakai divider hairline. Angka rata kanan dengan tabular-nums.

Feedback & Overlay

Alert, toast, tooltip, modal, empty state, error state, loading. Setiap state harus terdefinisi.

Alert
Berhasil. Data tersimpan.
Perhatian. Kuota API mencapai 80%.
Gagal. Koneksi ke server terputus.
Tooltip

Hover ke elemen ini untuk lihat tooltip. Bisa juga di ikon atau label.

Modal Dialog

Klik untuk demo modal konfirmasi destruktif.

Empty State
📁
Belum ada proyek

Buat proyek pertama untuk memulai.

Loading (Skeleton)

Patterns

Kombinasi komponen yang berulang. Pattern ini yang paling sering di-generate — Jack wajib tahu sebelum ngarang layout baru.

Form Pattern
Struktur: Label di atas → input → helper text di bawah → error state inline per field. Submit button primary di kanan bawah.

Aturan: Setiap field wajib label. Placeholder bukan pengganti. Error message: apa + kenapa + solusi.
Empty State Pattern
Struktur: Ikon (24-32px) → judul (14px 600) → deskripsi 1 kalimat (12px secondary) → CTA.

Aturan: Fungsional, bukan motivasional. ❌ "Yuk mulai petualanganmu!" ✅ "Belum ada proyek. Buat proyek pertama untuk memulai."
Error State Pattern
Untuk fetch gagal: Ikon alert → judul → 1 kalimat penjelasan → tombol "Coba lagi".

Untuk form error: Inline per field. Alert global hanya untuk error sistem.

Dilarang: Stack trace atau error message mentah ke user.
Loading Pattern
Skeleton: Untuk content area (list, card, table row). Shape mengikuti konten.

Spinner: Untuk action button (submit, delete). Durasi minimal 300ms.

Dilarang: Loading spinner di full-page. Pakai skeleton.
Confirmation Dialog Pattern
Destruktif: Tombol danger di kanan ("Hapus"), secondary di kiri ("Batal"). Wajib konfirmasi eksplisit.

Non-destruktif: Tombol primary di kanan ("Simpan").
Page Header Pattern
Struktur: Judul (20-28px 600) → breadcrumb jika nested → action button kanan atas.

Aturan: Maksimal 2 action di header. Sisanya masuk dropdown.

Content & Voice

Tone dan microcopy rules. Ini yang membedakan UI profesional dari AI slop. Wajib dipatuhi.

Tone
App
Direktif, fungsional, zero fluff. Fokus pada apa yang user bisa lakukan sekarang.
Marketing
Persuasif tapi tidak lebay. Cerita, bukan jargon. Fokus pada nilai.
Microcopy Rules
Elemen❌ Salah✅ Benar
ButtonSubmit, OKSimpan, Hapus, Kirim
Error"Error!""Email tidak valid. Periksa format."
Empty state"Yuk mulai petualanganmu!""Belum ada proyek."
Confirmation"Yakin?""Hapus proyek 'Indosewa'? Tidak bisa dibatalkan."
Success"Yeay! Berhasil!!""Berhasil."
Banned Words (App)
Unlock Seamless Revolutionize Elevate Empower Journey Unleash Supercharge Next-level Game-changing Cutting-edge
Capitalization
Semua UI text: sentence case. BUKAN Title Case.

✅ "Simpan perubahan"   ❌ "Simpan Perubahan"
✅ "Buat proyek baru"   ❌ "Buat Proyek Baru"

Heading marketing boleh Title Case HANYA jika brand style guide-nya begitu.
Numbers & Dates
FormatContoh
Ribuan1.234.567
Desimal98,5%
Tanggal singkat11 Nov 2026
Tanggal formal11 November 2026
Waktu14:30 (24-hour)

Accessibility

Checklist wajib. Setiap output harus lolos semua poin ini sebelum dinyatakan selesai.

AspekRequirementTest
Kontras teks≥ 4.5:1 (body), ≥ 3:1 (large ≥18px bold / ≥24px regular)Contrast checker
Kontras UI≥ 3:1 untuk border, ikon, focus ringContrast checker
Focus visibleoutline: 2px solid var(--border-focus); outline-offset: 2px;Tab through
KeyboardSemua interaktif reachable via Tab, urutan logisTab only
ARIAIcon-only button punya aria-label, form punya <label>, toggle punya aria-pressedScreen reader
MotionHormati prefers-reduced-motionOS setting
Target sizeMin 24×24px (WCAG 2.2), ideal 44×44px touchMeasure
Alt textSemua <img> punya alt (kosong jika decorative)Screen reader
Form errorsDiumumkan (role="alert" atau aria-live="polite")Screen reader
Language<html lang="id">Inspect
Focus ring demo: Klik tombol di bawah dan tekan Tab. Focus ring harus 2px accent dengan offset 2px yang jelas.

Do's & Don'ts + Anti-Slop Pre-flight

Checklist terakhir sebelum output AI dinyatakan selesai. Jalankan sebelum "siap".

✅ Do

  • Pakai var(--action-primary), bukan #2563EB.
  • Border hairline 1px untuk card biasa.
  • Sentence case untuk semua label & heading.
  • Verb langsung di button: "Simpan", "Hapus".
  • Focus ring 2px --border-focus, offset 2px.
  • Empty state: ikon + judul + 1 kalimat + CTA.
  • Tabel: row height konsisten, angka rata kanan tabular.
  • Ikon: Lucide, stroke 2px, ukuran 16/20/24 saja.
  • Hierarki via weight (400/500/600) + size.

❌ Don't

  • Gradient ungu-biru atau gradient warna aksi apa pun.
  • Card di dalam card tanpa alasan hierarki.
  • Shadow di card biasa.
  • Copy marketing di UI app ("Unlock", "Seamless").
  • Inter Regular di semua ukuran (tanpa hierarki).
  • Radius random per halaman (4/6/8 campur).
  • Emoji di UI kerja. Exclamation mark ganda.
  • Hero section besar di dalam dashboard.
  • Glassmorphism tanpa alasan fungsional.
Anti-Slop Pre-flight Checklist
Anti-Pattern (DILARANG)
  • Gradient ungu-biru (AI slop signature)
  • Glassmorphism tanpa alasan fungsional
  • Card dengan shadow + border + background color (pilih maksimal 2)
  • Icon berwarna di nav (kecuali semantic feedback)
  • Border di setiap cell tabel (bikin grid look)
  • Multi-line placeholder sebagai pengganti label
  • Tooltip untuk konten panjang (>1 kalimat)
  • Modal tanpa tombol close
  • Toast untuk error kritis (pakai inline atau modal)
  • Loading spinner di full-page (pakai skeleton)
Referensi Visual
StyleKarakter
LinearDark, minimal, keyboard-first, hairline
StripeData-dense, organized, clean typography
VercelGeist-inspired, high contrast, sharp
NotionSpacious, calm, hierarchy via weight
GitHubUtilitarian, dense, hairline-heavy