# DESIGN.md — Design System & Aturan UI Wajib `ipnu.dev`

> **STATUS: WAJIB (MANDATORY).**
> Semua halaman, komponen, dan fitur baru di proyek `ipnu.dev` **harus** mengikuti
> token, ukuran, dan pola komponen pada dokumen ini. Dilarang menambah warna,
> font, radius, atau skala tipografi baru tanpa memperbarui dokumen ini terlebih dahulu.
>
> Sumber acuan: desain "Ipnu Hub" (header pill + footer + kartu minimalis glass,
> tipografi rapat/compact, aksen rose). Dokumen ini adalah hasil ekstraksi token
> dari desain tersebut agar konsisten ke depan.

---

## 1. Ringkasan Karakter Desain

- **Gaya:** minimalis modern, "clean fintech", banyak whitespace, glassmorphism tipis.
- **Kesan:** rapi, compact, premium, tenang. Ukuran teks kecil dan rapat (padat informasi).
- **Warna netral dominan** (scale `brand`/zinc) + **satu aksen kuat** (`accent` rose).
- **Sudut membulat:** pill untuk navigasi/tombol ikon, `rounded-xl`/`2xl` untuk kartu.
- **Motion halus:** float, pulse lembut, reveal saat scroll, laser scan pada QR aktif.
- **Dark mode kelas-based** (`.dark` pada `<html>`), bukan media query.

---

## 2. Stack & Konvensi Teknis

| Aspek | Ketentuan |
|---|---|
| Backend | Laravel (PHP 8.3) |
| Styling | **Tailwind CSS v4** (config berbasis CSS `@theme`), dark mode via varian `.dark` |
| Font | Plus Jakarta Sans (sans) + JetBrains Mono (mono) via **Bunny Fonts** (plugin `laravel-vite-plugin/fonts`), **hanya format woff2** |
| Ikon | Lucide (`lucide` / `lucide-blade`) |
| Interaksi ringan | Toast/alert pakai SweetAlert2 **dengan override wajib** (lihat §7) |
| Bahasa UI | Bahasa Indonesia, sapaan ramah, huruf kapital untuk badge/label status |
| Naming | Kelas utilitas Tailwind langsung; komponen berulang dipecah jadi Blade component/partial |

### `resources/css/app.css` (Tailwind v4 — acuan token, WAJIB sama)

```css
@import 'tailwindcss';

/* Sumber konten */
@source '../../resources/**/*.blade.php';
@source '../../storage/framework/views/*.php';

/* Dark mode berbasis kelas .dark (bukan prefers-color-scheme) */
@custom-variant dark (&:where(.dark, .dark *));

@theme {
  /* Font */
  --font-sans: 'Plus Jakarta Sans', -apple-system, sans-serif;
  --font-mono: 'JetBrains Mono', monospace;

  /* Warna netral brand */
  --color-brand-50:  #fafafa;
  --color-brand-100: #f4f4f5;
  --color-brand-200: #e4e4e7;
  --color-brand-300: #d4d4d8;
  --color-brand-400: #a1a1aa;
  --color-brand-500: #71717a;
  --color-brand-600: #52525b;
  --color-brand-700: #3f3f46;
  --color-brand-800: #27272a;
  --color-brand-900: #18181b;
  --color-brand-950: #050505;

  /* Aksen */
  --color-accent: #E11D48;
  --color-accent-soft: rgba(225, 29, 72, 0.08);

  /* Bayangan */
  --shadow-soft: 0 2px 10px rgba(0, 0, 0, 0.03);
  --shadow-floating: 0 8px 30px rgba(0, 0, 0, 0.06);
  --shadow-glow: 0 0 25px rgba(225, 29, 72, 0.18);
  --shadow-glass-inset: inset 0 1px 1px rgba(255, 255, 255, 0.6);
  --shadow-glass-inset-dark: inset 0 1px 1px rgba(255, 255, 255, 0.08);
  --shadow-elegant: 0 4px 20px rgba(0, 0, 0, 0.04);
  --shadow-elegant-dark: 0 4px 20px rgba(0, 0, 0, 0.3);

  /* Animasi */
  --animate-pulse-soft: pulse-soft 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
  --animate-float-sm: float-sm 4s ease-in-out infinite;
  --animate-spin-slow: spin 15s linear infinite;
  --animate-laser: laser-scan 3s ease-in-out infinite;
  --animate-marquee: marquee 28s linear infinite;

  @keyframes float-sm   { 0%, 100% { transform: translateY(0) } 50% { transform: translateY(-4px) } }
  @keyframes pulse-soft { 0%, 100% { opacity: 1 } 50% { opacity: 0.4 } }
  @keyframes laser-scan { 0%, 100% { top: 0% } 50% { top: 100% } }
  @keyframes marquee    { from { transform: translateX(0) } to { transform: translateX(-50%) } }
}
```

> Font Plus Jakarta Sans + JetBrains Mono dimuat via plugin **Bunny Fonts**
> (`laravel-vite-plugin/fonts`) di `vite.config.js` — bukan `<link>` Google Fonts.
>
> **Hanya format `.woff2` yang dikirim ke browser.** Plugin menulis dua rule
> `@font-face` berdeskriptor sama (`.woff2` + `.woff`); rule `.woff` menang di
> cascade sehingga browser mengunduh **keduanya** (14 berkas, ±282 KB). Plugin
> kecil `woff2Only()` di `vite.config.js` membuang rule `.woff` saat build →
> cukup 7 berkas (±101 KB). Bobot font yang dipakai: Plus Jakarta Sans
> `400/500/600/700/800`, JetBrains Mono `500/700` (800 dibuang karena tak
> dipakai di markup). **Menambah bobot font wajib mengubah `weights` di
> `vite.config.js`** — jangan menambah `font-weight` baru tanpa itu.
>
> Gambar: `avatar.jpg` (dipakai navbar 28 px & hero 80–96 px) disimpan
> 320×320 agar cukup untuk layar 2×/3× tanpa membengkakkan unduhan.

> **Catatan versi:** proyek ini memakai Tailwind **v4** (CSS-first). Bila kelak dipindah ke
> Tailwind **v3**, terjemahkan token di atas ke `tailwind.config.js` (`theme.extend`) dengan
> nilai yang **identik**.

---

## 3. Design Tokens

### 3.1 Warna

**Netral `brand` (wajib untuk semua surface & teks netral):**

| Token | Hex | Pemakaian utama |
|---|---|---|
| `brand-50` | `#fafafa` | background body (light), input bg |
| `brand-100` | `#f4f4f5` | chip, hover, readonly input |
| `brand-200` | `#e4e4e7` | border (light) |
| `brand-300` | `#d4d4d8` | border kuat, scrollbar thumb |
| `brand-400` | `#a1a1aa` | teks meta/footer |
| `brand-500` | `#71717a` | teks sekunder |
| `brand-600` | `#52525b` | teks label |
| `brand-700` | `#3f3f46` | teks gelap |
| `brand-800` | `#27272a` | border (dark), surface dark |
| `brand-900` | `#18181b` | teks utama (light), tombol ikon |
| `brand-950` | `#050505` | background body (dark) |

**Aksen:**

| Token | Nilai | Pemakaian |
|---|---|---|
| `accent` | `#E11D48` | CTA, angka nominal, highlight, focus ring |
| `accent` hover | `rose-600` | hover CTA |
| `accent-soft` | `rgba(225,29,72,.08)` | badge background, orb |

**Warna semantik status** (hanya untuk status, jangan untuk dekorasi):
`emerald-500` (sukses/aman/aktif), `amber-500` (peringatan/timer), `rose` / `accent`
(bahaya/hapus), `sky/blue-600` (info/netral teknis), `indigo/teal` (tombol aksi tambahan).

Aturan pemakaian warna:
- Maksimal **1 aksen kuat per layar** (rose). Sisanya netral.
- Warna status selalu berpasangan dengan ikon atau label teks (jangan warna saja).
- Background body: `#fafafa` (light) / `#050505` (dark).

### 3.2 Tipografi (skala "kecil/rapat" — wajib diikuti)

Base body: **`text-[12px] leading-relaxed`**. Semua ukuran di bawah ini adalah standar:

| Peran | Kelas | Ukuran |
|---|---|---|
| Body default | `text-[12px] leading-relaxed` | 12px |
| Judul hero (H1) | `text-2xl md:text-3xl font-black tracking-tight leading-none` | 24→30px |
| Judul halaman/kartu besar | `text-lg font-black tracking-tight` | 18px |
| Judul seksi (H3) di kartu | `text-xs font-black` | 12px |
| Paragraf hero | `text-[11px]` | 11px |
| Label form / subjudul | `text-[10px] font-bold` | 10px |
| Teks tombol kecil | `text-[10.5px]` / `text-[11px]` | ~11px |
| Meta kecil, chip | `text-[9px]` / `text-[8.5px]` | 8.5–9px |
| Meta paling kecil | `text-[8px]` / `text-[7.5px]` | 7.5–8px |
| Badge status | `text-[9px] font-semibold uppercase tracking-wider` | 9px |
| Nominal/angka besar | `text-xl font-black text-accent` (dalam kartu), `text-2xl` di slip | 20→24px |
| Kode / kode integrasi | `text-[9.5px] font-mono` di dalam `<pre>` | 9.5px |
| Footer | `text-[11px] text-brand-400` | 11px |

