Cara jual boilerplate di CloudAgni (dari folder proyek, satu perintah)

Punya boilerplate yang sudah terbukti dipakai sendiri? Marketplace CloudAgni membuatnya bisa dijual tanpa bikin landing page, tanpa urusan pembayaran, dan tanpa jadi tech support instalasi untuk tiap pembeli: pembeli menekan satu tombol dan aplikasinya langsung jalan. Ini panduan lengkapnya.

1. Siapkan dua file di proyek

Proyek Anda hanya butuh dua tambahan supaya bisa dikemas menjadi produk siap-deploy.

wrangler.jsonc berisi nama, folder hasil build, dan resource yang dibutuhkan:

{
	"name": "boilerkasir-app",
	"compatibility_date": "2025-09-02",
	"main": "worker.js",
	"assets": {
		"directory": "./dist",
		"binding": "ASSETS",
		"not_found_handling": "single-page-application"
	}
}

worker.js: satu baris penyaji aset statis:

export default {
	fetch: (req, env) => env.ASSETS.fetch(req),
};

Punya database atau storage? Tambahkan d1_databases, r2_buckets, atau kv_namespaces di wrangler.jsonc. Saat pembeli deploy, platform otomatis membuatkan resource tersebut untuk mereka: Anda tidak perlu menulis dokumentasi setup.

2. Publish dengan satu perintah

Dari folder proyek:

agni publish ./ --slug boiler-kasir --name "Boiler Kasir" --price 299000 \
  --demo-url https://app.demo-kasir.cloudagni.id \
  --description "Landing kasir: produk, transaksi, laporan harian"

Perintah ini melakukan build proyek Anda, mengemas hasilnya menjadi satu bundle siap-deploy, lalu membuat draft listing. Slug menjadi identitas listing di katalog dan harus unik. Harga 0 berarti gratis.

Deploy instansi demo sendiri dulu (deploy biasa lewat dashboard) dan masukkan URL-nya ke --demo-url: listing dengan tombol Contoh ↗ jauh lebih percaya diri di mata pembeli.

3. Ajukan review

Draft tidak langsung tayang. Dari dashboard, buka Jual Boilerplate → Ajukan review (atau agni submit <id>). Admin memeriksa bahwa bundle berjalan dan tidak membawa rahasia Anda, lalu menyetujui. Sejak itu listing tampil di Marketplace dan bisa dibeli.

Alur lengkapnya di dashboard: publish → Menunggu review → Tayang. Kalau ditolak, alasan penolakannya tertulis di daftar listing Anda; perbaiki dan ajukan ulang.

4. Opsional: otomatis dari GitHub

Supaya tiap rilis versi baru langsung tersedia untuk pembeli berikutnya, tambahkan workflow ini di repo Anda:

name: Publish marketplace
on:
  push:
    tags: ["v*"]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dzulfikar08/cloudagni/.github/actions/marketplace-publish@master
        with:
          slug: boiler-kasir
          name: Boiler Kasir
          price: "299000"
          api-key: ${{ secrets.AGNI_API_KEY }}

Setiap kali Anda push tag v*, GitHub membuat dan memperbarui listing otomatis. Source code tidak pernah keluar dari repo Anda.

Yang perlu diingat

• Bundle maksimal 50MB dan tidak boleh membawa API key atau rahasia Anda: hasil build berjalan di akun pembeli.
• Publish ulang dengan slug yang sama untuk memperbarui isi; pembeli berikutnya otomatis mendapat versi terbaru.
• Listing berbayar dipotong fee platform 20%. Pembeli bayar sekali dan boleh deploy berkali-kali.

Panduan referensi lengkap ada di docs/marketplace.md. Kalau sudah siap, listing pertama Anda hanya selebih satu perintah.