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, salinsp.csske repo produk dan catat versinya. - Warna baru masuk ke token di
sp.csslebih 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 lewatdata-mode="light". - Kredit "oleh samuelpgt" tampil di header layar publik dan footer, memakai
.wordmarkdan.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.
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 fieldKomponen
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
.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.
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-in0,3–0,4 detik, bar progresbar-in, angkapop. - 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-invaliddanaria-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.
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, bukanvendor-row-2. - Status atau varian tidak masuk nama. Pakai atribut yang sudah ada, misalnya
aria-pressed,aria-invalid, ataudata-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.
Nama stabil yang menjelaskan fungsi, bukan tampilan.
Tetap dipasang di produksi supaya smoke test live bisa jalan.
Tulis testid bersamaan dengan komponennya, bukan belakangan.
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
getByTestIdbila 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.
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.
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.
| Sebelum | Sesudah |
|---|---|
| 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 jawab | Dikerjakan oleh |
- Angka uang:
Rp2.000.000di detail, ringkasRp11,8 jtdi ringkasan. - Tanggal:
16 Jan 2027. Hitung mundur:62 hari lagi. - Undangan untuk tamu memakai bahasa sopan ("Bapak/Ibu/Saudara/i"), bukan "kamu".