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.| Aspek | App (Operasional) | Marketing (Publik) |
|---|---|---|
| Density | Compact | Spacious |
| Body size | 13px | 16px |
| Display max | 28px | 72px |
| Motion | Feedback only | Entrance allowed |
| Voice | Direktif, fungsional | Persuasif, storytelling |
| Hero section | Dilarang | Diperbolehkan |
| Mega menu | Dilarang | Diperbolehkan |
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.
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.
Density & Spacing
Tiga skala density. App default = Compact. Marketing default = Spacious. Token spacing berbasis 4px grid.
Compact · row 36px
| Nama | Nilai |
|---|---|
| Proyek A | 12.500 |
| Proyek B | 8.200 |
| Proyek C | 3.100 |
Comfortable · row 44px
| Nama | Nilai |
|---|---|
| Proyek A | 12.500 |
| Proyek B | 8.200 |
| Proyek C | 3.100 |
Spacious · row 56px
| Nama | Nilai |
|---|---|
| Proyek A | 12.500 |
| Proyek B | 8.200 |
| Proyek C | 3.100 |
| Token | Value | Pemakaian Umum |
|---|---|---|
--space-1 | 4px | Icon + text gap |
--space-2 | 8px | Tight inline gap |
--space-3 | 12px | Card padding (compact) |
--space-4 | 16px | Card padding (comfortable) |
--space-6 | 24px | Section gap |
--space-8 | 32px | Page padding desktop |
--space-12 | 48px | Marketing section gap |
--space-16 | 64px | Marketing section padding |
Radius & Shadow
Skala penuh + hierarki per elemen. Radius bukan selera per halaman — ia mengikuti semantik elemen.
none · 0xs · 2pxsm · 4pxmd · 6pxlg · 8pxxl · 12pxfull| Elemen | Radius | Alasan |
|---|---|---|
| Table, data grid | none | Presisi, alignment kolom |
| Input, button (app) | md (6px) | Sedikit lembut, tidak playful |
| Card (app) | md (6px) | Standar modern app |
| Card (marketing) | lg–xl | Lebih lembut, editorial |
| Modal | lg (8px) | Konsisten dengan card |
| Avatar, badge, pill | full | Bentuk semantik |
xs · tooltipsm · dropdownmd · sticky headerlg · modal- 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.
Disabled State · 0.4
Skeleton Loading · 0.6 pulsing
Modal Backdrop · 0.5
✅ 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.
Form Inputs
Input text, textarea, select, checkbox, radio, toggle. Label selalu di atas, helper text di bawah, error state inline per field.
Text Input
Textarea & Select
Checkbox, Radio, Toggle
Cards & Data
Card dengan hairline only (no shadow). Table dengan row height ikut density. Badge pill untuk status.
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.
| Proyek | Status | Views | Revenue |
|---|---|---|---|
| Indosewa.com | Active | 12.500 | 4.500.000 |
| Jack OS | In Review | 8.200 | — |
| Jack Force | Draft | 3.100 | — |
Feedback & Overlay
Alert, toast, tooltip, modal, empty state, error state, loading. Setiap state harus terdefinisi.
Hover ke elemen ini untuk lihat tooltip. Bisa juga di ikon atau label.
Klik untuk demo modal konfirmasi destruktif.
Belum ada proyek
Buat proyek pertama untuk memulai.
Patterns
Kombinasi komponen yang berulang. Pattern ini yang paling sering di-generate — Jack wajib tahu sebelum ngarang layout baru.
Aturan: Setiap field wajib label. Placeholder bukan pengganti. Error message: apa + kenapa + solusi.
Aturan: Fungsional, bukan motivasional. ❌ "Yuk mulai petualanganmu!" ✅ "Belum ada proyek. Buat proyek pertama untuk memulai."
Untuk form error: Inline per field. Alert global hanya untuk error sistem.
Dilarang: Stack trace atau error message mentah ke user.
Spinner: Untuk action button (submit, delete). Durasi minimal 300ms.
Dilarang: Loading spinner di full-page. Pakai skeleton.
Non-destruktif: Tombol primary di kanan ("Simpan").
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.
App
Direktif, fungsional, zero fluff. Fokus pada apa yang user bisa lakukan sekarang.Marketing
Persuasif tapi tidak lebay. Cerita, bukan jargon. Fokus pada nilai.| Elemen | ❌ Salah | ✅ Benar |
|---|---|---|
| Button | Submit, OK | Simpan, 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." |
✅ "Simpan perubahan" ❌ "Simpan Perubahan"
✅ "Buat proyek baru" ❌ "Buat Proyek Baru"
Heading marketing boleh Title Case HANYA jika brand style guide-nya begitu.
| Format | Contoh |
|---|---|
| Ribuan | 1.234.567 |
| Desimal | 98,5% |
| Tanggal singkat | 11 Nov 2026 |
| Tanggal formal | 11 November 2026 |
| Waktu | 14:30 (24-hour) |
Accessibility
Checklist wajib. Setiap output harus lolos semua poin ini sebelum dinyatakan selesai.
| Aspek | Requirement | Test |
|---|---|---|
| Kontras teks | ≥ 4.5:1 (body), ≥ 3:1 (large ≥18px bold / ≥24px regular) | Contrast checker |
| Kontras UI | ≥ 3:1 untuk border, ikon, focus ring | Contrast checker |
| Focus visible | outline: 2px solid var(--border-focus); outline-offset: 2px; | Tab through |
| Keyboard | Semua interaktif reachable via Tab, urutan logis | Tab only |
| ARIA | Icon-only button punya aria-label, form punya <label>, toggle punya aria-pressed | Screen reader |
| Motion | Hormati prefers-reduced-motion | OS setting |
| Target size | Min 24×24px (WCAG 2.2), ideal 44×44px touch | Measure |
| Alt text | Semua <img> punya alt (kosong jika decorative) | Screen reader |
| Form errors | Diumumkan (role="alert" atau aria-live="polite") | Screen reader |
| Language | <html lang="id"> | Inspect |
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.
- 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)
| Style | Karakter |
|---|---|
| Linear | Dark, minimal, keyboard-first, hairline |
| Stripe | Data-dense, organized, clean typography |
| Vercel | Geist-inspired, high contrast, sharp |
| Notion | Spacious, calm, hierarchy via weight |
| GitHub | Utilitarian, dense, hairline-heavy |