Skip to content

Electron POS ​

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

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 ​

KomponenMinimumRekomendasi
OSWindows 10 / macOS 11Windows 11 / macOS 13+
RAM4 GB8 GB+
Storage500 MBSSD 1 GB+
ProcessorDual CoreQuad Core
BrowserChrome 100+Chrome terbaru
Internet2 Mbps10 Mbps+

Instalasi ​

1. Clone Repository ​

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

2. Install Dependencies ​

Pilih package manager yang Anda gunakan:

bash
npm install
bash
pnpm install
bash
yarn install
bash
bun install

Menjalankan Project ​

Jalankan development server dengan perintah berikut:

bash
npm run dev
bash
pnpm run dev
bash
yarn dev

Build Aplikasi Desktop ​

Untuk mengemas aplikasi menjadi installer Windows (.exe):

bash
npm run build:win
bash
pnpm run build:win
bash
yarn build:win

Hasil Build ​

Setelah proses build selesai, file installer tersedia di:

text
dist/

atau

text
out/

Lokasi output tergantung pada konfigurasi electron-builder yang digunakan.


Struktur Proyek ​

text
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 ​

TeknologiFungsi
ElectronDesktop Framework
ReactUser Interface
ViteBuild Tool
SQLiteLocal Database
Tailwind CSSStyling
electron-builderPackaging & 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:

bash
rm -rf node_modules
npm install

Rebuild Native Modules ​

Jika module Electron bermasalah setelah update:

bash
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:

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

Build Gagal ​

Solusi

Jalankan ulang instalasi dan build:

bash
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!