Panduan Instalasi & Penggunaan

Langkah demi langkah menjalankan 100 Aplikasi Web Offline

Selamat! Anda telah berhasil memiliki Bundle 100 Aplikasi Web Offline. Panduan ini dirancang untuk pemula agar bisa langsung membuka dan memodifikasi aplikasi tanpa perlu pusing dengan urusan server atau hosting internet.

1. Mengunduh & Ekstrak File ZIP

Setelah pembayaran lunas, sistem telah mengirimkan tautan unduhan ke email Anda. Anda juga bisa mengunduhnya melalui Dasbor Member Area.

  1. Unduh file master bernama Bundle_100_Aplikasi_Offline.zip ke komputer/laptop Anda.
  2. Jangan langsung membuka file di dalam ZIP! Anda wajib mengekstraknya terlebih dahulu.
  3. Klik kanan pada file ZIP tersebut, lalu pilih "Extract Here" (jika menggunakan WinRAR) atau "Extract All..." (bawaan Windows).
  4. Anda akan mendapatkan sebuah folder baru yang berisi 100 folder aplikasi terpisah (Misal: App_Kasir, App_Absensi, App_Kalkulator, dll).

2. Cara Menjalankan Aplikasi (Sangat Mudah)

90% aplikasi dalam bundle ini dirancang menggunakan HTML, CSS (Tailwind), dan JavaScript murni. Artinya, aplikasi ini berjalan langsung di dalam Browser web Anda tanpa perlu instalasi server yang rumit.

Langkah-langkah:

  1. Buka salah satu folder aplikasi, misalnya folder App_Kasir_Pos.
  2. Cari file bernama index.html.
  3. Klik dua kali (Double Click) file tersebut.
  4. Aplikasi akan otomatis terbuka di browser bawaan Anda (Google Chrome, Edge, atau Safari) dan siap digunakan!

3. Mengedit Source Code (Ganti Nama Toko, Logo, dll)

Karena Anda memiliki 100% *Source Code*-nya, Anda bebas mengubah tampilan, teks, hingga logika aplikasinya.

  • Gunakan Text Editor: Jangan mengedit file HTML menggunakan Microsoft Word. Gunakan aplikasi gratis seperti Visual Studio Code (VS Code), Sublime Text, atau minimal Notepad.
  • Klik kanan pada file index.html lalu pilih "Open With -> Visual Studio Code".
  • Gunakan fitur pencarian (Ctrl + F) untuk mencari teks yang ingin Anda ubah. Misalnya Anda ingin mengubah teks "Toko Sejahtera", cari kata tersebut dan ganti sesuka Anda.
  • Simpan perubahan (Ctrl + S), lalu Refresh/Reload (F5) halaman browser tempat aplikasi Anda terbuka untuk melihat hasilnya.

4. (Opsional) Menjalankan Aplikasi via Localhost

Untuk beberapa aplikasi tingkat lanjut (yang menggunakan teknologi *Service Worker* agar bisa diinstal menjadi aplikasi Desktop/HP, atau melakukan penyimpanan file eksternal), membukanya dengan cara Double Click kadang ditolak oleh sistem keamanan browser. Anda harus membukanya via Localhost.

Opsi A: Menggunakan VS Code (Disarankan & Termudah)

1. Buka folder aplikasi di VS Code.
2. Pergi ke menu *Extensions* (Ctrl+Shift+X), cari dan instal ekstensi bernama "Live Server" (oleh Ritwick Dey).
3. Buka file index.html, klik kanan di dalam kode, pilih "Open with Live Server".
4. Aplikasi terbuka otomatis di URL http://127.0.0.1:5500/index.html.

Opsi B: Menggunakan XAMPP / Laragon

1. Pindahkan folder aplikasi (misal: App_Kasir) ke dalam folder `htdocs` (jika XAMPP) atau `www` (jika Laragon).
2. Nyalakan modul Apache.
3. Buka browser, ketik http://localhost/App_Kasir/.

5. Kendala Umum (FAQ)

Q: Saya mengubah kode, tapi kenapa di browser tidak berubah?

A: Pastikan Anda sudah menyimpan file (Ctrl+S). Jika masih sama, browser mungkin memuat Cache lama. Tekan Ctrl + Shift + R (Hard Refresh) di browser Anda.

Q: Fitur Cetak PDF/Struk tidak berfungsi jika saya Double Click index.html?

A: Beberapa library ekspor PDF membutuhkan akses server untuk memuat font/gambar. Silakan jalankan aplikasi menggunakan metode Localhost (Lihat Bab 4 - Live Server).

Q: Apakah aplikasi ini bisa saya unggah (hosting) ke internet?

A: Tentu saja! Anda cukup membeli domain dan hosting (cPanel/Hostinger), lalu unggah semua isi folder aplikasi ke folder public_html. Aplikasi Anda akan bisa diakses dari seluruh dunia.