samuelpgt / design system
v1.4 · 15 Nov 2026

Satu standar untuk semua produk samuelpgt

Fun, simple, clean, dan interaktif. Token warna, tipografi, komponen, gerak, dan cara menulis yang sama untuk semua produk. Produk baru tinggal memasang sp.css, memilih warna aksen, lalu fokus ke fiturnya. Standar ini diambil dari HariBahagia, produk pertama yang memakainya.

Cara pakai di produk baru

Pasang satu stylesheet, atur dua atribut di <html>, dan pakai nama class yang sama dengan HariBahagia.

<html lang="id" data-style="joy" data-theme="sage" data-mode="dark">
<link rel="stylesheet" href="https://samuelpgt.com/design-system/sp.css">

<button class="btn btn-primary">Simpan</button>
<div class="card">…</div>
  • Kalau produk punya CSP 'self' di domain lain, salin sp.css ke repo produk dan catat versinya.
  • Warna baru masuk ke token di sp.css lebih dulu. Jangan menulis kode hex langsung di komponen produk.
  • Setiap produk memilih satu aksen (sage, blush, lavender, sky). Mode gelap adalah default; mode terang tetap wajib tersedia lewat data-mode="light".
  • Kredit "oleh samuelpgt" tampil di header layar publik dan footer, memakai .wordmark dan .made-by.

Dua gaya, satu sistem

Komponen dan aturannya sama. Yang berbeda hanya warna, bentuk, dan seberapa banyak sentuhan fun. Pilih lewat data-style di <html>, lalu coba tombol Joy/Focus di kanan atas.

Joy · data-style="joy"

Untuk momen yang dirayakan dan direncanakan bersama, seperti HariBahagia. Gelap lembut, judul serif, sudut membulat, tombol pil, doodle motif, dan pola di app bar. Ini default bila atribut tidak dipasang.

Focus · data-style="focus"

Untuk pekerjaan yang butuh konsentrasi, seperti sistem akunting, dan untuk samuelpgt.com. Hitam pekat, judul sans, label monospace, sudut tegas, tanpa doodle. Pakai aksen Lime untuk tampilan khas samuelpgt.com.

  • Satu produk memakai satu gaya. Jangan mencampur kartu Joy di layar Focus.
  • Kelima warna aksen (data-theme: sage, blush, lavender, sky, lime) berlaku di kedua gaya. Gaya hanya mengubah latar, bentuk, dan hiasan, jadi ganti gaya tidak mengubah warna produk. Di mode terang, Lime otomatis jadi hijau zaitun supaya tetap terbaca.
  • Ragu? Kalau penggunanya bekerja dengan angka, laporan, atau tim, pakai Focus. Kalau penggunanya merayakan atau merencanakan sesuatu yang pribadi, pakai Joy.

Prinsip

Karakter semua produk samuelpgt: fun, simple, clean, dan interaktif. Di gaya Focus, unsur fun cukup lewat interaksi dan bahasa, tanpa doodle.

Fun

Ada sentuhan yang bikin senyum: doodle motif, aksen pastel, angka yang "meletup", dan bahasa yang hangat. Tetap secukupnya, satu sorotan per layar.

Simple

Satu tujuan per layar dan satu tombol utama. Kalimat pendek, langkah sedikit, pilihan yang jelas. Fitur jarang dipakai disimpan di panel, bukan di layar utama.

Clean

Default gelap yang lembut (bukan hitam pekat), ruang lega, garis tipis, sudut membulat. Warna status hanya untuk arti, tanpa emoji dekoratif.

Interaktif

Setiap sentuhan dibalas: tombol mengecil saat ditekan, fokus terlihat jelas, progres bergerak, tema berganti langsung. Semua gerak berhenti bila pengguna memilih kurangi gerak.

Dasarnya tetap: kontras teks minimal 4,5:1, target sentuh 44px, dan layout aman dari 320px sampai desktop.

Merek

Logo samuelpgt hanya tipografi: "samuel" tipis dan "pgt" tebal, memakai font sistem. Tidak ada logo gambar.

samuelpgt

Header layar publik

HariBahagia
oleh samuelpgt

Footer

HariBahagia adalah produk dari samuelpgt

Warna

Semua warna adalah token CSS. Ganti tema atau mode di kanan atas untuk melihat nilainya berubah.

Netral

Aksen tema

Status

Kategori (12 fase)

Tipografi

Judul memakai serif (--font-display), isi memakai font sistem (--font-body). Tanpa web font, jadi tetap cepat dan aman di CSP ketat.

--fs-display 48Rp51 jt
--fs-h1 26Persiapan nikah
--fs-stat 2462 hari lagi
--fs-h2 18Judul kartu
--fs-body 16Teks isi utama dan input formulir.
--fs-item 15Judul baris daftar
--fs-sm 13Keterangan dan meta baris.
--fs-xs 12Label field

Komponen

Nama class sama dengan HariBahagia, jadi pola yang sudah teruji bisa dipindah apa adanya.

Tombol .btn

Tinggi 48px (kecil 44px). Pil di gaya Joy, sudut 6px di Focus. Satu .btn-primary per layar.

Chip

LunasPrioritas tinggiInfoTerlambatBelum bookingSegera hadir

.schip menjelaskan status, .fchip bisa ditekan untuk menyaring. Merah hanya untuk terlambat atau bahaya.

Segmented, input, progres

Harga tidak boleh negatif.

Anggaran terpakai

Rp11,8 jt dari Rp60,9 jt

Paket Pro berakhir: hanya bisa dibaca, data aman.

Baris daftar .item