Bobot font yang dipakai: `font-medium (500)`, `font-semibold (600)`, `font-bold (700)`,
`font-extrabold (800)`, `font-black (900)`. Judul dan label selalu ≥700.
`tracking-tight` untuk judul besar, `tracking-wider`/`widest` untuk badge uppercase.

### 3.3 Radius

| Kelas | Nilai | Pemakaian |
|---|---|---|
| `rounded-full` | pill | Navbar, tombol ikon, badge, dot, avatar |
| `rounded-2xl` | 16px | Kartu utama, slip, modal |
| `rounded-xl` | 12px | Kartu seksi, panel |
| `rounded-lg` | 8px | Tombol, input, dropdown, item |
| `rounded-md` | 6px | Badge kecil |
| `rounded` | 4px | Chip preset |

### 3.4 Bayangan

Gunakan **hanya** token bayangan ini (jangan bikin shadow inline):
`shadow-soft` (kartu diam), `shadow-floating` (kartu mengambang/modal),
`shadow-glow` (CTA aksen), `shadow-elegant` / `shadow-elegant-dark` (navbar),
`shadow-glass-inset` / `shadow-glass-inset-dark` (kilau dalam kaca).

### 3.5 Blur & Glass

- Backdrop blur navbar: `backdrop-blur-2xl`.
- Kartu: `backdrop-blur` 16–24px.
- Orb latar: `blur-[50px]`–`blur-[70px]`.

### 3.6 Spacing & Ritme

- Padding konten halaman: `px-4`.
- Jarak antar kartu/seksi: `gap-4` (grid) / `space-y-3`~`space-y-4`.
- Padding dalam kartu: `p-4` (utama) / `p-3` (rapat) / `p-5` (modal/slip besar).
- Jarak elemen dalam form: `space-y-3`.
- Gap kecil elemen: `gap-1`, `gap-1.5`, `gap-2`.

---

## 4. Layout, Grid & Breakpoint

- **Shell aplikasi (`.app-container`):**
  `max-w-[440px] md:max-w-3xl lg:max-w-5xl xl:max-w-6xl mx-auto`, `pb-16`, `overflow-x-hidden`.
  → Mobile-first "app shell" (440px), melebar di md/lg/xl.
- **Grid dua kolom (desktop):** `grid grid-cols-1 lg:grid-cols-12 gap-4`
  dengan pembagian `lg:col-span-5` (form/kiri) + `lg:col-span-7` (output/kanan).
- **Grid kartu dalam:** `grid grid-cols-1 sm:grid-cols-12 gap-4`.
- **Breakpoint yang dipakai:** `sm: 640`, `md: 768`, `lg: 1024`, `xl: 1280`.
- **Latar grid titik** (opsional dekoratif): `.bg-grid-light` (radial dot 20px),
  ditutup gradasi `from-transparent to-[#fafafa] dark:to-[#050505]`.

---

## 5. Komponen Wajib

### 5.1 HEADER — Navbar Pill (`.navbar`)

Spesifikasi **wajib** untuk semua halaman publik:

- Pembungkus: `fixed top-0 left-0 right-0 z-50 flex justify-center px-4 pt-3 pb-1`,
  `transition-transform`, `pointer-events-none`.
- Pill dalam: `w-full max-w-[420px] md:max-w-3xl lg:max-w-5xl xl:max-w-6xl`,
  `bg-white/50 dark:bg-[#121214]/50 backdrop-blur-2xl`,
  `border border-brand-200/60 dark:border-white/10`,
  `shadow-elegant dark:shadow-elegant-dark rounded-full px-3 py-1.5`,
  `flex items-center justify-between pointer-events-auto`.
- **Kiri:** avatar `w-7 h-7 rounded-full shadow-sm` — boleh `<img>` (dengan
  `object-cover border border-brand-200 dark:border-brand-700`) **atau** lencana inisial
  gradient (`bg-gradient-to-br from-accent to-rose-600 text-white text-[11px] font-black`)
  bila tidak ada logo,
  lalu kolom: nama brand `text-[12px] font-bold tracking-tight`,
  dan baris status: dot `w-1.5 h-1.5 rounded-full bg-emerald-500 animate-pulse`
  + teks `text-[8px] text-brand-500 font-semibold uppercase tracking-wide`.
- **Kanan:** tombol bulat `w-7 h-7 rounded-full bg-brand-900 dark:bg-white text-white dark:text-brand-900
  flex items-center justify-center shadow-sm hover:scale-105 transition-transform`, ikon `w-3.5 h-3.5`.
  Tombol ikon **wajib** punya `aria-label`.
- **Tengah (opsional, hanya `md:` ke atas):** navigasi tautan anchor
  `hidden md:flex flex-1 items-center justify-center gap-1`, tiap tautan
  `px-2.5 py-1 rounded-full text-[10.5px] font-bold text-brand-500 dark:text-brand-400
  hover:text-brand-900 dark:hover:text-white hover:bg-brand-100/70 dark:hover:bg-brand-900/70`.
  Sembunyikan pada mobile (`hidden md:flex`).
- Konten halaman diberi `pt-20` agar tidak tertutup navbar.
- **Tab bar bawah mobile (`#mobile-tabbar`) — ala iOS:** hanya `< md` (`md:hidden`),
  `fixed inset-x-0 bottom-[calc(env(safe-area-inset-bottom)+0.7rem)] z-[55] flex justify-center px-3
  pointer-events-none`. Wadah mengambang ringkas `pointer-events-auto w-full max-w-[268px] grid
  grid-cols-3 gap-0.5 p-1 rounded-[1.25rem] bg-white/70 dark:bg-[#121214]/70 backdrop-blur-2xl
  border border-brand-200/60 dark:border-white/10 shadow-elegant dark:shadow-elegant-dark`
  (≈268×51 px di layar 390 px). **Tiga tab**, tiap tab
  `.tab-item active-tap flex flex-col items-center justify-center gap-0.5 py-[7px] rounded-[1rem]`
  (ikon `w-4 h-4` + label `text-[9px] font-bold leading-none tracking-tight`; target sentuh ≈85×41 px):
  **Tentang** (`a[data-tab="tentang"][href="#tentang"]`, ikon `circle-user-round`) ·
  **Menu** (`button#nav-toggle`, ikon `layout-grid`, `aria-expanded`, `aria-controls="mobile-nav"`) ·
  **Kontak** (`a[data-tab="kontak"][href="#kontak"]`, ikon `message-circle`).
  Kelas `.tabbar`/`.tab-item` (§7) mengatur transisi & status aktif; **`#nav-toggle` = tab "Menu"**,
  bukan FAB terpisah. Ikon **wajib seragam** dengan bottom sheet untuk tujuan yang sama.
  **Tidak** ada hamburger di dalam pill navbar (agar navbar mobile tetap bersih: brand + tombol tema).
- **Bottom sheet navigasi mobile (`#mobile-nav`):** `nav-drawer fixed inset-0 z-40 md:hidden`
  (`role="dialog"`, `aria-modal`, `aria-hidden`), backdrop `bg-brand-950/50 backdrop-blur-sm`
  (`data-nav-dismiss`) + panel `nav-drawer-panel absolute inset-x-0 bottom-0 max-h-[85vh]
  overflow-y-auto minimal-card rounded-t-[2rem] border-t shadow-floating px-3 pt-2.5
  pb-[calc(env(safe-area-inset-bottom)+1.25rem)]`. Isi panel: handle `w-10 h-1 rounded-full
  bg-brand-300 dark:bg-brand-700`, baris judul **"Semua Menu"** + tombol tutup `x` bulat `w-7 h-7`
  (`data-nav-dismiss`), lalu **daftar tautan 2 kolom** (`grid grid-cols-2 gap-1.5`; tiap tautan
  `flex items-center gap-2.5 px-3 py-2.5 rounded-xl text-[12px] font-bold bg-brand-50/70
  dark:bg-brand-900/50` + ikon `w-4 h-4 text-accent`) — memuat **seluruh 8 seksi**. Kelas
  `.nav-drawer`/`.nav-drawer-panel` (§7) mengatur transisi naik dari bawah; JS `initMobileNav()`
  membuka/menutup (tab Menu, backdrop, tombol tutup, tautan, `Esc`, resize ke `md`), mengunci
  `body.overflow`, menyembunyikan tombol "ke atas", dan menyembunyikan tab bar (`.is-hidden`) selama
  sheet terbuka. **Scroll-spy** `IntersectionObserver` (`rootMargin: '-45% 0px -45% 0px'`) menyorot tab
  Tentang/Kontak sesuai seksi di tengah layar (`.tab-item.is-active`). Z-index sheet (`z-40`) **di bawah**
  pill navbar (`z-50`) dan tab bar (`z-[55]`).

### 5.2 FOOTER

- `pt-8 pb-4 px-4 text-center mt-6 border-t border-brand-200/50 dark:border-brand-800/50 rounded-t-[2rem]`.
- Isi: `max-w-6xl mx-auto flex flex-col items-center gap-3`.
- Baris **navigasi ringkas** (opsional, di atas hak cipta): `<nav>` teks `text-[10.5px] font-bold
  text-brand-500 dark:text-brand-400`, tautan `hover:text-accent` (Beranda, Tentang, Sertifikasi,
  Proyek, Kontak). **Tidak** memuat tombol sosial (sudah ada di hero & seksi kontak).
