Electron POS

Aplikasi POS desktop modern berbasis Electron + Vite yang cepat, ringan, dan mudah dikembangkan.

Mulai Instalasi GitHub Download

Persyaratan Minimum

Environment Development

Pastikan sistem Anda memenuhi persyaratan berikut sebelum memulai.

Node.js

Diperlukan Node.js versi 20 ke atas. Gunakan nvm untuk mengelola versi Node.js.

Package Manager yang didukung:

• npm
• pnpm (direkomendasikan)
• yarn
• bun

Tools tambahan:

• Terminal / Command Prompt
• VS Code (disarankan)

---

Persyaratan Sistem

Komponen	Minimum	Rekomendasi
OS	Windows 10 / macOS 11	Windows 11 / macOS 13+
RAM	4 GB	8 GB+
Storage	500 MB	SSD 1 GB+
Processor	Dual Core	Quad Core
Browser	Chrome 100+	Chrome terbaru
Internet	2 Mbps	10 Mbps+

---

Instalasi

1. Clone Repository

git clone https://github.com/ilhamganteng321/electron-pos
cd electron-pos

2. Install Dependencies

Pilih package manager yang Anda gunakan:

npm

npm install

pnpm

pnpm install

yarn

yarn install

bun

bun install

---

Menjalankan Project

Jalankan development server dengan perintah berikut:

npm

npm run dev

pnpm

pnpm run dev

yarn

yarn dev

---

Build Aplikasi Desktop

Untuk mengemas aplikasi menjadi installer Windows (.exe):

npm

npm run build:win

pnpm

pnpm run build:win

yarn

yarn build:win

Hasil Build

Setelah proses build selesai, file installer tersedia di:

dist/

atau

out/

Lokasi output tergantung pada konfigurasi electron-builder yang digunakan.

---

Struktur Proyek

electron-pos/
│
├── 📁 .vscode/                 # Konfigurasi VS Code
├── 📁 build/                   # Asset build tambahan
├── 📁 dist/                    # Hasil build frontend (Vite)
├── 📁 electron/                # Source proses utama Electron
│   ├── ipc/                    # Komunikasi IPC
│   └── db/                     # Akses database SQLite
│
├── 📁 node_modules/            # Dependencies
├── 📁 out/                     # Output aplikasi desktop (setelah packaging)
├── 📁 resources/               # Icon, font, dan asset tambahan
├── 📁 src/                     # Source frontend utama
│   ├── main/
│   ├── preload/
│   └── renderer/
│
├── app.db                      # Database SQLite lokal
├── electron.vite.config.mjs    # Konfigurasi electron-vite
├── electron-builder.yml        # Konfigurasi packaging
├── package.json                # Dependency & scripts
└── README.md                   # Dokumentasi project

---

Technology Stack

Teknologi	Fungsi
Electron	Desktop Framework
React	User Interface
Vite	Build Tool
SQLite	Local Database
Tailwind CSS	Styling
electron-builder	Packaging & Distribusi

---

Fitur Utama

✨ Fitur Unggulan

• 🖥️ Desktop POS Modern — tampilan bersih dan intuitif
• ⚡ Performa Cepat — ditenagai Vite + Electron
• 🧾 Manajemen Transaksi — catat dan kelola transaksi dengan mudah
• 📦 Kelola Produk — tambah, edit, dan hapus produk
• 📊 Laporan Penjualan — pantau performa penjualan
• 💾 Backup Database SQLite — data aman tersimpan lokal
• 🖨️ Support Print Struk — cetak struk langsung dari aplikasi
• 🌙 Modern UI — desain gelap yang nyaman di mata

---

Tips Development

Bersihkan Cache

Jika terjadi error pada dependency, coba bersihkan cache terlebih dahulu:

rm -rf node_modules
npm install

Rebuild Native Modules

Jika module Electron bermasalah setelah update:

npm rebuild

---

Troubleshooting

Aplikasi Blank / White Screen

Solusi

1. Pastikan proses build frontend selesai tanpa error
2. Cek output console Electron untuk pesan error
3. Restart development server

Database Tidak Terdeteksi

Periksa file berikut

Pastikan file app.db tersedia di root direktori project:

electron-pos/
└── app.db   ✅ harus ada

Build Gagal

Solusi

Jalankan ulang instalasi dan build:

npm install
npm run build

---

Lisensi

MIT License © 2026

---

❤️ Support

Jika project ini membantu, berikan ⭐ star di repository GitHub — sangat berarti untuk pengembangan lebih lanjut!