Satu baris satu tombol. Edit dan hapus ada di panel detail, bukan di baris.

Pola layar

Kerangka aplikasi: app bar 56px dengan pola garis tipis, isi berupa kartu, navigasi bawah di HP dan tab atas mulai 720px.

Samuel & Ledy16 Jan 2027 · 62 hari lagi

Hitung mundur

62 hari

Tugas minggu ini

3 dari 8 selesai

  • Formulir dan detail dibuka di panel: bottom sheet di HP, panel kanan mulai 720px.
  • Doodle motif (cincin, hati, bunga) hanya pada satu kartu utama per layar, tidak pernah menutupi teks atau bar progres.
  • Nominal uang punya tombol sembunyikan di app bar untuk produk yang menampilkan uang.

Gerak

Gerak memberi umpan balik, bukan dekorasi.

  • Muncul sekali saat tampil: rise-in 0,3–0,4 detik, bar progres bar-in, angka pop.
  • Tekan tombol mengecil ke 98%. Tidak ada animasi berulang selain doodle motif yang melayang pelan.
  • Dengan prefers-reduced-motion, semua animasi berhenti dan tampilan langsung di keadaan akhir.

Aksesibilitas

  • Kontras teks minimal 4,5:1 di kedua mode. Teks status memakai token *-text, bukan warna dasarnya.
  • Target sentuh minimal 44×44px. Input 48px dengan font 16px supaya iPhone tidak memperbesar layar.
  • Fokus keyboard: garis 3px warna aksen. Halaman publik punya tautan "Lewati ke konten" dan landmark lengkap.
  • Label selalu terhubung ke input. Pesan error memakai aria-invalid dan aria-describedby.
  • Layout diuji di 320px, 390px, dan 1280px tanpa geser ke samping. Tanpa emoji dekoratif.

QA & data-testid

Setiap produk samuelpgt harus mudah dites otomatis. Elemen penting diberi data-testid yang stabil, jadi test (Playwright, Cypress) tidak rusak hanya karena teks, warna, atau gaya berubah.

Menandai semua elemen ber-testid di halaman ini, lengkap dengan namanya.

Format nama

  • {area}-{elemen}-{jenis}, huruf kecil, kebab-case, bahasa Inggris. Contoh: vendor-save-button, login-email-input, nav-tab-budget.
  • Akhiran jenis: -button, -input, -select, -link, -tab, -row, -chip, -sheet, -dialog, -toast, -error, -value, -progress.
  • Elemen berulang memakai ID data, bukan urutan: vendor-row-101, bukan vendor-row-2.
  • Status atau varian tidak masuk nama. Pakai atribut yang sudah ada, misalnya aria-pressed, aria-invalid, atau data-state="paid".

Wajib dipasang pada

  • Tombol aksi (simpan, hapus, kirim, bayar) dan tombol di app bar.
  • Semua input, select, dan pesan error-nya.
  • Tab navigasi, segmented, dan chip filter.
  • Baris daftar, panel detail (sheet), dialog konfirmasi, dan toast.
  • Angka yang diverifikasi test: total, sisa bayar, hitung mundur, jumlah tamu.
Lakukan

Nama stabil yang menjelaskan fungsi, bukan tampilan.

Tetap dipasang di produksi supaya smoke test live bisa jalan.

Tulis testid bersamaan dengan komponennya, bukan belakangan.

Hindari

Teks UI atau warna di nama (green-button, simpan-btn).

Data pribadi di nama (email, nama tamu, nomor HP).

Memakai testid untuk styling CSS.

Urutan selector di test

  • Utamakan peran dan nama aksesibel: getByRole('button', { name: 'Simpan' }), getByLabel('Nama vendor').
  • Pakai getByTestId bila elemen tidak punya nama unik, berada di daftar dinamis, atau teksnya sering diganti.
  • Jangan memakai class CSS atau struktur DOM sebagai selector.
await page.getByTestId('vendor-name-input').fill('Hotel Candi');
await page.getByTestId('vendor-save-button').click();
await expect(page.getByTestId('vendor-row-101')).toContainText('Hotel Candi');
await expect(page.getByTestId('vendor-price-error')).toBeHidden();

Bahasa

Menulis seperti orang yang membantu teman, bukan seperti mesin atau dokumen resmi.

Lakukan

Kalimat pendek, satu ide per kalimat.

Mulai dengan kata kerja: "Simpan", "Undang", "Pantau".

Sapa pengguna dengan "kamu" di aplikasi.

Jelaskan akibat dan langkah berikutnya saat error.

Hindari

Kata kaku: "dilakukan", "memproses", "silakan melakukan".

Tanda pisah panjang dan tiga titik untuk gaya.

Janji yang belum pasti: "selamanya", "pasti", "100%".

Istilah teknis tanpa penjelasan dan emoji dekoratif.

SebelumSesudah
Memproses…Sebentar…
Pembelian dilakukan setelah masuk, dari menu Setelan → Paket.Pembeliannya setelah masuk, di Setelan → Paket.
Bukan langganan otomatis.Tanpa perpanjangan otomatis.
Pertanyaan tentang HariBahagia? Hubungi kami:Kirim pertanyaan lewat email atau WhatsApp. Kami bantu jawab.
Penanggung jawabDikerjakan oleh
  • Angka uang: Rp2.000.000 di detail, ringkas Rp11,8 jt di ringkasan.
  • Tanggal: 16 Jan 2027. Hitung mundur: 62 hari lagi.
  • Undangan untuk tamu memakai bahasa sopan ("Bapak/Ibu/Saudara/i"), bukan "kamu".