- Baris bawah: `flex flex-col md:flex-row justify-between items-center gap-2 text-[11px] text-brand-400`.
- Kiri: `© {tahun} Ipnu Alpri Yansyah. Hak cipta dilindungi.`
- Kanan: `Dibuat dengan ❤ (ikon lucide heart text-accent fill-accent animate-pulse) di Bekasi, Indonesia`.
- Footer customer (varian sempit): teks `text-[9.5px] text-brand-400` + ikon shield emerald, rata tengah.

### 5.3 KARTU

| Varian | Kelas inti |
|---|---|
| `minimal-card` (utama) | `minimal-card rounded-xl p-4 shadow-soft border border-brand-200/80 dark:border-brand-800` |
| Kartu besar/slip | `minimal-card rounded-2xl p-3 p-5 shadow-floating border border-brand-200 dark:border-brand-800` |
| Kartu header gelap | `p-5 bg-gradient-to-br from-brand-900 to-brand-950 text-white` |
| Kartu dalam (nested) | `bg-brand-50 dark:bg-brand-900/60 border border-brand-100 dark:border-brand-800/80 rounded-lg p-2~3` |

Judul kartu: ikon lucide `w-4 h-4 text-accent` + teks `text-xs font-black`,
dibungkus `flex items-center gap-1.5 mb-3`.

**Efek angkat saat hover (`.hover:-translate-y-0.5`):** kartu *tampilan* (feature, project, statistik,
sertifikat, skill, tentang, testi) memakai `transition-all duration-300 hover:-translate-y-0.5
hover:shadow-floating` agar terasa hidup. **Jangan** terapkan pada kartu yang berisi form (kontak/FAQ)
supaya tidak mengganggu interaksi pengisian.

### 5.4 TOMBOL

| Varian | Kelas |
|---|---|
| Primer (CTA) | `bg-accent hover:bg-rose-600 text-white font-bold py-2 px-3 rounded-lg text-xs shadow-md hover:shadow-glow active-tap flex items-center justify-center gap-1.5` |
| Sekunder/ghost | `bg-brand-100 dark:bg-brand-900 border border-brand-200 dark:border-brand-800 text-[9.5px] font-bold text-brand-700 dark:text-brand-300 py-1 px-2 rounded-lg active-tap` |
| Ikon bulat | `w-7 h-7 rounded-full bg-brand-900 dark:bg-white flex items-center justify-center active-tap hover:scale-105` |
| Chip preset | `bg-brand-200/40 dark:bg-brand-800/60 border border-brand-200 dark:border-brand-800/80 text-brand-600 dark:text-brand-300 font-extrabold px-1.5 py-0.5 rounded text-[8.5px] active-tap hover:bg-accent/10 hover:text-accent` |
| Sosial/aksi warna | `bg-{emerald|teal|indigo}-600 hover:bg-{...}-700 text-white rounded-lg text-[9.5px] font-bold active-tap` |

Aturan tombol:
- Semua tombol interaktif punya efek tekan: kelas `active-tap` (`:active { scale(.97); opacity(.9) }`).
- Semua tombol ikon-saja wajib `aria-label`.
- Satu CTA primer per tampilan/aksi utama.

### 5.5 INPUT & FORM

- Field: `w-full bg-brand-50 dark:bg-brand-900/60 text-brand-900 dark:text-white
  border border-brand-200 dark:border-brand-800 rounded-lg py-1.5 px-2.5 text-xs font-bold
  focus:outline-none focus:border-accent transition-colors`.
- Prefix (mis. `Rp`): `absolute left-2.5 top-1.5 text-xs font-black text-brand-400`, input `pl-8`.
- Readonly/locked: `bg-brand-100 dark:bg-brand-900/60 cursor-not-allowed` + ikon `lock` kanan.
- Label: `block text-[10px] font-bold text-brand-500 mb-1`.
- Kode/payload: `font-mono text-[8.5px]~[9.5px]`.
- Dropdown custom: menu `absolute left-0 right-0 mt-1 bg-white dark:bg-brand-950 border rounded-lg shadow-floating z-30`, item `px-3 py-2 text-xs font-bold hover:bg-brand-100 dark:hover:bg-brand-900`, tanda pilih ikon `check text-accent`.

### 5.6 BADGE / CHIP / PILL STATUS

- Badge label: `inline-flex items-center gap-1 px-2.5 py-0.5 rounded-md border
  border-brand-200/60 dark:border-brand-800/60 bg-white/80 dark:bg-brand-900/80
  backdrop-blur-md text-[9px] font-semibold uppercase tracking-wider shadow-sm`.
- Badge status hidup (aktif): dot `w-1.5 h-1.5 rounded-full bg-emerald-500 animate-pulse` + teks.
- Badge gelap di header kartu: `bg-white/10 px-2 py-0.5 rounded text-[8.5px] font-black tracking-widest uppercase border border-white/10`.

### 5.7 IKON

- Library: **Lucide**. Ukuran baku: `w-3 h-3` (dalam teks kecil), `w-3.5 h-3.5` (tombol),
  `w-4 h-4` (judul kartu/tombol utama), `w-6 h-6` (ilustrasi upload).
- Ikon aksen selalu diberi `text-accent`; ikon sukses `text-emerald-500`.
- Ikon yang menandakan proses hidup diberi `animate-pulse`.

### 5.8 AKORDEON (FAQ)

- Tombol pemicu: `w-full flex justify-between items-center text-left text-[11px] font-bold py-1`.
- Chevron: `w-3.5 h-3.5 text-accent transition-transform duration-200`.
- Isi: `.faq-answer` (`max-height:0; overflow:hidden; transition:max-height .3s ease-out`),
  aktif → `.faq-active .faq-answer { max-height:500px; padding-top:12px }` + chevron `rotate(180deg)`.
- Hanya satu item terbuka pada satu waktu.

### 5.9 TOAST / ALERT (SweetAlert2 override — wajib)

Semua alert memakai SweetAlert2 dengan override berikut (`customClass: { popup: 'swal-theme-popup' }`):

- Popup: `max-width:310px; border-radius:16px; padding:1.25rem 1rem;`
  light `rgba(255,255,255,.95)`, dark `rgba(20,20,22,.95)`, `backdrop-filter: blur(20px)`,
  border `rgba(0,0,0,.08)` / dark `rgba(255,255,255,.08)`.
- Judul: `13px`, `font-weight:800`, `letter-spacing:-.025em`.
- Isi: `11px`, warna `#71717a` (dark `#a1a1aa`), `line-height:1.5`.
- Tombol konfirmasi: `bg accent`, `10.5px`, `font-weight:700`, `padding:.45rem 1.25rem`,
  `border-radius:8px`, `box-shadow:0 4px 12px rgba(225,29,72,.2)`.
- Toast: `position:'bottom-center'`, `timer:1500–2000`, tanpa tombol.

#### 5.9.1 Implementasi nyata di SPLD (2026-10-20)

Untuk aplikasi SPLD (`resources/css/input.css`), override SweetAlert2 **tidak**
memakai `customClass` (tidak ada perubahan `app.js` selain `toast()`), melainkan
menimpa aturan `.swal2-*` langsung. Beberapa catatan teknis penting:

- Versi SweetAlert2 yang dipakai (11.26) menyuntikkan `:root{--swal2-*}` ke `<head>`
  **saat runtime**, jadi menyetel variabel di `:root` milik `app.css` selalu kalah.
  Nilai tema diset di `.swal2-container.swal2-container` (spesifisitas dinaikkan).
- Nama variabel di versi ini: latar popup `--swal2-background`, warna teks
  `--swal2-color`, border `--swal2-border` (bukan `-border-color`/`-title-color`).
- Tema gelap diikat ke kelas `.dark` aplikasi, **bukan** deteksi
  `prefers-color-scheme` Swal, supaya pilihan tema pengguna selalu dihormati.
- `toast()` di `app.js` memakai mode bawaan Swal: `toast:true, position:'bottom-end'`,
  `timer:1400`, `timerProgressBar:true` — tampil di atas navigasi bawah (mobile).
- Skala: popup 340px / radius 16px / padding rapat; judul 13px·800; isi 11px;
  ikon status 44px dengan warna semantik; tombol 10.5px·700 / min-height 32px /
  radius 8px; konfirmasi bergradasi rose `#E11D48`.

### 5.10 LATAR DEKORATIF (Orb)

- Pembungkus: `fixed top-0 left-0 w-full h-full overflow-hidden pointer-events-none -z-10`.
- Orb: lingkaran `blur-[50px]~[70px]`, `bg-accent-soft` atau `bg-rose-500/5`,
  `mix-blend-multiply dark:mix-blend-lighten`, `animate-float-sm`, `opacity-40~60`.
- Maksimal 2–3 orb, tidak boleh mengganggu konten (`pointer-events-none`, `-z-10`).

### 5.11 KOMPONEN LANDING (tambahan v1.1)

Semua kartu di bawah memakai `minimal-card` + `reveal` (kecuali disebutkan lain).

- **Hero 2 kolom:** `grid grid-cols-1 lg:grid-cols-12 gap-8 items-center`
  (`lg:col-span-6` kiri teks, `lg:col-span-6` kanan mock). H1 `text-2xl md:text-3xl lg:text-4xl`.
