👋 Selamat Datang di Keluarga Duitnya!

Anda tidak perlu mengerti pemrograman sama sekali. Panduan ini dirancang khusus agar siapa pun bisa meluncurkan aplikasinya sendiri dalam waktu 5-10 menit saja.

Yang Anda butuhkan hanyalah:

  • 🟢 Akun Google pribadi (Gmail gratis biasa)
  • 🟢 Laptop atau Komputer (untuk setup awal)
  • 🟢 Kopi atau Teh hangat agar setup terasa menyenangkan! ☕
1

Siapkan Tempat Penyimpanan Data

Membuat Google Spreadsheet pribadi Anda sebagai basis data transaksi.

Aplikasi Duitnya menyimpan semua pengeluaran, pemasukan, dan catatan hutang Anda langsung di dalam akun Google Drive Anda. Oleh karena itu, kita perlu menyiapkan lembar catatan kosong terlebih dahulu.

  • Buka Google Drive
    Masuk ke Google Drive Anda menggunakan komputer atau laptop.
  • Buat Spreadsheet Baru
    Klik tombol + Baru di kiri atas, lalu pilih Google Spreadsheet. Lembaran kosong akan terbuka di tab baru.
  • Beri Nama File
    Di pojok kiri atas spreadsheet kosong tersebut, hapus tulisan "Spreadsheet tanpa judul" dan ganti dengan: Data Keuangan Keluarga.
💡 Kenapa langkah ini keren?

Karena file ini berada di Google Drive Anda sendiri, tidak ada orang luar, developer aplikasi, atau pihak ketiga mana pun yang bisa mengintip atau menyalahgunakan catatan keuangan keluarga Anda. Keamanan 100% milik Anda!

2

Pasang Kode di Dapur Aplikasi

Menghubungkan Google Apps Script (mesin aplikasi) dengan tampilan layar.

Sekarang kita akan memasukkan "otak" dan "tampilan" aplikasi ke dalam spreadsheet Anda. Tenang, Anda tidak perlu mengetik kode, cukup gunakan fitur salin-tempel (copy-paste) pintar kami!

⚠️ PERHATIAN: Jangan Sampai Salah File!

Ada dua file yang harus dipasang dengan benar:

1. Kode code.gs (Mesin) dimasukkan ke file Kode.gs di Google.

2. Kode app.html (Tampilan) dimasukkan ke file baru bernama index di Google. Jangan tertukar dengan index.html di folder komputer Anda.

  • Buka Google Apps Script
    Di menu atas lembar Spreadsheet Anda tadi, klik menu Ekstensi lalu pilih Apps Script. Layar berlatar abu-abu gelap/terang akan terbuka.
  • Masukkan Kode Mesin (code.gs)
    Secara otomatis ada file bernama Kode.gs di sebelah kiri. Hapus seluruh isi kodenya yang ada di bagian tengah, lalu salin isi file code.gs milik Anda dan tempel di situ.

Unggah & Salin File `code.gs`

Klik di sini, lalu pilih file code.gs dari folder Duitnya Anda. Kami akan menyalin isinya ke clipboard komputer Anda secara otomatis!

  • Buat File Baru Bernama 'index'
    Klik tombol tambah + di samping tulisan "Files" di pojok kiri atas Apps Script, pilih HTML. Beri nama file baru tersebut: index (tulis index saja, tanpa .html).
  • Masukkan Kode Tampilan (app.html)
    Buka file index.html baru tersebut. Hapus seluruh baris kode yang sudah ada, lalu salin isi file app.html milik Anda dan tempel di situ.

Unggah & Salin File `app.html`

Klik di sini, lalu pilih file app.html dari folder Duitnya Anda. Isinya akan langsung tersalin ke clipboard Anda!

  • Simpan Semua File
    Klik tombol **Simpan** berbentuk ikon disket 💾 di menu bagian atas, atau tekan tombol cepat Ctrl + S.
3

Aktifkan & Berikan Izin Keamanan

Memberikan izin agar aplikasi dapat memperbarui Google Spreadsheet Anda secara otomatis.

