Instalasi Skalfa App

Skalfa App dirancang agar proses memulai proyek baru berjalan cepat dan tanpa konfigurasi yang rumit. Ikuti langkah-langkah berikut untuk menyiapkan lingkungan pengembangan Skalfa App di mesin kamu.

1. Instal Skalfa CLI secara Global

Skalfa App diinstal dengan mudah menggunakan Skalfa CLI. Langkah pertama adalah menginstal CLI secara global menggunakan npm.
Kode berhasil di copy!
5

2. Buat Proyek Baru

Setelah CLI terinstal, Anda dapat membuat proyek Skalfa App baru secara instan. CLI akan membuat direktori proyek, mengunduh starter kit terbaru, menginstal dependensi, dan memberikan opsi tambahan (seperti dukungan PWA atau Tauri) secara interaktif.
Kode berhasil di copy!
5

Tips: Selama proses pembuatan proyek, Anda dapat memilih Y/n untuk langsung mengaktifkan dukungan PWA, Tauri Desktop, atau Tauri Mobile!

3. Atur Environment Variable

Setelah proyek berhasil dibuat, CLI telah menyalin .env.example menjadi .env secara otomatis. Buka file .env di editor Anda dan sesuaikan variabel di dalamnya (seperti URL API backend).
Kode berhasil di copy!
5

Environment Variable Bawaan (.env.example)

Skalfa App menyediakan file .env.example sebagai referensi konfigurasi awal. Kamu dapat menyalinnya menjadi .env lalu menyesuaikan nilainya sesuai kebutuhan proyekmu. Berikut adalah penjelasan singkat dari setiap variabel yang tersedia.
Kode berhasil di copy!
5

  • NEXT_PUBLIC_APP_NAME — Nama aplikasi yang dapat digunakan untuk judul aplikasi/website, prefix token akses, dll.
  • NEXT_PUBLIC_API_HOST — API URL untuk fetchControl, table supervision, component dan utilitas Skalfa App mengarah ke host ini.

    • Tips: Buat konfigurasi host api baru untuk mendukung beberapa host api

  • NEXT_PUBLIC_API_HEADERS — Header tambahan untuk request API (misalnya token statis, app-key, dll). Bisa dikosongkan jika tidak diperlukan.

    • Tips: Kosongkan jika tidak ada header api global

  • NEXT_PUBLIC_STORAGE_HOST — Lokasi public storage, digunakan untuk memuat gambar, dokumen, atau file lainnya dari backend.

    • Tips: Kosongkan jika tidak storage host sama seperti api host

  • NEXT_PUBLIC_SOCKET_HOST — URL Web Socket jika aplikasi membutuhkan koneksi realtime
  • NEXT_PUBLIC_SOCKET_KEY — Kunci akses Web Socket. Digunakan saat Web Socket membutuhkan autentikasi khusus.

    • Tips: Kosongkan atau hapus jika tidak menggunakan Web Socket

  • NEXT_PUBLIC_COOKIE_KEY — Isikan dengan huruf, angka, karakter unik acak untuk salt pada enkripsi cookie.

    • Penting: Jaga dan jangan pernah sebarkan cookie key ini!

  • NEXT_PUBLIC_MAP_KEY — API key untuk layanan peta (misalnya Google Maps, Mapbox). Digunakan oleh komponen terkait lokasi.

    • Tips: Kosongkan atau hapus jika tidak menggunakan Map / Lokasi

  • NEXT_PUBLIC_PORT — Alamat Port tempat aplikasi berjalan

4. Jalankan Development Server

Setelah dependensi terpasang, jalankan server pengembangan Next.js. seluruh fitur dasar Skalfa App sudah bisa langsung digunakan.
Kode berhasil di copy!
5

Tips: Gunakan BunJS untuk runtime dengan performa lebih maksimal.