- **Trust chip:** `inline-flex items-center gap-1 px-2 py-0.5 rounded-md
  border border-brand-200/60 dark:border-brand-800/60 bg-white/70 dark:bg-brand-900/70
  backdrop-blur-md text-[9px] font-semibold` + ikon `w-2.5 h-2.5 text-accent`.
- **Marquee integrasi:** pembungkus `.marquee overflow-hidden` + `.marquee-track gap-2`;
  isi pill `shrink-0 ... rounded-full border border-brand-200/80 dark:border-brand-800
  text-[10px] font-bold`. Item **wajib diduplikasi 2×** agar loop mulus. Track pause saat hover.
- **Kartu statistik (count-up):** `minimal-card rounded-xl p-4 text-center border shadow-soft`;
  angka `text-xl font-black`, label `text-[9px] uppercase tracking-wider font-bold text-brand-400`.
  Angka dianimasikan via `<span data-count>` (`data-prefix`/`data-suffix` opsional).
- **Tab showcase:** grup `data-tabs`; tombol `data-tab-target="id"` dalam bar
  `inline-flex p-1 rounded-full bg-brand-100 dark:bg-brand-900 border border-brand-200 dark:border-brand-800`;
  panel `data-tab-panel="id"` (aktif: tanpa `hidden`). Tombol aktif: `bg-white dark:bg-brand-800 shadow-sm`.
- **Langkah / timeline:** `minimal-card rounded-xl p-4 relative` + nomor besar dekoratif
  `absolute top-3 right-3 text-2xl font-black text-brand-100 dark:text-brand-800 select-none`.
- **Blok kode / API:** bungkus `minimal-card rounded-2xl p-4`; judul titik jendela
  (`w-2 h-2 rounded-full bg-rose-500/amber-500/emerald-500`); `<pre>` `custom-pre-scroll
  overflow-x-auto bg-brand-50 dark:bg-brand-950/60 border rounded-lg p-3 font-mono text-[9.5px]`.
  Tombol salin memakai `data-copy-target="#id"`.
- **Kartu harga (plan):** `minimal-card rounded-xl p-4 border flex flex-col`; unggulan
  `border-accent/40 shadow-glow` + badge `Populer` (`absolute -top-2 right-3`).
  Harga `text-2xl font-black`; daftar fitur pakai ikon `check text-emerald-500`.
- **Testimoni:** `minimal-card rounded-xl p-4`; ikon `quote text-accent/60`; avatar inisial
  `w-7 h-7 rounded-full bg-gradient-to-br` + rating bintang `star text-amber-500 fill-amber-500`.
- **CTA penutup:** `minimal-card rounded-2xl p-6 sm:p-8 shadow-floating text-center` +
  satu orb `bg-accent-soft blur-[60px]` di sudut (`pointer-events-none`).
- **Progress bar baca:** `fixed top-0 left-0 z-[60] h-0.5 bg-accent` (lebar = % scroll),
  di-set oleh JS `initScrollProgress()`.
- **Tombol kembali ke atas:** `fixed bottom-[calc(env(safe-area-inset-bottom)+4.75rem)] md:bottom-5
  right-5 z-50 w-9 h-9 rounded-full bg-brand-900 dark:bg-white shadow-floating active-tap`,
  muncul setelah `scrollY > 500` (transisi `opacity`/`translate`). Di mobile, posisi disesuaikan
  agar tidak bertumpuk dengan tab bar bawah.

Gunakan Blade component/partial untuk kartu berulang (§10).

### 5.12 KOMPONEN PORTOFOLIO (tambahan v1.2)

Konten situs kini **portofolio Ipnu Alpri Yansyah** (Web Developer). Komponen baru:

- **Hero portofolio (rata tengah):** avatar `w-20 h-20 md:w-24 md:h-24 rounded-full overflow-hidden
  border-2 border-white dark:border-brand-900 shadow-floating`; `<img>` boleh gagal →
  sediakan **fallback inisial** (teks inisial di belakang `<img onerror="this.remove()">`).
  Lencana centang status `absolute -bottom-1 -right-1 w-6 h-6 rounded-full bg-emerald-500 border-2`.
- **Bilah keahlian (skill bar):** baris label + persen, track `h-1.5 rounded-full
  bg-brand-200/70 dark:bg-brand-800/70 overflow-hidden`, isi `data-skill="NN"` (lebar awal `w-0`,
  dianimasikan JS `initSkillBars()`), gradient `from-accent to-rose-500`.
- **Kartu proyek:** `minimal-card rounded-xl p-4 border shadow-soft flex flex-col`
  + header ikon + kategori `text-[8.5px] uppercase tracking-wider text-brand-400`
  + daftar tag chip `text-[8.5px] ... bg-brand-100 dark:bg-brand-900 border rounded`.
- **Timeline pengalaman:** `<ol>` berisi item flex `gap-3`; kolom kiri = lingkaran ikon
  `w-8 h-8 rounded-full bg-accent/10 text-accent` + garis `w-px flex-1 bg-brand-200 dark:bg-brand-800`.
- **Tautan sosial (`<x-social-link>`):** pill seperti trust chip; ikon **brand** (Instagram,
  Facebook, TikTok, WhatsApp) diambil dari komponen **`<x-brand-icon>`** (SVG inline —
  lucide v1 tidak menyediakan ikon brand); platform lain memakai ikon lucide
  (`at-sign`, `mail`, `globe`).
- **Form kontak:** mengikuti gaya input §5.5; submit sementara hanya memicu `toastSuccess()`
  (belum ada backend). `textarea` pakai `resize-none`.

- **Kartu sertifikasi (`<x-cert-card>`):** `minimal-card rounded-xl` + **thumbnail pratinjau**
  (`aspect-[16/9]`, `object-cover object-top`, overlay `zoom-in` saat hover) yang membuka
  **lightbox**; lalu badan `p-4` dengan **logo penerbit** dalam kotak `w-8 h-8 rounded-lg bg-white
  border` (ikon `award` sebagai fallback `<img data-fallback>`), judul, penerbit, chip tahun +
  **ID kredensial** (`font-mono`), dan tautan "Lihat kredensial" (`external-link`). Properti
  opsional `:skills="[...]"` menampilkan chip keahlian; `:image` = pratinjau lokal
  (`public/images/certificates/`), `:embed` = URL iframe dokumen (mis. PDF Google Drive `/preview`).
  Properti `brand` (mis. `google`) menulis `data-issuer` untuk filter.
- **Lightbox gambar bersama (`#cert-lightbox`, `<body>` layout):** dialog `fixed inset-0 z-[100]` +
  backdrop `bg-brand-950/80 backdrop-blur-sm` (`data-cert-dismiss`); panel `minimal-card rounded-2xl
  shadow-floating` berisi header (judul + meta + tombol tutup `x` `aria-label`), stage
  `[data-cert-stage]` (menampilkan `<img>` atau `<iframe>` `embed`), dan footer (petunjuk Esc +
  tautan "Buka sumber resmi"). Dikendalikan `initCertLightbox()` — klik `.cert-preview`, tutup via
  backdrop/tombol/`Esc`, `document.body.style.overflow` dikunci saat terbuka, fokus dikembalikan.
  **Semua gambar sertifikat disimpan lokal** di `public/images/certificates/` (server-render, tanpa
  panggilan ke Coursera saat runtime).
- **Filter penerbit (`.cert-filter-btn`):** baris pill `is-active` (aksen) + logo kecil + `short`
  penerbit + jumlah (`font-mono`); tombol `data-filter="<brand>"` menyaring `.cert-item`
  berdasarkan `data-issuer` (JS `initCertFilter()`), dengan keadaan kosong `#cert-empty`.
  **Selalu ada satu penerbit aktif** (penerbit pertama = default; tombol "Semua" sengaja
  dihilangkan agar seksi tetap ringkas) dan filter diterapkan otomatis saat halaman dimuat.
- **Seksi sertifikasi:** grid `sm:grid-cols-2 lg:grid-cols-4`, dikelompokkan per penerbit; sumber &
  tanggal via `text-[9px] text-brand-400`. Logo penerbit disimpan di `public/images/issuers/`.
  Keahlian ditampilkan di kartu masing-masing sertifikat (properti `:skills`), bukan sebagai cloud.
- **Pencarian sertifikat (`#cert-search` + `#cert-summary`):** input pill `rounded-full` (gaya §5.5, ikon
  `search` di kiri) di atas grid. Mengetik akan mencari **lintas penerbit** (memakai `data-search` pada
  `.cert-item` = judul + penerbit + keahlian, huruf kecil), sekaligus menonaktifkan filter penerbit;
  `#cert-summary` (`aria-live="polite"`) menampilkan jumlah hasil. Menekan pill penerbit mereset pencarian.
  Semua diatur `initCertFilter()`.
- **Seksi testimoni (`#testimoni`, opsional):** hanya dirender bila `config('profile.testimonials')`
  tidak kosong; grid `sm:grid-cols-2 lg:grid-cols-3` berisi `<x-testimonial-card>`. Kosong = seksi
  tersembunyi sepenuhnya (tidak ada testimoni palsu).
