create-stellar-frontend

CLI untuk membuat proyek frontend Stellar siap pakai. Cukup satu perintah — folder frontend/ akan dibuat otomatis di direktori saat ini.

Persyaratan

• Node.js 18 atau lebih baru
• npm

Penggunaan

Di dalam folder proyek kamu (misalnya root monorepo atau folder kosong):

npx create-stellar-frontend

Setelah selesai:

cd frontend
npm run dev

Apa yang dihasilkan?

Perintah di atas membuat folder frontend/ berisi:

| Teknologi | Keterangan | |-----------|------------| | Vite | Build tool & dev server | | React | UI framework | | TypeScript | Type safety | | Tailwind CSS | Styling | | @stellar/stellar-sdk | Interaksi dengan jaringan Stellar | | @stellar/freighter-api | Integrasi wallet Freighter |

Struktur folder

.
└── frontend/
    ├── bindings/       # Contract bindings
    ├── public/
    ├── src/
    │   ├── App.tsx
    │   ├── main.tsx
    │   └── stellar.ts  # Helper koneksi wallet & kontrak
    ├── .env.example
    ├── package.json
    └── vite.config.ts

Environment variables

Saat scaffold, file .env dibuat dari .env.example. Sesuaikan sebelum development:

VITE_STELLAR_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
VITE_STELLAR_RPC_URL=https://soroban-testnet.stellar.org
VITE_STELLAR_CONTRACT_ID=

Isi VITE_STELLAR_CONTRACT_ID dengan contract ID Soroban kamu.

Opsi

npx create-stellar-frontend --help        # Tampilkan bantuan
npx create-stellar-frontend --no-install  # Skip npm install

Folder frontend harus belum ada atau kosong. Jika sudah berisi file, proses akan gagal.

Development (maintainer)

Clone repo ini, lalu uji CLI secara lokal:

# Di folder kosong
node /path/to/npx-stellar-frontend/bin/index.js --no-install

Preview isi paket sebelum publish:

npm pack --dry-run

Publish ke npm

npm version patch   # atau minor / major
npm publish

Setiap ada perubahan di template/ atau bin/, naikkan versi lalu publish ulang. Pengguna mendapat versi terbaru lewat:

npx create-stellar-frontend@latest

Lisensi

MIT