Langkah ini bertujuan untuk membentuk tabel-tabel transaksi pertama kali dan memberi wewenang aman ke Google Sheets Anda.

  • Pilih Menu 'setupSheets'
    Di bagian atas editor Apps Script, cari menu dropdown fungsi (sebelah kanan tulisan Debug). Klik dropdown tersebut dan pilih fungsi: setupSheets.
  • Jalankan Setup
    Klik tombol ▶ Jalankan (Run) di sebelah kirinya.
  • Mulai Otorisasi Izin
    Akan muncul jendela bertuliskan "Otorisasi diperlukan". Klik tombol Tinjau Izin (Review Permissions), lalu klik Akun Google Anda.
  • Buka Akses Lanjutan (Advanced)
    Jika muncul layar peringatan *"Google belum memverifikasi..."*, klik tulisan kecil Lanjutan di pojok kiri bawah, lalu klik link bertuliskan Buka Duitnya (tidak aman).
  • Klik Izinkan (Allow)
    Klik tombol biru Izinkan di bagian bawah. Tunggu beberapa detik sampai log eksekusi menyatakan "Eksekusi selesai".
🎉 Coba Cek Spreadsheet Anda!

Kembali ke tab Google Spreadsheet Anda. Di bagian bawah kini otomatis terbuat 3 sheet baru bernama Transactions, Debts, dan Settings lengkap dengan format judul tabel yang rapi. Semuanya dikerjakan secara otomatis oleh sistem!

4

Luncurkan Aplikasi (Deploy)

Mendapatkan link website rahasia agar aplikasi bisa dibuka dari manapun.

Setelah mesin dan lembar penyimpanan data siap, kini saatnya meluncurkan aplikasi ini ke internet agar menjadi website yang siap pakai.

  • Klik Tombol Deploy
    Di pojok kanan atas layar Apps Script, klik tombol biru Deploy, lalu pilih opsi pertama: Deployment baru.
  • Pilih Jenis Aplikasi Web
    Pastikan jenis deploy-nya adalah Aplikasi web (jika belum, klik ikon gerigi ⚙️ di kiri atas panel tersebut dan pilih Aplikasi Web).
  • Atur Akses Menjadi 'Semua Orang' (Anyone)
    Pada bagian **Yang memiliki akses** (Who has access), ubah dari "Hanya saya" menjadi Semua orang (Anyone). Langkah ini wajib agar aplikasi bisa dibuka di browser HP tanpa hambatan login berulang kali.
  • Proses & Salin URL Aplikasi
    Klik tombol biru Deploy di kanan bawah. Tunggu beberapa detik, lalu klik tombol Salin di bawah teks "URL Aplikasi web".
  • Masukkan URL ke File index di Apps Script
    Buka kembali file index di editor Apps Script Anda. Cari baris ke-202: const GAS_URL = "...";. Hapus URL tiruan di dalamnya, lalu tempel (paste) URL Web App asli yang baru saja Anda salin tadi. Tekan Ctrl + S untuk menyimpan.
  • Perbarui Deployment ke Versi Terbaru
    Di bagian atas editor Apps Script, klik tombol Deploy -> Kelola deployment. Klik ikon pensil ✏️ di pojok kanan atas panel, pada bagian Versi ubah ke Versi baru, lalu klik tombol biru Deploy. Ini memastikan kode terupdate Anda aktif secara online!
🚀 Kirim Link ke WhatsApp Anda!

Segera buka aplikasi WhatsApp (WA) di komputer Anda, lalu paste dan kirimkan link rahasia tersebut ke chat pribadi Anda atau ke pasangan Anda. Ini adalah pintu gerbang utama aplikasi Duitnya Anda!

5

Pasang di Layar Utama HP

Mengubah website link Apps Script menjadi ikon aplikasi HP yang siap dibuka sekali klik.

Agar layaknya aplikasi aslinya di HP, Anda bisa memasang shortcut visual di layar depan smartphone (Android maupun iPhone) dengan cara yang sangat simpel.

Smartphone Android

  1. Buka link aplikasi di browser Google Chrome HP.
  2. Ketuk ikon titik tiga (⋮) di pojok kanan atas Chrome.
  3. Pilih menu Tambahkan ke Layar Utama (Add to Home Screen).
  4. Beri nama "Duitnya", klik Tambah.

iPhone / iPad iOS

  1. Wajib buka link aplikasi menggunakan browser Safari HP.
  2. Ketuk tombol Bagikan (ikon kotak dengan panah ke atas ↑) di bawah layar.
  3. Geser ke bawah dan pilih opsi Tambahkan ke Layar Utama.
  4. Klik Tambah di pojok kanan atas.
  • Buka Aplikasi & Nikmati!
    Klik ikon Duitnya di layar HP Anda, atur profil pertama kali, dan mulailah merapikan keuangan keluarga tercinta! ❤️