- **Aset berbagi & ikon (SEO):** gambar Open Graph `public/images/og-image.jpg` (**1200×630**,
  latar `brand-950` + orb aksen + grid titik, memuat nama, peran, chip keahlian, avatar ber-ring);
  set ikon dari `images/avatar.jpg` → `public/favicon.ico` (16/32/48), `images/icon-192.png`,
  `images/icon-512.png`, `images/apple-touch-icon.png`. Dipakai di `layouts/app.blade.php`
  bersama `<meta name="robots">`, `og:locale`, `twitter:summary_large_image`, dan graf
  JSON-LD `WebSite` + `ProfilePage` + `Person`. Berkas `robots.txt` + `sitemap.xml` di `public/`.

Metadata SEO ada di `layouts/app.blade.php`: `description`, Open Graph, Twitter card,
`canonical`, favicon, dan **JSON-LD `Person`** (`sameAs` = Instagram, Threads, Facebook).

### 5.13 MEDIA "KLIK UNTUK MEMUTAR" (tambahan v1.7)

Dipakai halaman `/sapnawati` untuk pemutar lagu, kartu video TikTok, dan foto
pernikahan. **Aturan inti:** tidak ada permintaan ke pihak ketiga (YouTube/TikTok)
saat halaman dimuat — semua poster/gambar disimpan **lokal** di
`public/images/sapnawati/`, dan iframe pemutar baru dibuat setelah diklik.

- **Kontrak markup (JS `initEmbeds()` di `resources/js/app.js`):**
  pembungkus membawa `data-embed-src` (URL iframe), `data-embed-title`
  (judul iframe — aksesibilitas), opsional `data-embed-class`; tombol
  `[data-embed-play]` memicu pemuatan, dan panggung `[data-embed-stage]`
  (bila tidak ada → pembungkusnya sendiri) diisi iframe
  (`allow="autoplay; encrypted-media; fullscreen; picture-in-picture"`).
  Atribut `data-embed-ready="1"` mencegah pemasangan ganda saat `boot()` jalan lagi.
- **Pemutar lagu (`<x-music-player>`):** `minimal-card rounded-xl p-4` berisi
  sampul `w-12 h-12 rounded-lg` (ikon `music` sebagai fallback), label kecil
  (`text-[8.5px] uppercase tracking-wider`), judul `text-[11px] font-bold`,
  penyanyi `text-[9.5px] text-brand-400`, tombol putar bulat `w-9 h-9
  rounded-full bg-accent hover:bg-rose-600 text-white shadow-md hover:shadow-glow`
  dengan ikon `play` (`fill-white`), catatan `text-[9px]` + tautan
  "Buka di YouTube Music" (`external-link`). Panggung `aspect-video rounded-lg
  bg-brand-950 hidden` — muncul saat diputar. Properti: `cover`, `title`, `artist`,
  `embed`, `url`, `note`, `label`.
- **Kartu video TikTok (`<x-tiktok-video>`):** `minimal-card rounded-xl overflow-hidden`
  + efek angkat §5.3. Poster `aspect-[4/5] object-cover` (menyamakan poster 9:16
  dan 3:4), tombol putar menutupi seluruh poster (`bg-brand-950/30` → `hover:bg-brand-950/15`,
  cakram putih `w-11 h-11 rounded-full bg-white/90 text-brand-900` dengan ikon `play`),
  chip kiri-atas "TikTok" (`<x-brand-icon platform="tiktok">`), chip kanan-bawah
  jumlah tayangan (`bg-brand-950/60 backdrop-blur-md text-[8.5px] font-mono`).
  `figcaption` `px-2.5 py-2`: akun `text-[10px] font-bold`, tanggal + tayangan
  `text-[8.5px] text-brand-400`, tautan keluar bulat `w-6 h-6` (`external-link`,
  wajib `aria-label`). Properti: `poster`, `alt`, `embed`, `url`, `account`,
  `dateLabel`, `plays`. Grid: `grid grid-cols-2 lg:grid-cols-3 gap-3`.
- **Foto besar + lightbox gambar:** `<figure>` `minimal-card rounded-2xl
  overflow-hidden shadow-floating`; pemicunya tombol `data-cert-preview` dengan
  `data-image` / `data-title` / `data-meta` / `data-alt` yang membuka **lightbox
  gambar bersama** `#cert-lightbox` (§5.12, kini labelnya "Pratinjau gambar" dan
  memakai `data-alt` bila ada). Gambar `aspect-[3/2] object-cover` + `group-hover:scale-[1.02]`,
  ikon `zoom-in` di sudut; `figcaption p-4` memuat judul `text-xs font-black`
  (ikon `heart-handshake`) + paragraf `text-[10.5px]` + `<time datetime="…">`
  (ikon `calendar-heart`).
- **Data:** semua isi (lagu, daftar video, foto pernikahan) bersumber dari
  `config/profile.php` (`spouse.music`, `spouse.videos`, `spouse.wedding`);
  sitemap memuat gambar utama halaman, dan JSON-LD menambah `ImageObject`
  (foto pernikahan), `ItemList` berisi `VideoObject` (video TikTok), serta
  `MusicRecording` (lagu) — lihat `App\Support\Schema`.
- Ikon Lucide baru yang didaftarkan: `music`, `audio-lines`, `clapperboard`,
  `heart-handshake`, `calendar-heart`.

---

## 6. Dark Mode

- Toggle kelas `.dark` pada `<html>`; simpan di `localStorage('theme')`.
- Inisialisasi awal sebelum render (hindari flash): cek localStorage → jika tidak ada,
  ikut `prefers-color-scheme`.
- Semua komponen **wajib** punya varian dark. Pemetaan umum:
  - bg `brand-50` → `dark:bg-brand-900/60`
  - bg putih/`white` → `dark:bg-brand-950` atau `dark:bg-brand-900`
  - border `brand-200` → `dark:border-brand-800`
  - teks `brand-900` → `dark:text-white`
  - teks `brand-500` → `dark:text-brand-400`
- Transisi warna body: `transition-colors duration-300`.

---

## 7. Aturan Reusable CSS (kelas kustom wajib)

Kelas-kelas ini di-`@layer components` (atau `<style>`) dan dipakai lintas halaman:

```css
body { background-color:#fafafa; color:#18181b; -webkit-tap-highlight-color:transparent; }
.dark body { background-color:#050505; color:#ededed; }

.app-container { margin:0 auto; min-height:100vh; background-color:#fafafa; position:relative;
  box-shadow:0 0 40px rgba(0,0,0,.02); overflow-x:hidden; }
.dark .app-container { background-color:#050505; box-shadow:0 0 40px rgba(0,0,0,.5); }

.bg-grid-light { background-image:radial-gradient(#d4d4d8 1px, transparent 1px); background-size:20px 20px; }
.dark .bg-grid-light { background-image:radial-gradient(#27272a 1px, transparent 1px); }

.glass { background:rgba(255,255,255,.75); backdrop-filter:blur(16px); -webkit-backdrop-filter:blur(16px);
  border:1px solid rgba(0,0,0,.04); }
.dark .glass { background:rgba(24,24,27,.45); border:1px solid rgba(255,255,255,.06); }

.minimal-card { background:rgba(255,255,255,.85); backdrop-filter:blur(24px); -webkit-backdrop-filter:blur(24px);
  border:1px solid rgba(0,0,0,.04); }
.dark .minimal-card { background:rgba(24,24,27,.60); border:1px solid rgba(255,255,255,.05); }

.active-tap:active { transform:scale(.97); opacity:.9; }

.reveal { opacity:0; transform:translateY(8px); transition:all .6s cubic-bezier(.2,.8,.2,1); }
.reveal.active { opacity:1; transform:translateY(0); }

.custom-pre-scroll::-webkit-scrollbar { display:block; height:5px; }
.custom-pre-scroll::-webkit-scrollbar-thumb { background:#d4d4d8; border-radius:4px; }
.dark .custom-pre-scroll::-webkit-scrollbar-thumb { background:#3f3f46; }

.faq-answer { max-height:0; overflow:hidden; transition:max-height .3s ease-out, padding .3s ease; }
.faq-active .faq-answer { max-height:500px; padding-top:12px; }
.faq-active .faq-chevron { transform:rotate(180deg); }

/* Marquee (integrasi/logo) — item diduplikasi 2x, geser -50% */
.marquee { -webkit-mask-image:linear-gradient(to right,transparent,#000 12%,#000 88%,transparent);
  mask-image:linear-gradient(to right,transparent,#000 12%,#000 88%,transparent); }
.marquee-track { display:flex; width:max-content; animation:marquee 28s linear infinite; }
.marquee:hover .marquee-track { animation-play-state:paused; }
@media (prefers-reduced-motion: reduce) { .marquee-track { animation:none; } }

/* Garis scan QR */
.laser-line { animation:laser-scan 3s ease-in-out infinite; }

/* Filter penerbit (§5.12) */
.cert-filter-btn { display:inline-flex; align-items:center; gap:.375rem; padding:.4rem .7rem;
  border-radius:9999px; border:1px solid var(--color-brand-200); background:rgba(255,255,255,.85);
  color:var(--color-brand-600); font-size:9px; font-weight:700; line-height:1; letter-spacing:.02em;
  transition:all .2s ease; cursor:pointer; }
.dark .cert-filter-btn { border-color:var(--color-brand-800); background:rgba(24,24,27,.6); color:var(--color-brand-300); }
.cert-filter-btn:hover { border-color:var(--color-accent); color:var(--color-accent); }
.cert-filter-btn.is-active { background:var(--color-accent); border-color:var(--color-accent); color:#fff; }
.cert-filter-count { font-family:var(--font-mono); font-size:8px; opacity:.65; }

/* Bottom sheet navigasi mobile (§5.1) */
.nav-drawer { opacity:0; visibility:hidden; transition:opacity .2s ease, visibility .2s ease; }
.nav-drawer.is-open { opacity:1; visibility:visible; }
.nav-drawer-panel { opacity:0; transform:translateY(100%);
  transition:transform .32s cubic-bezier(.2,.8,.2,1), opacity .24s ease; }
.nav-drawer.is-open .nav-drawer-panel { opacity:1; transform:translateY(0); }

/* Tab bar bawah mobile (§5.1) — Tentang | Menu | Kontak */
.tabbar { transition:opacity .3s ease, transform .3s ease, visibility .3s ease; }
.tabbar.is-hidden { opacity:0; visibility:hidden; transform:translateY(.75rem); }
.tab-item { color:var(--color-brand-500); }
.dark .tab-item { color:var(--color-brand-400); }
.tab-item.is-active { color:var(--color-accent); background-color:var(--color-accent-soft); }

@media (prefers-reduced-motion: reduce) {
  .nav-drawer, .nav-drawer-panel, .tabbar { transition:none; }
}

@keyframes marquee { from { transform:translateX(0); } to { transform:translateX(-50%); } }
```

