android-skills 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +130 -2
- package/android-ui-minimal/SKILL.md +98 -0
- package/android-ui-minimal/references/anti-slop-checklist.md +61 -0
- package/android-ui-minimal/references/clarifying-questions.md +55 -0
- package/android-ui-minimal/references/color-and-contrast.md +104 -0
- package/android-ui-minimal/references/compose-patterns.md +120 -0
- package/android-ui-minimal/references/reconstruction-workflow.md +74 -0
- package/android-ui-minimal/references/typography-spacing.md +93 -0
- package/android-ui-minimal/scripts/contrast.py +68 -0
- package/android-ui-minimal/scripts/gen_tokens.py +165 -0
- package/android-ui-minimal/scripts/lint_ui.py +189 -0
- package/android-ui-security-review/SKILL.md +93 -0
- package/android-ui-security-review/references/checklist.md +95 -0
- package/android-ui-security-review/references/components-intents.md +74 -0
- package/android-ui-security-review/references/compose-risks.md +86 -0
- package/android-ui-security-review/references/input-and-state.md +77 -0
- package/android-ui-security-review/references/network-storage.md +87 -0
- package/android-ui-security-review/references/report-template.md +71 -0
- package/android-ui-security-review/references/sensitive-data-ui.md +73 -0
- package/android-ui-security-review/references/webview.md +105 -0
- package/android-ui-security-review/scripts/scan.py +411 -0
- package/bin/android-skills.js +47 -0
- package/install.py +337 -0
- package/opencode/commands/ui-minimal.md +9 -0
- package/opencode/commands/ui-security.md +9 -0
- package/package.json +43 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Mochikun
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,131 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Android Skills
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Paket ini berisi dua skill untuk pekerjaan Android:
|
|
4
|
+
|
|
5
|
+
- `android-ui-minimal` — membangun, merekonstruksi, dan merapikan UI Android.
|
|
6
|
+
- `android-ui-security-review` — meninjau keamanan pada lapisan UI/frontend Android.
|
|
7
|
+
|
|
8
|
+
Didukung untuk berbagai agent AI: **OpenCode** (default), **Claude Code**, **Codex CLI**, **Gemini CLI**, **GitHub Copilot**, **Cursor**, dan **Windsurf**.
|
|
9
|
+
|
|
10
|
+
## Instalasi
|
|
11
|
+
|
|
12
|
+
### Via npm / npx
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
# langsung dari repo (tanpa clone), butuh python3 di mesin
|
|
16
|
+
npx tamvanpr/android-skills --help
|
|
17
|
+
npx tamvanpr/android-skills --target claude --project .
|
|
18
|
+
npx tamvanpr/android-skills --target cursor
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Atau pasang global:
|
|
22
|
+
|
|
23
|
+
```bash
|
|
24
|
+
npm i -g android-skills
|
|
25
|
+
android-skills --target codex --project .
|
|
26
|
+
android-skills --uninstall --target opencode
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
`android-skills` adalah wrapper yang menjalankan `install.py` dengan argumen yang sama; installer tetap butuh `python3` di PATH.
|
|
30
|
+
|
|
31
|
+
### Via git / ZIP
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
git clone https://github.com/tamvanpr/android-skills.git
|
|
35
|
+
cd android-skills
|
|
36
|
+
python3 install.py
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Atau dari ZIP: ekstrak, masuk ke folder `android-skills`, lalu `python3 install.py`.
|
|
40
|
+
|
|
41
|
+
Flag tersedia: `--project DIR`, `--target`, `--link`, `--agents-md`, `--uninstall`, `--validate` (lihat `--help`).
|
|
42
|
+
|
|
43
|
+
## Agent yang didukung
|
|
44
|
+
|
|
45
|
+
| Target | Mekanisme | Lokasi global | Lokasi proyek |
|
|
46
|
+
|---|---|---|---|
|
|
47
|
+
| `opencode` | folder skill + command | `~/.config/opencode/` | `<proyek>/.opencode/` |
|
|
48
|
+
| `claude` | folder skill | `~/.claude/skills/` | `<proyek>/.claude/skills/` |
|
|
49
|
+
| `codex` | instruksi `AGENTS.md` + `<root>/.android-skills/` | `~/.codex/` | `<proyek>/` |
|
|
50
|
+
| `gemini` | instruksi `GEMINI.md` + folder skill | `~/.gemini/` | `<proyek>/` |
|
|
51
|
+
| `copilot` | `.github/copilot-instructions.md` + folder skill | — (proyek saja) | `<proyek>/.github/` |
|
|
52
|
+
| `cursor` | rules `.mdc` di `<root>/rules/` + folder skill | `~/.cursor/` | `<proyek>/.cursor/` |
|
|
53
|
+
| `windsurf` | rules `.md` di `<root>/rules/` + folder skill | `~/.windsurf/` | `<proyek>/.windsurf/` |
|
|
54
|
+
|
|
55
|
+
Untuk target `codex`, `gemini`, dan `copilot`, installer menyalin skill ke folder skill dan menambahkan blok instruksi terkelola (`<!-- android-skills:begin -->`) di file aturan. Blok itu dihapus otomatis oleh `--uninstall`.
|
|
56
|
+
|
|
57
|
+
Untuk `cursor` dan `windsurf`, installer menulis satu file rules per skill (dengan `alwaysApply: false`) plus menyalin folder skill agar referensi dan skrip tetap bisa diakses. Bila rules global tidak terbaca oleh UI agent, tambah lewat panel rules.
|
|
58
|
+
|
|
59
|
+
Pemasangan ulang menimpa versi lama. Untuk memperbarui: `git pull` lalu jalankan `install.py` lagi (tidak perlu jika memakai `--link`). Untuk jalur npm, ulang `npx tamvanpr/android-skills ...` atau `npm i -g` lagi.
|
|
60
|
+
|
|
61
|
+
Di Termux (Android), `python3` dan `git` cukup dipasang lewat `pkg install python git`. Path global tetap `~/.config/opencode`.
|
|
62
|
+
|
|
63
|
+
Setelah dipasang, mulai ulang sesi OpenCode. Jika skill tidak muncul, periksa nama folder, huruf kapital `SKILL.md`, dan permission `skill` pada agent yang dipakai.
|
|
64
|
+
|
|
65
|
+
## Cara memakai di OpenCode
|
|
66
|
+
|
|
67
|
+
Ada tiga cara:
|
|
68
|
+
|
|
69
|
+
1. **Otomatis.** OpenCode menampilkan nama dan deskripsi skill ke agent, lalu agent memuatnya lewat tool `skill` bila permintaan cocok.
|
|
70
|
+
2. **Mention `@`.** Di OpenCode v2, ketik `@android-ui-minimal` atau `@android-ui-security-review` di prompt untuk memuat skill secara manual. Di v1, fitur ini tidak ada; minta saja "muat skill android-ui-minimal".
|
|
71
|
+
3. **Command.** `/ui-minimal <layar>` dan `/ui-security <folder>` adalah shortcut opsional dari folder `opencode/commands`.
|
|
72
|
+
|
|
73
|
+
Contoh:
|
|
74
|
+
|
|
75
|
+
```text
|
|
76
|
+
@android-ui-minimal
|
|
77
|
+
Rombak halaman pengaturan. Pertahankan seluruh fungsi dan state yang ada.
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
```text
|
|
81
|
+
@android-ui-security-review
|
|
82
|
+
Audit keamanan frontend pada app/src/main, variant debug dan release.
|
|
83
|
+
Jangan ubah file; berikan laporan temuan dan false positive.
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
ID skill mengikuti nama folder. Jangan ganti nama folder `android-ui-minimal` dan `android-ui-security-review`.
|
|
87
|
+
|
|
88
|
+
Referensi dan skrip tidak dimuat otomatis. Skill menginstruksikan agent membaca referensi yang relevan dan menjalankan skrip dari folder skill.
|
|
89
|
+
|
|
90
|
+
## Struktur
|
|
91
|
+
|
|
92
|
+
```text
|
|
93
|
+
android-skills/
|
|
94
|
+
├── android-ui-minimal/
|
|
95
|
+
│ ├── SKILL.md
|
|
96
|
+
│ ├── references/
|
|
97
|
+
│ └── scripts/
|
|
98
|
+
├── android-ui-security-review/
|
|
99
|
+
│ ├── SKILL.md
|
|
100
|
+
│ ├── references/
|
|
101
|
+
│ └── scripts/
|
|
102
|
+
├── opencode/
|
|
103
|
+
│ └── commands/
|
|
104
|
+
├── bin/
|
|
105
|
+
│ └── android-skills.js (wrapper npm/npx)
|
|
106
|
+
├── package.json
|
|
107
|
+
├── install.py
|
|
108
|
+
└── README.md
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
Referensi dan skrip tidak dimuat otomatis ketika skill di-mention. Skill menginstruksikan agent untuk membaca referensi yang relevan dan menjalankan skrip yang diperlukan.
|
|
112
|
+
|
|
113
|
+
## Skrip
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
python3 android-ui-minimal/scripts/lint_ui.py app/src/main
|
|
117
|
+
python3 android-ui-minimal/scripts/contrast.py "#5B5D58" "#F7F7F5"
|
|
118
|
+
python3 android-ui-minimal/scripts/gen_tokens.py "#3B5BA9" --package com.example.app
|
|
119
|
+
|
|
120
|
+
python3 android-ui-security-review/scripts/scan.py app --format md --out security-report.md
|
|
121
|
+
python3 android-ui-security-review/scripts/scan.py app --fail-on high
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
Path skrip di atas relatif terhadap folder hasil ekstraksi. Setelah terpasang, jalankan skrip melalui path instalasi skill atau path yang diberikan OpenCode.
|
|
125
|
+
|
|
126
|
+
## Batasan
|
|
127
|
+
|
|
128
|
+
- `scan.py` berbasis pola. Ia tidak melacak aliran data dan dapat menghasilkan false positive atau melewatkan celah.
|
|
129
|
+
- `lint_ui.py` menangkap pelanggaran yang dapat diukur; kualitas visual tetap memerlukan review manusia.
|
|
130
|
+
- Hasil audit bukan jaminan aplikasi aman dan bukan pengganti pentest atau review backend.
|
|
131
|
+
- Rekomendasi API dapat berubah. Verifikasi dokumentasi resmi sesuai versi Android/AndroidX yang dipakai.
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: android-ui-minimal
|
|
3
|
+
description: Membangun, merombak, merekonstruksi, atau memperbaiki UI aplikasi Android native (Kotlin, Jetpack Compose, atau XML Views) dengan desain minimalis, matang, aksesibel, dan konsisten. Gunakan untuk redesign UI/UX, implementasi layar dari screenshot/referensi, audit visual, theming, design token, komponen, layout, typography, dark/light mode, dan responsive UI.
|
|
4
|
+
license: MIT
|
|
5
|
+
compatibility: opencode, Claude Code, dan agent lain yang membaca SKILL.md
|
|
6
|
+
metadata:
|
|
7
|
+
platform: android
|
|
8
|
+
language: kotlin
|
|
9
|
+
version: "1.1.0"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Android UI Minimal
|
|
13
|
+
|
|
14
|
+
Skill ini mengatur cara Claude/opencode merekonstruksi UI Android agar minimalis dan terasa dirancang, bukan di-generate. SKILL.md ini hanya ringkasan aturan dan alur. Detail ada di `references/` dan alat bantu ada di `scripts/`. Baca file referensi yang relevan sebelum menulis kode, jangan mengandalkan ringkasan ini saja.
|
|
15
|
+
|
|
16
|
+
## Alur kerja (ikuti berurutan)
|
|
17
|
+
|
|
18
|
+
1. **Klarifikasi dulu.** Baca `references/clarifying-questions.md`. Jika salah satu syarat "ambigu" terpenuhi, berhenti dan tanyakan. Maksimal 4 pertanyaan, pilihan ganda bila bisa, sertakan default yang kamu rekomendasikan.
|
|
19
|
+
2. **Audit kondisi saat ini.** Cari tema, token, dan komponen yang sudah ada (`Theme.kt`, `Color.kt`, `Type.kt`, `themes.xml`, `colors.xml`). Pakai yang ada. Jangan membuat sistem desain kedua.
|
|
20
|
+
3. **Tentukan token sebelum layar.** Warna, tipografi, spacing, radius ditetapkan di satu tempat. Lihat `references/color-and-contrast.md` dan `references/typography-spacing.md`.
|
|
21
|
+
4. **Bangun layar** dengan pola di `references/compose-patterns.md` (atau padanan XML bila proyek memakai Views).
|
|
22
|
+
5. **Jalankan pemeriksaan otomatis:**
|
|
23
|
+
- `python3 scripts/lint_ui.py <path-proyek>` untuk melacak pelanggaran gaya.
|
|
24
|
+
- `python3 scripts/contrast.py <fg> <bg>` untuk memverifikasi kontras warna.
|
|
25
|
+
6. **Review mandiri** memakai `references/anti-slop-checklist.md`. Perbaiki sebelum melapor selesai.
|
|
26
|
+
7. **Laporkan singkat:** apa yang berubah, token apa yang dipakai, apa yang sengaja tidak dilakukan.
|
|
27
|
+
|
|
28
|
+
## Aturan keras
|
|
29
|
+
|
|
30
|
+
**Emoji dan simbol dekoratif**
|
|
31
|
+
- Jangan memakai emoji di UI, string resource, nama file, komentar, atau pesan commit kecuali user memintanya secara eksplisit.
|
|
32
|
+
- Jangan memakai karakter pengganti ikon (misalnya tanda bintang, panah unicode, centang unicode). Pakai `Icons` Material atau vector drawable.
|
|
33
|
+
- Jangan menambah ikon hanya untuk mengisi ruang. Ikon harus membawa makna atau aksi.
|
|
34
|
+
|
|
35
|
+
**Bertanya, bukan menebak**
|
|
36
|
+
- Jika platform (Compose atau Views), tujuan layar, data nyata, atau arah visual tidak jelas, tanyakan.
|
|
37
|
+
- Jika user menyertakan screenshot, anggap itu acuan struktur. Tanyakan apakah warna dan font ikut dipertahankan atau boleh diganti.
|
|
38
|
+
- Jangan mengarang fitur, teks marketing, atau data dummy yang terlihat nyata. Pakai placeholder netral dan tandai jelas.
|
|
39
|
+
|
|
40
|
+
**Warna**
|
|
41
|
+
- Satu warna aksen. Sisanya netral. Maksimal dua keluarga warna di satu layar, di luar warna status (error, sukses).
|
|
42
|
+
- Semua warna lewat token tema (`MaterialTheme.colorScheme.*` atau atribut tema). Dilarang `Color(0xFF...)` di dalam composable layar.
|
|
43
|
+
- Teks body harus kontras minimal 4.5:1, teks besar dan ikon fungsional minimal 3:1. Verifikasi dengan `scripts/contrast.py`.
|
|
44
|
+
- Wajib menyediakan skema terang dan gelap. Gelap bukan hitam murni `#000000` kecuali layar OLED-first yang diminta user. Terang bukan putih menyilaukan yang dipaksa di semua permukaan.
|
|
45
|
+
- Dilarang gradien dekoratif, glow, dan shadow berlapis kecuali diminta.
|
|
46
|
+
|
|
47
|
+
**Tata letak**
|
|
48
|
+
- Grid spacing 4dp. Nilai yang dipakai: 4, 8, 12, 16, 24, 32, 48. Tidak ada angka acak seperti 13dp atau 27dp.
|
|
49
|
+
- Satu hierarki jelas per layar: satu judul, satu aksi utama.
|
|
50
|
+
- Pisahkan dengan spasi dan tonal surface dulu, baru divider tipis, dan card hanya jika elemen benar-benar berdiri sendiri. Jangan membungkus semuanya dalam card.
|
|
51
|
+
- Target sentuh minimal 48dp. Konten tidak boleh terpotong pada font scale 1.3 dan layar 360dp.
|
|
52
|
+
- Dukung edge-to-edge dan window insets dengan benar.
|
|
53
|
+
|
|
54
|
+
**Tipografi**
|
|
55
|
+
- Maksimal dua weight di satu layar. Pakai skala `MaterialTheme.typography`. Jangan `fontSize = 17.sp` ad hoc.
|
|
56
|
+
- Teks memakai `sp`, jarak memakai `dp`.
|
|
57
|
+
|
|
58
|
+
**Motion**
|
|
59
|
+
- Hanya motion yang menjelaskan perubahan state. Durasi 150-250 ms. Hormati pengaturan "remove animations".
|
|
60
|
+
|
|
61
|
+
**Aksesibilitas**
|
|
62
|
+
- `contentDescription` bermakna untuk ikon aksi, `null` untuk dekoratif.
|
|
63
|
+
- Jangan mengandalkan warna saja untuk menyampaikan status.
|
|
64
|
+
|
|
65
|
+
**Cakupan perubahan**
|
|
66
|
+
- Ubah yang diminta saja. Jangan refactor arsitektur, ganti library, atau memindahkan package kecuali diminta.
|
|
67
|
+
- Jangan menambah dependency baru tanpa bertanya.
|
|
68
|
+
- Jangan menyentuh logika bisnis saat merekonstruksi UI. Pisahkan state dan event dari tampilan (state hoisting).
|
|
69
|
+
|
|
70
|
+
## Tanda "AI slop" yang harus dihindari
|
|
71
|
+
|
|
72
|
+
Gradien ungu-biru, card dengan sudut sangat besar dan bayangan di mana-mana, ikon dalam lingkaran berwarna di setiap baris, judul bergaya marketing ("Selamat datang di pengalaman baru"), empty state dengan ilustrasi emoji, badge dan chip tanpa fungsi, semua tombol berwarna primer, spacing seragam tanpa ritme. Daftar lengkap ada di `references/anti-slop-checklist.md`.
|
|
73
|
+
|
|
74
|
+
## Peta file
|
|
75
|
+
|
|
76
|
+
| File | Isi |
|
|
77
|
+
|---|---|
|
|
78
|
+
| `references/clarifying-questions.md` | Kapan harus bertanya, template pertanyaan |
|
|
79
|
+
| `references/color-and-contrast.md` | Cara memilih palet, contoh palet netral siap pakai, aturan kontras |
|
|
80
|
+
| `references/typography-spacing.md` | Skala tipografi, spacing, radius, elevasi |
|
|
81
|
+
| `references/compose-patterns.md` | Pola kode Compose dan padanan XML |
|
|
82
|
+
| `references/reconstruction-workflow.md` | Cara membaca screenshot atau layar lama lalu merekonstruksinya |
|
|
83
|
+
| `references/anti-slop-checklist.md` | Daftar periksa akhir |
|
|
84
|
+
| `scripts/lint_ui.py` | Linter gaya untuk `.kt` dan `.xml` |
|
|
85
|
+
| `scripts/contrast.py` | Kalkulator kontras WCAG |
|
|
86
|
+
| `scripts/gen_tokens.py` | Pembuat `Color.kt` dan `Theme.kt` dari satu warna aksen |
|
|
87
|
+
|
|
88
|
+
## Menemukan skrip
|
|
89
|
+
|
|
90
|
+
Path `scripts/...` di atas relatif terhadap folder skill ini, bukan folder proyek. Gunakan base directory yang diberikan saat skill dimuat. Jika tidak ada, cari:
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
find ~/.config/opencode .opencode ~/.claude .claude -path '*android-ui-minimal/scripts/lint_ui.py' 2>/dev/null
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
## Batasan skill ini
|
|
97
|
+
|
|
98
|
+
Skill ini hanya soal tampilan dan struktur UI. Untuk celah keamanan pada layar, gunakan skill pendamping `android-ui-security-review`. Skill ini tidak menjamin keputusan desain tunggal yang benar. Jika ada konflik antara aturan di sini dan permintaan eksplisit user, ikuti user dan sebutkan konsekuensinya satu kalimat.
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Checklist anti-slop
|
|
2
|
+
|
|
3
|
+
Jalankan sebelum melapor selesai. Jawab ya atau tidak. Semua "tidak" pada bagian Wajib harus diperbaiki.
|
|
4
|
+
|
|
5
|
+
## Wajib
|
|
6
|
+
|
|
7
|
+
- [ ] Tidak ada emoji di kode, string, komentar, atau nama file
|
|
8
|
+
- [ ] Tidak ada karakter unicode dekoratif sebagai ikon
|
|
9
|
+
- [ ] Satu aksen warna, sisanya netral
|
|
10
|
+
- [ ] Tidak ada gradien dekoratif
|
|
11
|
+
- [ ] Tidak ada `Color(0x...)` di luar berkas tema
|
|
12
|
+
- [ ] Spacing hanya dari skala 4dp
|
|
13
|
+
- [ ] Tipografi hanya dari `MaterialTheme.typography`
|
|
14
|
+
- [ ] Kontras teks minimal 4.5:1, komponen 3:1
|
|
15
|
+
- [ ] Terang dan gelap sama-sama diperiksa
|
|
16
|
+
- [ ] Target sentuh minimal 48dp
|
|
17
|
+
- [ ] Ada state empty, loading, error untuk layar berdata
|
|
18
|
+
- [ ] `contentDescription` benar (bermakna atau null)
|
|
19
|
+
- [ ] Teks UI ada di `strings.xml`, bukan hardcode
|
|
20
|
+
- [ ] Tidak ada dependency baru tanpa persetujuan
|
|
21
|
+
- [ ] Logika bisnis tidak tersentuh
|
|
22
|
+
|
|
23
|
+
## Tanda template AI (hapus atau ganti)
|
|
24
|
+
|
|
25
|
+
| Gejala | Perbaikan |
|
|
26
|
+
|---|---|
|
|
27
|
+
| Header gradien ungu-biru | Warna solid netral |
|
|
28
|
+
| Setiap item dibungkus card dengan bayangan | Baris polos + divider |
|
|
29
|
+
| Ikon dalam lingkaran berwarna di tiap baris | Hapus, atau satu ikon fungsional |
|
|
30
|
+
| Judul bergaya promosi ("Temukan pengalaman baru") | Judul fungsional ("Catatan") |
|
|
31
|
+
| Teks sapaan panjang di halaman utama | Hapus |
|
|
32
|
+
| Empty state dengan ilustrasi besar dan emoji | Satu kalimat + satu aksi |
|
|
33
|
+
| Semua tombol warna primer | Satu utama, sisanya outlined atau teks |
|
|
34
|
+
| Chip dan badge tanpa fungsi | Hapus |
|
|
35
|
+
| Radius 24dp+ di semua elemen | Skala 8/12/16 |
|
|
36
|
+
| Bayangan lembut di semua permukaan | Tonal atau garis tipis |
|
|
37
|
+
| Rata tengah untuk teks panjang | Rata kiri |
|
|
38
|
+
| Data dummy terlihat nyata ("Budi Santoso, 3 jam lalu") | Placeholder netral dan jelas |
|
|
39
|
+
| Animasi masuk di setiap elemen | Hanya transisi state penting |
|
|
40
|
+
| Teks bold di mana-mana | Satu level penekanan |
|
|
41
|
+
| Warna acak per kategori | Satu aksen, bedakan lewat label |
|
|
42
|
+
|
|
43
|
+
## Uji cepat
|
|
44
|
+
|
|
45
|
+
1. **Uji kabur:** kecilkan tangkapan layar atau burem. Apakah satu hal utama tetap menonjol?
|
|
46
|
+
2. **Uji grayscale:** hierarki masih terbaca?
|
|
47
|
+
3. **Uji hapus:** hapus satu elemen. Apakah ada yang hilang fungsinya? Jika tidak, biarkan terhapus.
|
|
48
|
+
4. **Uji font besar:** 1.5x, tidak terpotong atau tumpang tindih?
|
|
49
|
+
5. **Uji layar sempit:** 360dp, tidak ada scroll horizontal?
|
|
50
|
+
6. **Uji konten panjang:** teks dua kali lebih panjang, tata letak bertahan?
|
|
51
|
+
|
|
52
|
+
## Penulisan teks UI
|
|
53
|
+
|
|
54
|
+
- Pendek, jelas, kata kerja untuk aksi ("Simpan", "Hapus").
|
|
55
|
+
- Konsisten satu bahasa per aplikasi, kecuali memang multibahasa lewat resource.
|
|
56
|
+
- Tidak ada tanda seru berlebihan, tidak ada nada promosi.
|
|
57
|
+
- Pesan error menyebut penyebab dan langkah berikutnya.
|
|
58
|
+
|
|
59
|
+
## Pelaporan jujur
|
|
60
|
+
|
|
61
|
+
Jika ada item checklist yang tidak bisa dipenuhi (misalnya tidak bisa menjalankan preview di lingkungan ini), katakan apa adanya. Jangan menulis "sudah diverifikasi" untuk hal yang tidak dijalankan.
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Kapan harus bertanya
|
|
2
|
+
|
|
3
|
+
Bertanya itu wajib, bukan opsional, jika salah satu kondisi di bawah ini benar. Tujuannya mencegah membangun hal yang salah lalu membuang waktu user.
|
|
4
|
+
|
|
5
|
+
## Kondisi pemicu
|
|
6
|
+
|
|
7
|
+
1. **Platform tidak jelas.** Tidak terlihat apakah proyek memakai Jetpack Compose, XML Views, atau campuran. Cek dulu `build.gradle(.kts)` (`buildFeatures { compose = true }`). Jika masih tidak jelas, tanya.
|
|
8
|
+
2. **Tujuan layar tidak jelas.** "Bikin halaman bagus" tanpa tahu fungsinya.
|
|
9
|
+
3. **Acuan visual bertentangan.** Contoh: user minta minimalis tetapi melampirkan screenshot yang padat dan berwarna-warni.
|
|
10
|
+
4. **Data nyata tidak diketahui.** Daftar berisi apa, ada berapa item, panjang teks maksimum, ada gambar atau tidak.
|
|
11
|
+
5. **Ruang lingkup besar.** Permintaan menyentuh lebih dari 3 layar atau mengubah tema global.
|
|
12
|
+
6. **Warna brand ada tapi tidak diberikan.** User menyebut "warna aplikasi saya" tanpa nilai.
|
|
13
|
+
7. **Ada pilihan yang mengubah banyak kode.** Contoh: ganti font, ganti navigasi, ganti pola state.
|
|
14
|
+
8. **Bahasa dan konten.** Teks UI Indonesia atau Inggris, atau keduanya (perlu `strings.xml` terpisah).
|
|
15
|
+
|
|
16
|
+
## Kapan tidak perlu bertanya
|
|
17
|
+
|
|
18
|
+
- Perubahan kecil dan jelas (ubah padding, rapikan satu tombol).
|
|
19
|
+
- Jawabannya bisa dibaca dari kode yang ada. Baca kode dulu sebelum bertanya.
|
|
20
|
+
- Pertanyaan yang jawabannya memiliki default aman. Ambil default, nyatakan di awal laporan, lanjutkan.
|
|
21
|
+
|
|
22
|
+
## Format pertanyaan
|
|
23
|
+
|
|
24
|
+
- Maksimal 4 pertanyaan sekaligus.
|
|
25
|
+
- Satu pertanyaan, satu hal.
|
|
26
|
+
- Beri 2-4 opsi dan tandai rekomendasi.
|
|
27
|
+
- Tulis dalam bahasa yang dipakai user.
|
|
28
|
+
- Jangan bertanya hal yang sudah dijawab user di pesan sebelumnya.
|
|
29
|
+
|
|
30
|
+
## Template
|
|
31
|
+
|
|
32
|
+
```
|
|
33
|
+
Sebelum mulai, ada beberapa hal yang perlu dipastikan:
|
|
34
|
+
|
|
35
|
+
1. Proyek ini pakai Compose atau XML Views?
|
|
36
|
+
a. Compose (Rekomendasi, saya lihat compose = true di build.gradle)
|
|
37
|
+
b. XML Views
|
|
38
|
+
c. Campuran
|
|
39
|
+
|
|
40
|
+
2. Warna aksen yang dipakai?
|
|
41
|
+
a. Pertahankan warna yang sekarang (#xxxxxx)
|
|
42
|
+
b. Saya usulkan satu aksen netral-dingin
|
|
43
|
+
c. Saya kasih kode warna sendiri
|
|
44
|
+
|
|
45
|
+
3. Layar ini menampilkan berapa item biasanya, dan ada gambar?
|
|
46
|
+
(Memengaruhi pilihan list, card, atau baris polos)
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Setelah user menjawab
|
|
50
|
+
|
|
51
|
+
Ringkas keputusan dalam satu blok pendek ("Keputusan: Compose, aksen biru-abu #3B5BA9, daftar baris polos tanpa card"), lalu kerjakan. Jangan bertanya ulang hal yang sama.
|
|
52
|
+
|
|
53
|
+
## Jika user tidak membalas atau sedang tidak bisa dihubungi
|
|
54
|
+
|
|
55
|
+
Ambil asumsi paling konservatif, tulis daftar asumsi di awal laporan, dan buat perubahan mudah diganti (token, bukan nilai tersebar).
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
# Warna dan kontras
|
|
2
|
+
|
|
3
|
+
Tujuan: UI terlihat tenang dan jelas tanpa terlihat "kurang" (pucat, datar, tak berbatas). Rahasianya bukan lebih banyak warna, tetapi tingkat netral yang cukup dan satu aksen yang konsisten.
|
|
4
|
+
|
|
5
|
+
## Struktur palet
|
|
6
|
+
|
|
7
|
+
Satu layar hanya membutuhkan peran-peran ini:
|
|
8
|
+
|
|
9
|
+
| Peran | Fungsi | Material 3 |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| Background | Dasar layar | `background` |
|
|
12
|
+
| Surface | Area konten, bar | `surface` |
|
|
13
|
+
| Surface variant (tonal) | Pemisah halus, field, chip | `surfaceVariant`, `surfaceContainer*` |
|
|
14
|
+
| Outline | Garis tipis | `outlineVariant` |
|
|
15
|
+
| Text primary | Judul, body | `onSurface` |
|
|
16
|
+
| Text secondary | Keterangan | `onSurfaceVariant` |
|
|
17
|
+
| Accent | Aksi utama, state aktif | `primary` / `onPrimary` |
|
|
18
|
+
| Error | Kesalahan | `error` |
|
|
19
|
+
|
|
20
|
+
Kalau semua peran di atas terisi, UI jarang terlihat kurang. Masalah biasanya muncul karena hanya ada dua tingkat (putih dan abu muda), sehingga tidak ada hierarki.
|
|
21
|
+
|
|
22
|
+
## Aturan agar tidak terlihat kurang
|
|
23
|
+
|
|
24
|
+
1. **Minimal 3 tingkat netral** per tema: background, surface, dan surface yang lebih tinggi atau variant. Selisih luminans antar tingkat kira-kira 3 sampai 6 persen.
|
|
25
|
+
2. **Aksen dipakai hemat tapi konsisten**: tombol utama, state terpilih, indikator fokus, link. Jangan dipakai sebagai latar area besar.
|
|
26
|
+
3. **Teks sekunder tetap terbaca.** Jangan menurunkan opasitas teks sampai di bawah 4.5:1. Hindari `alpha = 0.38` untuk teks yang harus dibaca.
|
|
27
|
+
4. **Pemisah ada**, tapi halus: spasi dulu, lalu perubahan tonal, lalu garis 1dp `outlineVariant`.
|
|
28
|
+
5. **Warna status** (error, sukses, peringatan) boleh di luar satu aksen, tapi selalu disertai teks atau ikon, bukan warna saja.
|
|
29
|
+
6. **Mode gelap** didesain sendiri, bukan inversi. Gelap: background sekitar `#0F1114` sampai `#141619`, surface naik bertahap. Aksen dilunakkan (kroma lebih rendah, lebih terang) agar tidak bergetar.
|
|
30
|
+
7. **Tes grayscale.** Ubah tangkapan layar ke hitam-putih. Hierarki harus tetap terbaca.
|
|
31
|
+
|
|
32
|
+
## Cara memilih aksen
|
|
33
|
+
|
|
34
|
+
- Jika user punya warna brand, pakai itu. Turunkan tonal-nya, jangan ubah huenya.
|
|
35
|
+
- Jika tidak ada, pilih satu hue dengan kroma sedang. Hindari ungu-biru neon dan gradien. Pilihan aman: biru baja, hijau teal gelap, terakota, hijau zaitun, indigo gelap.
|
|
36
|
+
- Jangan memakai lebih dari satu hue aksen. Jika butuh pembeda kategori, bedakan dengan bentuk, label, atau ikon.
|
|
37
|
+
- Generate token otomatis: `python3 scripts/gen_tokens.py "#3B5BA9"`.
|
|
38
|
+
|
|
39
|
+
## Palet contoh (netral, siap pakai)
|
|
40
|
+
|
|
41
|
+
Terang:
|
|
42
|
+
|
|
43
|
+
| Token | Hex |
|
|
44
|
+
|---|---|
|
|
45
|
+
| background | `#F7F7F5` |
|
|
46
|
+
| surface | `#FFFFFF` |
|
|
47
|
+
| surfaceVariant | `#EFEFEC` |
|
|
48
|
+
| outlineVariant | `#DADAD5` |
|
|
49
|
+
| onSurface | `#1B1C1A` |
|
|
50
|
+
| onSurfaceVariant | `#5B5D58` |
|
|
51
|
+
| primary | `#3B5BA9` |
|
|
52
|
+
| onPrimary | `#FFFFFF` |
|
|
53
|
+
| error | `#B3261E` |
|
|
54
|
+
|
|
55
|
+
Gelap:
|
|
56
|
+
|
|
57
|
+
| Token | Hex |
|
|
58
|
+
|---|---|
|
|
59
|
+
| background | `#121312` |
|
|
60
|
+
| surface | `#1A1B1A` |
|
|
61
|
+
| surfaceVariant | `#252624` |
|
|
62
|
+
| outlineVariant | `#3A3B38` |
|
|
63
|
+
| onSurface | `#E6E6E2` |
|
|
64
|
+
| onSurfaceVariant | `#A9AAA4` |
|
|
65
|
+
| primary | `#9DB4F0` |
|
|
66
|
+
| onPrimary | `#14224A` |
|
|
67
|
+
| error | `#F2B8B5` |
|
|
68
|
+
|
|
69
|
+
Verifikasi sebelum memakai: `python3 scripts/contrast.py "#5B5D58" "#F7F7F5"`.
|
|
70
|
+
|
|
71
|
+
## Kontras (WCAG 2.2)
|
|
72
|
+
|
|
73
|
+
- Teks normal: minimal 4.5:1.
|
|
74
|
+
- Teks besar (18sp atau 14sp bold) dan komponen UI (border field, ikon aksi): minimal 3:1.
|
|
75
|
+
- State disabled boleh lebih rendah, tapi jangan dipakai untuk info penting.
|
|
76
|
+
- Teks di atas gambar: pakai scrim solid, bukan mengandalkan gambar.
|
|
77
|
+
|
|
78
|
+
## Implementasi Compose
|
|
79
|
+
|
|
80
|
+
```kotlin
|
|
81
|
+
private val LightColors = lightColorScheme(
|
|
82
|
+
primary = Color(0xFF3B5BA9),
|
|
83
|
+
onPrimary = Color(0xFFFFFFFF),
|
|
84
|
+
background = Color(0xFFF7F7F5),
|
|
85
|
+
surface = Color(0xFFFFFFFF),
|
|
86
|
+
surfaceVariant = Color(0xFFEFEFEC),
|
|
87
|
+
outlineVariant = Color(0xFFDADAD5),
|
|
88
|
+
onSurface = Color(0xFF1B1C1A),
|
|
89
|
+
onSurfaceVariant = Color(0xFF5B5D58),
|
|
90
|
+
error = Color(0xFFB3261E),
|
|
91
|
+
)
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
Nilai hex hanya boleh muncul di berkas tema ini. Di layar, pakai `MaterialTheme.colorScheme.primary` dan seterusnya.
|
|
95
|
+
|
|
96
|
+
Dynamic color (Material You): jangan diaktifkan secara default jika user punya warna brand. Jadikan opsi dan tanyakan.
|
|
97
|
+
|
|
98
|
+
## Anti-pola
|
|
99
|
+
|
|
100
|
+
- Putih murni `#FFFFFF` sebagai background utama di mana-mana, ditambah teks hitam murni.
|
|
101
|
+
- Hitam murni `#000000` + teks putih murni (halasi dan melelahkan), kecuali OLED-first.
|
|
102
|
+
- Abu-abu dengan opasitas di atas warna lain (hasil tak terduga). Pakai warna solid dari token.
|
|
103
|
+
- Warna acak per komponen untuk "variasi".
|
|
104
|
+
- Gradien aksen di tombol, header, dan latar.
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
# Pola Compose (dan padanan XML)
|
|
2
|
+
|
|
3
|
+
## Struktur file
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
ui/
|
|
7
|
+
theme/Color.kt Type.kt Theme.kt Spacing.kt
|
|
8
|
+
components/ (komponen kecil yang dipakai ulang)
|
|
9
|
+
screen/<nama>/ <Nama>Screen.kt <Nama>ViewModel.kt <Nama>UiState.kt
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
Aturan: satu composable layar menerima `state` dan `onEvent` (state hoisting). Tidak ada akses repository atau network di dalam composable.
|
|
13
|
+
|
|
14
|
+
## Kerangka layar
|
|
15
|
+
|
|
16
|
+
```kotlin
|
|
17
|
+
@Composable
|
|
18
|
+
fun NotesScreen(
|
|
19
|
+
state: NotesUiState,
|
|
20
|
+
onEvent: (NotesEvent) -> Unit,
|
|
21
|
+
modifier: Modifier = Modifier,
|
|
22
|
+
) {
|
|
23
|
+
Scaffold(
|
|
24
|
+
modifier = modifier,
|
|
25
|
+
topBar = { NotesTopBar(onSearch = { onEvent(NotesEvent.OpenSearch) }) },
|
|
26
|
+
containerColor = MaterialTheme.colorScheme.background,
|
|
27
|
+
) { inner ->
|
|
28
|
+
when (state) {
|
|
29
|
+
NotesUiState.Loading -> LoadingBox(Modifier.padding(inner))
|
|
30
|
+
is NotesUiState.Error -> ErrorBox(state.message, { onEvent(NotesEvent.Retry) }, Modifier.padding(inner))
|
|
31
|
+
is NotesUiState.Content ->
|
|
32
|
+
if (state.items.isEmpty()) EmptyBox("Belum ada catatan", Modifier.padding(inner))
|
|
33
|
+
else NotesList(state.items, { onEvent(NotesEvent.Open(it)) }, Modifier.padding(inner))
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
## Baris list polos (tanpa card)
|
|
40
|
+
|
|
41
|
+
```kotlin
|
|
42
|
+
@Composable
|
|
43
|
+
fun NoteRow(title: String, subtitle: String, onClick: () -> Unit) {
|
|
44
|
+
Column(
|
|
45
|
+
Modifier
|
|
46
|
+
.fillMaxWidth()
|
|
47
|
+
.clickable(onClick = onClick)
|
|
48
|
+
.heightIn(min = 56.dp)
|
|
49
|
+
.padding(horizontal = Space.lg, vertical = Space.md),
|
|
50
|
+
verticalArrangement = Arrangement.spacedBy(Space.xs),
|
|
51
|
+
) {
|
|
52
|
+
Text(title, style = MaterialTheme.typography.titleMedium, maxLines = 1, overflow = TextOverflow.Ellipsis)
|
|
53
|
+
Text(subtitle, style = MaterialTheme.typography.bodyMedium,
|
|
54
|
+
color = MaterialTheme.colorScheme.onSurfaceVariant, maxLines = 2, overflow = TextOverflow.Ellipsis)
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Divider: `HorizontalDivider(color = MaterialTheme.colorScheme.outlineVariant)` dengan inset 16dp.
|
|
60
|
+
|
|
61
|
+
## Tombol
|
|
62
|
+
|
|
63
|
+
- Aksi utama: `Button` (satu per layar).
|
|
64
|
+
- Sekunder: `OutlinedButton` atau `TextButton`.
|
|
65
|
+
- Tinggi minimum 48dp. Lebar penuh hanya untuk aksi utama di form atau bottom bar.
|
|
66
|
+
|
|
67
|
+
## Edge-to-edge dan insets
|
|
68
|
+
|
|
69
|
+
```kotlin
|
|
70
|
+
// Activity
|
|
71
|
+
enableEdgeToEdge()
|
|
72
|
+
// Scaffold sudah memberi inner padding. Untuk konten manual:
|
|
73
|
+
Modifier.windowInsetsPadding(WindowInsets.safeDrawing)
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Gunakan `imePadding()` untuk layar berisi field.
|
|
77
|
+
|
|
78
|
+
## Preview wajib
|
|
79
|
+
|
|
80
|
+
```kotlin
|
|
81
|
+
@Preview(name = "Terang") @Composable private fun P1() = AppTheme(darkTheme = false) { NotesScreen(sampleState, {}) }
|
|
82
|
+
@Preview(name = "Gelap", uiMode = UI_MODE_NIGHT_YES) @Composable private fun P2() = AppTheme(darkTheme = true) { NotesScreen(sampleState, {}) }
|
|
83
|
+
@Preview(name = "Font besar", fontScale = 1.5f) @Composable private fun P3() = AppTheme { NotesScreen(sampleState, {}) }
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
## Aksesibilitas
|
|
87
|
+
|
|
88
|
+
```kotlin
|
|
89
|
+
Icon(Icons.Outlined.Delete, contentDescription = "Hapus catatan")
|
|
90
|
+
Modifier.semantics { heading() } // judul seksi
|
|
91
|
+
Modifier.clearAndSetSemantics { } // dekoratif
|
|
92
|
+
Modifier.minimumInteractiveComponentSize() // target 48dp
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## Performa dasar
|
|
96
|
+
|
|
97
|
+
- `remember` untuk objek mahal, `derivedStateOf` untuk state turunan.
|
|
98
|
+
- Parameter lambda stabil. Hindari membuat objek baru di setiap rekomposisi di dalam list.
|
|
99
|
+
- `LazyColumn(key = { it.id }, contentType = { ... })`.
|
|
100
|
+
- Gambar: Coil dengan ukuran tetap agar tidak melompat.
|
|
101
|
+
|
|
102
|
+
## Padanan XML Views
|
|
103
|
+
|
|
104
|
+
| Compose | XML |
|
|
105
|
+
|---|---|
|
|
106
|
+
| `MaterialTheme.colorScheme.*` | Atribut tema `?attr/colorSurface`, `?attr/colorOnSurface` |
|
|
107
|
+
| `Space.lg` | `@dimen/space_lg` (di `dimens.xml`) |
|
|
108
|
+
| `typography.titleMedium` | `?attr/textAppearanceTitleMedium` |
|
|
109
|
+
| `Scaffold` | `CoordinatorLayout` + `MaterialToolbar` |
|
|
110
|
+
| `LazyColumn` | `RecyclerView` + `ListAdapter` + `DiffUtil` |
|
|
111
|
+
|
|
112
|
+
Jangan menaruh warna hex di layout XML. Definisikan di `colors.xml` dan `values-night/colors.xml`, rujuk lewat atribut tema.
|
|
113
|
+
|
|
114
|
+
## Yang tidak boleh dilakukan
|
|
115
|
+
|
|
116
|
+
- `Color(0xFF...)` di dalam layar.
|
|
117
|
+
- `fontSize = 15.sp` ad hoc.
|
|
118
|
+
- `Modifier.padding(13.dp)` angka di luar skala.
|
|
119
|
+
- Memanggil `viewModel()` di dalam komponen kecil yang dipakai ulang.
|
|
120
|
+
- Menyembunyikan konten penting di balik gestur tanpa alternatif.
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# Alur rekonstruksi UI
|
|
2
|
+
|
|
3
|
+
Dipakai saat user memberi screenshot, layar lama, atau deskripsi dan meminta dibuat ulang lebih bersih.
|
|
4
|
+
|
|
5
|
+
## 1. Inventarisasi
|
|
6
|
+
|
|
7
|
+
Tulis daftar apa yang ada di layar, tanpa menilai:
|
|
8
|
+
- Elemen (judul, daftar, field, tombol, navigasi)
|
|
9
|
+
- Data yang ditampilkan
|
|
10
|
+
- Aksi yang bisa dilakukan
|
|
11
|
+
- State yang terlihat (kosong, loading, error, terpilih)
|
|
12
|
+
|
|
13
|
+
Jika dari screenshot, sebutkan hal yang tidak bisa dipastikan (font, ukuran asli, warna tepat) dan tanyakan jika penting.
|
|
14
|
+
|
|
15
|
+
## 2. Tetapkan hierarki
|
|
16
|
+
|
|
17
|
+
Jawab tiga hal:
|
|
18
|
+
1. Apa satu tujuan utama layar ini?
|
|
19
|
+
2. Apa satu aksi utama?
|
|
20
|
+
3. Apa yang bisa dibuang atau dipindahkan ke layar lain?
|
|
21
|
+
|
|
22
|
+
Elemen yang tidak menjawab tiga pertanyaan itu adalah kandidat dihapus atau diturunkan.
|
|
23
|
+
|
|
24
|
+
## 3. Petakan ke token
|
|
25
|
+
|
|
26
|
+
Ganti setiap nilai acak dengan token:
|
|
27
|
+
- Warna: pilih peran terdekat (`surface`, `onSurfaceVariant`, `primary`).
|
|
28
|
+
- Spacing: bulatkan ke skala 4dp.
|
|
29
|
+
- Tipografi: pilih style terdekat dari skala.
|
|
30
|
+
- Radius: pilih dari tiga level.
|
|
31
|
+
|
|
32
|
+
Catat pemetaan yang mengubah tampilan secara berarti untuk dilaporkan.
|
|
33
|
+
|
|
34
|
+
## 4. Sederhanakan
|
|
35
|
+
|
|
36
|
+
Urutan pemangkasan:
|
|
37
|
+
1. Hapus dekorasi tanpa fungsi (gradien, bayangan berlapis, ikon hiasan).
|
|
38
|
+
2. Gabungkan container bersarang (card dalam card).
|
|
39
|
+
3. Samakan alignment ke satu tepi kiri.
|
|
40
|
+
4. Kurangi jumlah gaya teks.
|
|
41
|
+
5. Kurangi jumlah warna ke satu aksen + netral.
|
|
42
|
+
|
|
43
|
+
## 5. Bangun
|
|
44
|
+
|
|
45
|
+
Ikuti `compose-patterns.md`. Mulai dari state dan event, lalu komposisi, lalu preview.
|
|
46
|
+
|
|
47
|
+
## 6. Verifikasi
|
|
48
|
+
|
|
49
|
+
- Preview terang, gelap, font scale 1.5, lebar 360dp.
|
|
50
|
+
- `python3 scripts/lint_ui.py <path>`.
|
|
51
|
+
- Kontras pasangan warna utama.
|
|
52
|
+
- Checklist di `anti-slop-checklist.md`.
|
|
53
|
+
|
|
54
|
+
## 7. Laporan
|
|
55
|
+
|
|
56
|
+
Format singkat:
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
Selesai: <layar>
|
|
60
|
+
Keputusan: <aksen, struktur daftar, dll>
|
|
61
|
+
Diubah: <file>
|
|
62
|
+
Sengaja tidak dilakukan: <hal yang tidak diubah dan alasannya>
|
|
63
|
+
Perlu konfirmasi: <jika ada>
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
## Menjaga perilaku
|
|
67
|
+
|
|
68
|
+
Rekonstruksi tidak boleh mengubah perilaku. Pertahankan:
|
|
69
|
+
- Nama dan tanda tangan fungsi publik yang dipanggil dari luar layar
|
|
70
|
+
- Navigasi dan argumen route
|
|
71
|
+
- ID untuk test (`testTag`, `android:id`) jika sudah dipakai
|
|
72
|
+
- Teks yang dirujuk test atau localization (ubah lewat `strings.xml`, jangan hardcode)
|
|
73
|
+
|
|
74
|
+
Jika harus mengubahnya, sebutkan secara eksplisit di laporan.
|