6

Panduan Penggunaan Aplikasi

Pelajari cara mencatat transaksi harian, mengelola anggaran, dan memaksimalkan fitur Duitnya.

Setelah aplikasi terpasang di HP Anda, mari pelajari cara menggunakannya untuk mengendalikan arus kas keluarga dengan cerdas dan mudah.

1. Cara Mencatat Transaksi Baru

Cukup tekan tombol bulat hijau (+) di layar utama:

  • Pilih tab Pengeluaran atau Pemasukan.
  • Ketik nominal transaksi. Gunakan kalkulator bawaan di bawah kolom input untuk menjumlahkan beberapa belanjaan langsung (contoh: 15000 + 25000).
  • Pilih Kategori. Jika kategorinya belum ada, ketik langsung dengan memilih Kategori Baru... di bagian paling bawah dropdown.
  • Atur tanggal transaksi (opsional, bawaan adalah hari & jam ini) dan beri catatan singkat.
  • Tekan tombol Simpan Transaksi.

2. Mengatur Limit Anggaran Bulanan

Cegah keuangan bocor dengan menetapkan batas pengeluaran per kategori:

  • Masuk ke tab Akun (ikon profil paling kanan).
  • Buka akordeon Kategori & Limit Pengeluaran.
  • Tekan ikon pensil ✏️ di kategori yang ingin dibatasi (contoh: Belanja).
  • Masukkan nominal limit bulanan Anda, lalu klik simpan.
  • Kembali ke Dashboard untuk melihat sisa limit anggaran Anda yang dihitung secara dinamis.

3. Sinkronisasi Pasangan (Multi-Profil)

Gunakan satu basis data bersama pasangan Anda:

  • Pastikan Anda dan pasangan membuka link Web App rahasia yang sama.
  • Masuk ke tab Akun untuk mengubah nama aktif (contoh: ubah menjadi Abi di HP Anda, dan Ummi di HP pasangan).
  • Saat mencatat transaksi, nama profil aktif otomatis melekat, sehingga di tab Dashboard Anda bisa memfilter transaksi berdasarkan pencatatnya secara langsung!
  • Mencoba Mencatat Transaksi Pertama
    Buka aplikasi Anda, ketuk tombol (+), dan catat pengeluaran uji coba senilai Rp 10.000.
  • Membuat Kategori dan Batas Limit
    Buka tab Akun, berikan limit Rp 500.000 untuk kategori Makanan, lalu lihat visualisasi anggarannya di Dashboard.
  • Memahami Alur Google Sheets
    Buka Google Spreadsheet "Data Keuangan Keluarga" di Drive Anda dan perhatikan bagaimana transaksi yang Anda catat langsung masuk ke baris paling bawah secara rapi!

❓ Pertanyaan yang Sering Diajukan (FAQ)

Peringatan tersebut sepenuhnya wajar. Google memunculkannya karena Anda meluncurkan aplikasi web Anda sendiri (buatan sendiri) dan tidak mendaftarkan aplikasi Anda secara komersial ke Google. Ini justru paling aman, karena kodenya 100% Anda miliki secara privat tanpa ada keterlibatan server perusahaan pihak ketiga mana pun.

Sama sekali tidak! Aplikasi ini gratis 100% selamanya karena menggunakan infrastruktur cloud gratis milik Google Drive dan Google Apps Script pribadi Anda sendiri. Tanpa iklan, tanpa batas kuota, dan gratis seumur hidup.

Jika baru pertama kali diisi dan data belum terdeteksi, silakan klik tombol "SYNC" atau "CLOUD" di pojok kanan atas aplikasi Anda untuk melakukan pembaruan paksa secara real-time.

Tentu saja! Kirim link Web App rahasia hasil deploy Anda ke WhatsApp pasangan Anda. Pasangan Anda bisa membuka link tersebut di HP mereka, memilih profil yang berbeda (misalnya: "Ummi" sedangkan Anda "Abi"), dan mencatat transaksi bersama-sama. Semua transaksi akan terkumpul secara real-time di satu Google Spreadsheet yang sama!