### 7.1 Fallback edge (snapshot statis + Cloudflare Worker)

Kelas khusus untuk situs saat **dilayani dari snapshot Cloudflare Worker**
(server utama mati). Didefinisikan di `resources/css/app.css` (`@layer components`)
dan dibuat **mandiri** (tanpa utilitas Tailwind) agar tidak bergantung pada
kelas yang mungkin tidak ikut terbangun saat snapshot dibuat.

| Kelas | Pemakaian |
|---|---|
| `.snapshot-info` | Pembungkus penanda "server offline" di header (di dalam pill navbar, §5.1). `display:none` secara bawaan; muncul hanya bila `<html>` bertanda `data-snapshot="1"` (lihat `html[data-snapshot="1"] .snapshot-info`). |
| `.snapshot-info-btn` | Tombol ikon-saja `1.75rem` (ikon `cloud-off`) dengan latar `accent-soft`, aksen `accent`, plus **titik perhatian** `::after` (`animate-pulse-soft`) ala notifikasi. Wajib `aria-label="Status situs"` + `aria-expanded`. |
| `.snapshot-info-bubble` | Gelembung (bubble) turun ke bawah seperti pesan chat (`top: calc(100% + .6rem)`, ekor `::before` menghadap ikon), tampil saat `.snapshot-info.is-open`. **Terbuka otomatis** saat snapshot dimuat, dan dapat ditutup pengunjung (tombol ×, klik di luar, atau `Esc`). Ada varian dark. |
| `.snapshot-info-text` / `.snapshot-info-close` | Paragraf isi gelembung, dan tombol tutup `×` (`1.1rem`, ikon `x`) di pojok kanan atasnya. |
| `.fault-page` / `.fault-card` | Kerangka halaman `offline.html` (503): pusat layar + kartu glass (pola `minimal-card`, `shadow-floating`). |
| `.fault-mark` / `.fault-badge` / `.fault-title` / `.fault-text` | Isi halaman 503: penanda "503", badge status, judul, paragraf. |
| `.fault-btn` | Satu CTA primer halaman 503 ("Coba lagi") — gaya tombol primer §5.4. |

**Aturan anti-indeks (penting).** Teks "Maaf, server sedang offline…" **tidak
boleh** ada di HTML: ia disimpan sebagai konstanta JS (`initSnapshotInfo()` di
`resources/js/app.js`) dan baru dimasukkan ke DOM saat gelembung dibuka —
otomatis saat snapshot dimuat, atau saat pengunjung hover/klik. Jadi teks itu
**tidak pernah ada di sumber HTML** dan hanya muncul pada saat gangguan
(snapshot jarang aktif); markup di Blade hanya berisi tombol kosong + gelembung
kosong, dan ditandai `data-nosnippet`. Penanda `data-snapshot="1"` disisipkan
`scripts/snapshot_pages.py` ke tag `<html>` halaman snapshot;
`scripts/snapshot.sh` menolak mengambil origin yang sudah bertanda itu
(cegah snapshot ganda).

`offline.html` dihasilkan `scripts/snapshot_pages.py` dari `<head>` halaman
beranda (aset CSS/JS/font yang sama), lalu **dibersihkan** dari `canonical`,
Open Graph, Twitter, JSON-LD, dan diberi `robots: noindex`. Worker
mengembalikannya dengan status **503 + `Retry-After`**.

**Efek `.reveal`** dijalankan dengan `IntersectionObserver` (`threshold: 0.1`,
`unobserve` setelah tampil).

---

## 8. Aksesibilitas & Kualitas

- Setiap tombol ikon-saja: `aria-label`.
- Kontras teks minimal AA; teks meta `brand-400` hanya untuk info non-kritis.
- Fokus terlihat: `focus:outline-none focus:border-accent` (input) / ring aksen untuk CTA.
- Semua elemen dekoratif: `pointer-events-none` dan `-z-10`.
- Navigasi cepat di mobile: hindari scroll horizontal (`overflow-x-hidden`).
- Animasi menghormati preferensi pengguna (sertakan fallback non-animasi bila perlu).

---

## 9. Do & Don't

**DO**
- Pakai token warna/ukuran dari dokumen ini.
- Pertahankan skala teks kecil & rapat (base 12px).
- Gunakan `active-tap` pada semua elemen yang bisa ditekan.
- Sediakan varian dark untuk setiap komponen.
- Gunakan `minimal-card` untuk permukaan kartu.

**DON'T**
- ❌ Menambah font/keluarga font baru (mis. Inter, Roboto).
- ❌ Memakai warna aksen di luar `accent`/status semantik.
- ❌ Membuat bayangan/radius custom di luar token §3.3–3.4.
- ❌ Memakai ukuran teks > `text-3xl` atau < `text-[7.5px]`.
- ❌ Menaruh lebih dari satu CTA primer dalam satu tampilan.
- ❌ Hardcode warna heksadesimal di markup (pakai token Tailwind).

---

## 10. Struktur File (aktual di proyek ini)

```
resources/
  css/app.css              # @theme (token §3) + @layer base/components (§7) + override Swal
  js/app.js                # Lucide icons, toggleTheme(), reveal, toastSuccess(),
                           # scroll-progress, back-to-top, count-up, FAQ, tabs, copy
  views/
    layouts/app.blade.php  # <html> + init tema + @vite + @fonts + orb + navbar +
                           # progress bar + <main> + footer + tombol ke atas
    partials/
      navbar.blade.php     # Header pill (§5.1) — termasuk nav tengah opsional
      footer.blade.php     # Footer (§5.2)
    components/            # Blade components (§5.11–§5.12)
      section-heading.blade.php
      feature-card.blade.php
      stat-card.blade.php
      faq-item.blade.php
      plan-card.blade.php
      testimonial-card.blade.php
      skill-bar.blade.php
      project-card.blade.php
      timeline-item.blade.php
      social-link.blade.php
      brand-icon.blade.php  # Ikon brand SVG inline (Instagram, Facebook, TikTok, WhatsApp)
      music-player.blade.php    # Pemutar lagu "klik untuk memutar" (§5.13)
      tiktok-video.blade.php    # Kartu video TikTok "klik untuk memutar" (§5.13)
    home.blade.php         # Landing page portofolio (hero, stat, marquee, tentang,
                           # layanan, keahlian, sertifikasi, proyek, pengalaman,
                           # FAQ, kontak)
    sapnawati.blade.php    # Halaman /sapnawati — profil Sapnawati Nurohman (Sapnollbeyy):
                           # kartu profil, pemutar lagu, foto pernikahan, akun resmi,
                           # video TikTok pilihan, statistik, FAQ

app/
  Support/Schema.php       # Pembangun node JSON-LD Person (dipakai lintas halaman)
  Console/Commands/IndexNowSubmit.php  # `php artisan indexnow:submit`

config/
  profile.php              # Data identitas tunggal (nama, social, 18 sertifikasi, testimonials)
  seo.php                  # google_site_verification, indexnow_key

public/
  robots.txt               # Allow + Sitemap
  sitemap.xml              # / (satu halaman)
  358e22b231a13e4aab20358e668fdbef.txt  # Berkas verifikasi IndexNow
  images/
    certificates/          # Pratinjau sertifikat (18)
    issuers/               # Logo penerbit
    sapnawati/             # Foto profil, foto pernikahan, sampul lagu, poster video
      video/               # Poster video TikTok pilihan (dari sampul resmi TikTok)
  files/
    rumahweb-naiklevelseo.pdf      # Dokumen asli (iframe lightbox)

vite.config.js             # input css/js + font Bunny (Plus Jakarta Sans, JetBrains Mono)
```

Aset: `public/images/avatar.jpg` (foto profil, fallback inisial bila gagal dimuat).

Catatan implementasi:
- Font di-inject via direktif Blade **`@fonts`** (framework Vite) — wajib ada di `<head>`.
- Ikon dipakai lewat atribut `data-lucide="nama"`; daftar ikon yang tersedia
  didaftarkan di `resources/js/app.js` (`ICONS`). Ikon brand (mis. `Github`) tidak
  tersedia di paket `lucide` v1.
