Seperti judulnya, saya akan memberikan sedikit tutorial bagaimana caranya situs web yang kamu taruh di repositori Github itu bisa ditaruh di Nekoweb. Ya, ini adalah tutorial yang kutulis yang kebetulan tadi pagi menemukan sebuat tool berguna. Semua bermula dari salah satu web https://maxpixels.moe/ yang menggunakan framework Astro dan dihosting di Nekoweb menggunakan Github. my main web

Ambil tokennya terlebih dahulu

Pertama kita ambil dulu API Tokennya disini, lalu klik regenerate Api Key Nekoweb

Kedua, setelah mendapatkan API Key nya, pergi ke repositori dimana webmu dihosting misalnya repositori “My Astro Website”.

Kemudian di bagian Pengaturan buka “Actions secret and Variables”, kemudian buat “New Repository Secret”, nama value sesuaikan seperti digambar lalu isi token API yang kamu dapat, lalu klik simpan. Settings Github Actions

Buat script deploy nya

Nah, selanjutnya kamu membuat skrip untuk deploy ke Nekowebnya, kusarankan di local, oke!

Buat struktur folder di file explorer seperti ini, kemudian buka skrip deploy.yml itu menggunakan code editor favoritmu, disini aku menggunakan vscode karena lebih mudah. scripts deploy

Jika di vscodemu sudah terinstal add-ons GitHub Actions itu sangat mudah, jika belum biasanya vscode akan memberitahumu untuk menginstal add-ons GitHub Actions terlebih dahulu. Ambil contoh kodenya disini. Lalu copas ke vscode, kemudian tambahkan beberapa value, kurang lebih seperti ini lalu simpan. edit script

on: [push]
jobs:
  test:
    runs-on: ubuntu-latest
    name: deploy2nekoweb
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      // ini yang ditambah
      
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: 'npm'
      - name: Install Dependencies
        run: npm ci
      - name: Build Astro Site
        run: npm run build
      - name: deploy2nekoweb
        uses: indiefellas/deploy2nekoweb@main
        with:
          nekoweb-api-key: ${{ secrets.NEKOWEB_API_KEY }}
          nekoweb-domain: 'username.nekoweb.org'
          nekoweb-username: 'username'
          directory: 'dist'

Kenapa itu harus diatur di folder dist? karena letak build berkas html nanti ada disitu semua.

Run Build

Sebelum kita mendeploynya ke nekoweb, kamu harus mendeploy dulu di local untuk menghasilkan berkas html, cukup di vscode jalankan perintah “npm run build” tunggu hingga proses selesai. Dan semua berkas yang habis dijalankan melalui perintah npm run build akan nongol disini, yang nantinya akan digunakan untuk deploy ke nekoweb

results

Setelah semua berkas html dihasilkan, kamu tinggal klik commit and push ke github, nantinya akan memproses, dan jika berhasil nanti akan muncul disini hasil di nekoweb

Apakah metode yang di Neocities itu sama?

Jika kamu ingin hosting di Neocities, kurang lebih sama namun ada penyesuain di skrip auto deploynya, cuma aku lagi gak minat hosting disitu karena akses ke Neocities diblokir digidaw.