ArX Finote adalah aplikasi pencatatan keuangan pribadi berbasis web (Single Page Application) yang dirancang dengan pendekatan modern, responsif (mobile-first), ultra-cepat, dan privasi penuh. Seluruh data keuangan disimpan 100% secara lokal di peramban Anda menggunakan IndexedDB tanpa ketergantungan pada server pihak ketiga.
- Manajemen Multi-Dompet (Wallets): Kelola berbagai jenis rekening bank, uang tunai, kartu kredit, dan dompet digital (e-wallet) dengan saldo terisolasi serta fitur transfer antar-dompet.
- Pencatatan Mutasi Fleksibel & Terkendali: Catat transaksi pemasukan, pengeluaran, dan transfer dengan validasi saldo dompet realtime untuk mencegah saldo defisit.
- Pinjaman Dompet Sendiri (Internal Self-Loan): Pinjam saldo dari dompet tertentu untuk berbagai keperluan fleksibel, dan lunasi kembali secara bertahap saat dana sudah tersedia tanpa batas jatuh tempo.
- Target & Rencana Finansial (Planning / Goals): Rencanakan pencapaian target finansial, tabungan, maupun kebutuhan masa depan dengan menyisihkan dan menyetorkan saldo dari dompet secara bertahap serta pemantauan progres visual.
- Pencarian & Filter Cepat: Temukan mutasi secara instan berdasarkan kata kunci deskripsi, nominal, dompet, kategori, ataupun periode bulan dan tahun.
- Cadangkan & Pulihkan (Backup & Restore): Ekspor dan impor seluruh data transaksi ke dalam format JSON, serta unduh rekap mutasi ke format tabel CSV.
- Progressive Web App (PWA): Dapat dipasang langsung ke layar beranda smartphone atau desktop (Installable), dapat dibuka secara offline, dan mendukung mode Terang (Light) serta Gelap (Dark).
- Runtime & UI: Preact dengan fine-grained reactivity via
@preact/signals. - Styling: Tailwind CSS v4 dan komponen DaisyUI v5.
- Penyimpanan Lokal: IndexedDB melalui wrapper Promise
idb. - Ikon UI: Lucide Preact (mengikuti standar aksesibilitas visual tanpa emoji).
- Format Tanggal: Day.js dengan locale Indonesia.
- Build Tool & PWA: Vite dan
vite-plugin-pwa(Workbox Service Worker). - Pengujian: Vitest bersama
@testing-library/preact. - Paket Manajer: pnpm (wajib).
- Node.js versi 18 ke atas
- pnpm versi 9 ke atas
-
Clone repositori:
git clone https://github.com/arxdev40/arxfinote.git cd arxfinote -
Pasang dependensi:
pnpm install
-
Jalankan server pengembangan (development):
pnpm dev
Akses aplikasi di browser pada alamat
http://localhost:5173. -
Jalankan pengujian unit (test):
pnpm test -
Kompilasi bundel produksi (build):
pnpm build
-
Pratinjau build produksi:
pnpm preview
Aplikasi ini mengadopsi prinsip Local-First / Zero-Knowledge Architecture:
- Tanpa Pihak Ketiga: Tidak ada API eksternal atau layanan analitik yang mengumpulkan data nominal maupun riwayat transaksi Anda.
- Penyimpanan Terisolasi: Database tersimpan secara aman di ruang penyimpanan IndexedDB browser pengguna pada perangkat masing-masing.
- Kontrol Penuh: Pengguna dapat sewaktu-waktu mengekspor seluruh basis data ke berkas JSON atau menghapus data secara permanen langsung dari menu pengaturan.
Proyek ini dilisensikan di bawah lisensi MIT.