- Setiap halaman baru: `@extends('layouts.app')` + `@section('content')`.

Komponen yang dipakai berulang **wajib** dijadikan Blade component/partial,
bukan disalin-tempel.

---

## 11. Riwayat

| Versi | Tanggal | Perubahan |
|---|---|---|
| 1.0.0 | 2026-10-15 | Ekstraksi design system awal dari desain "Ipnu Hub" (header pill, footer, kartu glass, tipografi compact, aksen rose). |
| 1.1.0 | 2026-10-15 | Tambahan komponen landing (§5.11): hero 2 kolom, marquee, kartu statistik count-up, tab showcase, timeline langkah, blok kode/API, kartu harga, testimoni, CTA penutup, progress bar baca, tombol ke atas. Nav tengah opsional pada navbar (§5.1). Token animasi `marquee` + kelas `.marquee`/`.laser-line` (§3, §7). Blade components baru. |
| 1.2.0 | 2026-10-15 | Tema diubah menjadi **portofolio Ipnu Alpri Yansyah**. Komponen baru (§5.12): hero portofolio + avatar, bilah keahlian, kartu proyek, timeline pengalaman, tautan sosial (SVG brand), form kontak. Metadata SEO + JSON-LD `Person`. Navbar memakai avatar; footer memuat tautan sosial. |
| 1.3.0 | 2026-10-15 | Seksi sertifikasi diperkaya: **logo penerbit** (`public/images/issuers/`), **filter per penerbit** (`.cert-filter-btn` + `initCertFilter()`), dan **cloud keahlian tersertifikasi**. Sertifikat dikelompokkan per penerbit. `cert-card` menerima `brand` + `logo`. |
| 1.3.1 | 2026-10-15 | Aset & metadata SEO: gambar **Open Graph 1200×630** (`images/og-image.jpg`) + set **favicon/ikon**; `robots`/`og:locale`/`twitter:summary_large_image`; data terstruktur diperluas menjadi graf **`WebSite` + `ProfilePage` + `Person`**; berkas `robots.txt` + `sitemap.xml`; dukungan `GOOGLE_SITE_VERIFICATION` (`config/seo.php`). |
| 1.3.2 | 2026-10-15 | **Halaman `/tentang`** (AboutPage + `Person` + `BreadcrumbList`, konten naratif unik). Filter sertifikasi kini **selalu satu penerbit aktif** (pill "Semua" dihapus agar ringkas, diterapkan otomatis saat muat); **cloud keahlian tersertifikasi dihapus** (keahlian tetap di tiap kartu). Footer: tombol sosial dihapus, diganti navigasi ringkas. **IndexNow** (`public/<key>.txt` + `php artisan indexnow:submit`) & data profil dipindah ke `config/profile.php` + `App\Support\Schema`. |
| 1.3.3 | 2026-10-15 | **Pratinjau sertifikat**: thumbnail pada tiap kartu + **lightbox** `#cert-lightbox` (`initCertLightbox()`), gambar disimpan lokal di `public/images/certificates/` (10 dari Coursera + 1 PDF Rumahweb via iframe Google Drive `/preview`). `cert-card` menerima `image` + `embed`. Ikon `x` + `zoom-in` ditambahkan. |
| 1.3.4 | 2026-10-15 | **7 sertifikat kursus** dari spesialisasi Google Digital Marketing & E-commerce ditambahkan (gambar + keahlian dari halaman verifikasi) → total **18 sertifikat**. `cert-card` menerima `note` (mis. "Kursus dalam spesialisasi …"); tata letak kartu memakai `mt-auto` agar chip tetap rapi. Urutan grup Google: **spesialisasi sebagai induk di paling atas**, lalu 7 kursusnya, baru AI Essentials. PDF Rumahweb kini di-*hosting* lokal di `public/files/` (Drive `/preview` ternyata butuh login → 401). |
| 1.4.0 | 2026-10-15 | **Upgrade UI/UX**: (1) **drawer navigasi mobile** `#mobile-nav` + tombol `#nav-toggle` (`initMobileNav()`, kelas `.nav-drawer`) — celah terbesar di mobile; (2) **efek angkat kartu** `hover:-translate-y-0.5 hover:shadow-floating` konsisten di kartu tampilan (§5.3); (3) **halaman `/cv`** + layout cetak `layouts/print.blade.php` + **PDF siap-unduh** `public/files/cv-ipnu-alpri-yansyah.pdf` (dibuat via Chromium), tombol **Unduh CV** di hero & drawer; (4) **pencarian sertifikat** `#cert-search` lintas penerbit (`data-search`, `#cert-summary`); (5) **seksi testimoni** `#testimoni` yang hanya muncul bila `config('profile.testimonials')` terisi. `config/profile.php` menambah `cv` + `testimonials`; sitemap menambah `/cv`; footer menambah tautan CV. `viewport` diberi `maximum-scale=1, user-scalable=no` (nonaktifkan zoom) atas permintaan. |
| 1.4.1 | 2026-10-15 | **Konsolidasi ke satu halaman (one page)**: halaman terpisah **`/tentang` dihapus** (route, view, entri sitemap, tautan navbar/footer) karena kontennya sudah ada & kini dilebur ke seksi `#tentang` di beranda (ditambah paragraf pendidikan + 18 sertifikasi). Baris aksi drawer: "Profil lengkap" → **"Hubungi Saya"**; tautan footer "Tentang Ipnu Alpri Yansyah" → jangkar `/#tentang`; tautan kartu tentang → `/cv`. `/tentang` kini 404 (sinyal de-index yang benar). |
| 1.4.2 | 2026-10-15 | **Pembersihan + menu mobile baru.** (a) **CV dihapus seluruhnya**: tombol "Unduh CV" (hero & drawer), tautan CV di footer, tautan "Lihat CV lengkap", halaman `/cv` + `layouts/print.blade.php` + `public/files/cv-ipnu-alpri-yansyah.pdf`, entri sitemap, dan kunci `cv` di `config/profile.php`. (b) **GitHub dihapus seluruhnya**: seksi `#github` (statistik kontribusi hardcoded), tombol sosial GitHub (hero & kontak), tautan di bottom sheet, `same_as` di `config/profile.php` (ikut hilang dari JSON-LD `Person`), ikon `GitBranch`/`GitCommit`/`FolderGit2`/`GitPullRequest` di `ICONS`, dan case `github` di `<x-social-link>`. `welcome.blade.php` (bawaan Laravel, tak terpakai, berisi tautan GitHub) juga dihapus. (c) **Menu mobile → tombol mengambang + bottom sheet**: hamburger di pill navbar diganti **FAB** `#nav-toggle` (`fixed bottom-5 right-5 w-11 h-11 rounded-full`, ikon `menu`); drawer menjadi **bottom sheet** (naik dari bawah, `rounded-t-[2rem]`, daftar tautan **2 kolom**, tombol tutup + handle); FAB tersembunyi saat sheet terbuka. Tombol "ke atas" digeser ke `bottom-20 md:bottom-5` agar tidak bertumpuk dengan FAB di mobile. JS: `initMobileNav()` diperbarui (tanpa auto-hide gulir). Bundle JS menyusut ~0,6 kB. |
| 1.4.3 | 2026-10-15 | **Tab bar bawah ala iOS (§5.1).** FAB tunggal diganti **tab bar bawah** `#mobile-tabbar` (`fixed inset-x-0 bottom-[env(safe-area-inset-bottom)+0.75rem] z-[55]`, wadah mengambang `max-w-[360px] grid grid-cols-3 rounded-[1.75rem]` glass) berisi **3 tab**: **Tentang** · **Menu** (`#nav-toggle`, membuka bottom sheet berisi **semua 8 menu**) · **Kontak**. Ditambah **scroll-spy** `IntersectionObserver` (`rootMargin:-45% 0px -45% 0px`) yang menyorot tab sesuai seksi di tengah layar (`.tab-item.is-active`, §7). CTA "Hubungi Saya" di dalam sheet dihapus (sudah terwakili tab Kontak). Tab bar disembunyikan (`.is-hidden`) selama sheet terbuka. Tombol "ke atas" & padding bawah footer menyesuaikan tinggi tab bar + `env(safe-area-inset-bottom)`. |
| 1.4.4 | 2026-10-15 | **Tab bar diperkecil + ikon diganti.** Wadah `max-w-[360px]→[268px]`, padding `p-1.5→p-1`, `gap-1→gap-0.5`, `rounded-[1.75rem]→[1.25rem]`; item `py-2→py-[7px]`, ikon `w-5→w-4`, label `text-[10px]→text-[9px]`; jarak bawah `0.75rem→0.7rem` (bar 360×62 → **268×51 px**, target sentuh tetap ≈85×41 px). Ikon baru yang lebih komunikatif: Tentang `user → circle-user-round`, Menu `menu → layout-grid`, Kontak `send → message-circle` (ikon sheet disamakan agar konsisten). Tombol "ke atas" `5.75rem→4.75rem`; padding bawah footer `5.5rem→4.5rem`. `Menu` & `User` dihapus dari `ICONS` (tak terpakai lagi). |
| 1.4.5 | 2026-10-15 | **Perbaikan performa + aksesibilitas (hasil audit SEO).** (a) **Font hanya `.woff2`:** plugin `woff2Only()` di `vite.config.js` membuang rule `@font-face` `.woff` (yang menang di cascade) → unduhan font **14 berkas/±282 KB → 7 berkas/±101 KB**; bobot JetBrains Mono `800` dibuang karena tak dipakai. Bobot halaman **274 KB → 136 KB**, request **25 → 18**, LCP 868 → 844 ms. (b) `avatar.jpg` 400×400 → **320×320** (28,9 → 14,7 KB). (c) **Aksesibilitas:** tautan **"Lewati ke konten"** (`.sr-only focus:not-sr-only`) + `<main id="konten">`; **`aria-label` unik untuk keempat `<nav>`** — "Navigasi utama" (desktop), "Navigasi bawah" (tab bar), "Semua menu" (bottom sheet), "Navigasi footer" (sebelumnya 3 dari 4 tanpa label). (d) FAQ dipindah ke `config/profile.php` (`faqs`) sebagai **sumber tunggal** untuk akordeon **dan** JSON-LD `FAQPage`. Perubahan structured data & rencana sitelink: lihat `SEO.md`. |
| 1.4.6 | 2026-10-15 | **Tekstur minimal-card:** `.minimal-card` kini memakai pola titik halus (14 px) pada `background-image` + `background-color` (pengganti `background` shorthand) agar semua kartu terasa lebih hidup namun tetap netral. Dark mode divarian. |
| 1.4.7 | 2026-10-16 | **Halaman `/produk` (belum diindeks) + mode "no-SEO".** Halaman baru berisi kartu produk (`<x-product-card>`, pola §5.12) yang datanya bersumber dari `config/products.php`. Karena belum siap tayang di Google, halaman ini **tidak** memakai `@section('title')`/`@section('description')`, tidak ditautkan di navbar/footer, dan tidak ada di `sitemap.xml`. Layout `layouts/app.blade.php` dapat menyalakan mode noindex per-halaman: bila sebuah view mendefinisikan `@section('robots', ...)` maka layout **melewati canonical, Open Graph/Twitter, dan JSON-LD**, serta `googlebot` ikut `noindex, nofollow`. Route `/produk` juga mengirim header `X-Robots-Tag: noindex, nofollow` sebagai lapisan kedua. Tidak ada token/warna baru. |
| 1.4.8 | 2026-10-17 | **Fallback edge (anti-"situs mati").** Snapshot statis seluruh situs dibangun `scripts/snapshot.sh` (4 halaman publik + aset, dari origin produksi) dan di-deploy bersama Cloudflare Worker `ipnu-dev-fallback` (`worker/`), yang mendahului ingress tunnel lewat route `ipnu.dev/*`. Saat origin sehat, respons diteruskan apa adanya; saat origin mati/5xx, Worker menyajikan snapshot (200 + header `X-Snapshot`) atau `offline.html` dengan **503 + `Retry-After`**. Ditambah komponen §7.1 (`.snapshot-notice`, `.fault-*`) dan `scripts/deploy-edge.sh` (dipanggil `scripts/deploy.sh`). Hanya token yang sudah ada — tidak ada warna/font/bayangan baru. |
| 1.4.9 | 2026-10-17 | **Penanda "server offline" ala chat + aman dari mesin pencari.** Banner teks `.snapshot-notice` diganti **ikon `cloud-off`** di pill navbar (§7.1) dengan **gelembung turun** berisi "Maaf, server sedang offline…" (titik perhatian `animate-pulse-soft`). Teks pemberitahuan **tidak ditulis di HTML** — disimpan di `resources/js/app.js` (`initSnapshotInfo()`) dan baru masuk DOM saat hover/klik, supaya tidak dibaca/diindeks crawler; tombol & gelembung diberi `data-nosnippet`. Markup ditandai hanya lewat `<html data-snapshot="1">` yang disisipkan `scripts/snapshot_pages.py`, dan `scripts/snapshot.sh` menolak origin yang sudah bertanda itu. Kelas `.snapshot-notice*` dihapus dari `app.css`; `scripts/uji-simulasi.sh` memverifikasi tanda snapshot + ketiadaan teks di HTML. Token/warna tetap memakai yang ada. |
| 1.4.10 | 2026-10-17 | **Gelembung "server offline" terbuka otomatis.** Saat snapshot dimuat, gelembung langsung terbuka agar pengunjung paham tanpa perlu klik, dan **dapat ditutup** lewat tombol **×** baru (`.snapshot-info-close`, ikon `x`) di pojoknya, klik di luar, atau `Esc` — selain tetap bisa dibuka ulang dari ikon. Isi teks tetap hanya lewat JS (`initSnapshotInfo()`, tidak ada di sumber HTML) dan `role="status"` sehingga langsung diumumkan pembaca layar. Token/warna tidak berubah. |
| 1.5.0 | 2026-10-17 | **Galeri aset 3D AI (§5.13).** Seksi `#model3d` baru di beranda, **tepat di atas portofolio `#proyek`**, menampilkan seluruh berkas `public/models/` (`*.glb`/`*.gltf`, urut terbaru; judul dari nama berkas; sembunyi otomatis bila kosong; tata letak menyesuaikan jumlah). Viewer `<model-viewer>` (`@google/model-viewer` + peer `three`) dimuat **malas** lewat `initModelGallery()` (`import()` saat seksi mendekati viewport) sehingga bundle awal tetap 37 kB; `environment-image="neutral"` agar pencahayaan seragam light/dark, `slot="poster"` untuk status memuat, `camera-controls` + `auto-rotate`. Menambah aset cukup menyalin file ke `public/models/` — tanpa ubah kode. Tidak ada warna/font/token baru. |
| 1.5.1 | 2026-10-17 | **Galeri 3D disembunyikan di mode cadangan (§7.1).** Karena `.glb` tidak ikut snapshot, `html[data-snapshot="1"] #model3d { display:none }` menyembunyikan seksi galeri hanya saat dilayani Cloudflare Worker — mencegah poster "Memuat…" menggantung dan menghemat unduhan chunk saat server mati. |
| 1.5.2 | 2026-10-17 | **Galeri 3D dihapus (atas permintaan).** Seksi `#model3d`, partial `models-grid.blade.php`, fungsi `initModelGallery()`, aturan CSS `#model3d`, pustaka `@google/model-viewer` + `three`, aset `public/models/`, serta dokumentasi §5.13/§7.1 dihapus — tampilan beranda kembali seperti sebelum v1.5.0. Berkas GLB masih tersimpan di riwayat Git (commit `0ecbbb6`) bila suatu saat diperlukan. |
| 1.6.0 | 2026-10-17 | **Halaman `/sapnawati`** (profil Sapnawati Nurohman / Sapnollbeyy) agar pencarian Google menemukan foto & akun resminya. Baris baru: kartu profil (avatar foto TikTok + alias), daftar **3 akun resmi** (foto profil masing-masing akun, jumlah pengikut, tautan langsung), kartu statistik count-up (§5.11), FAQ (§5.8) + `FAQPage`, dan JSON-LD `Person` + `ProfilePage` + `BreadcrumbList`. Aset: `public/images/sapnawati/` (2 foto profil 100×100 diambil dari halaman embed TikTok resmi + gambar **OG 1200×630** gaya §5.12). Komponen baru **`<x-brand-icon>`** (ikon brand SVG inline: Instagram, Facebook, TikTok, WhatsApp) — `<x-social-link>` kini memakainya sehingga path SVG tidak diduplikasi; kasus `tiktok` ditambahkan. **Footer memakai baris navigasi ringkas §5.2** (Beranda · Sertifikasi · Proyek · Kontak · Sapnawati) agar halaman baru tersambung internal. Layout `layouts/app.blade.php` mendukung `og_type` / `og_image` / `og_image_alt` per halaman (bawaan tetap OG beranda). Sitemap + snapshot kini **5 halaman**. Hanya token yang sudah ada — tidak ada warna/font/radius baru. |
| 1.7.0 | 2026-10-17 | **Media di `/sapnawati` (§5.13).** (a) **Pemutar lagu** `<x-music-player>` tepat di bawah kartu profil (lagu "Kita usahakan rumah itu (Alternate Version)" — Sal Priadi, YouTube); (b) **foto pernikahan** 11 Januari 2026 (`<figure>` + **lightbox gambar bersama** `#cert-lightbox`, kini berlabel "Pratinjau gambar" dan menerima `data-alt`); (c) **6 video TikTok pilihan** `<x-tiktok-video>` (grid `grid-cols-2 lg:grid-cols-3`). Semua media memakai pola **"klik untuk memutar"** `initEmbeds()` — iframe YouTube/TikTok baru dimuat setelah ditekan, poster disimpan **lokal** di `public/images/sapnawati/` (URL sampul TikTok bertanda tangan & cepat kedaluwarsa). Data baru di `config/profile.php` (`spouse.music`, `spouse.wedding`, `spouse.videos`) + 2 FAQ; JSON-LD menambah `ImageObject`, `ItemList`+`VideoObject`, `MusicRecording`; sitemap memuat foto pernikahan. Ikon Lucide baru: `music`, `audio-lines`, `clapperboard`, `heart-handshake`, `calendar-heart`. Tidak ada warna/font/radius baru. |

> Setiap perubahan desain **harus** memperbarui dokumen ini dan menaikkan versi di §11.
