Troubleshoot — masalah biasa & solution

Format setiap entry: Symptom → Punca → Cara baiki. Scan ikut kategori di bawah.

1.Build & AI errors

Masalah #1

Symptom: "Build gagal" / "Stream interrupted" error toast.

Punca: AI provider kami sedang busy atau request timeout.

Cara baiki: Tunggu 30 saat, klik Build semula. AI action TIDAK ditolak jika gagal. Kalau berlaku 3 kali berturut-turut, refresh page + cuba lagi.

Masalah #2

Symptom: "Model truncated" — HTML balik tapi tidak siap.

Punca: AI sampai max token sebelum siap. Biasanya brief terlalu panjang atau too many sections dalam Features.

Cara baiki: Pendekkan brief (kurang content dalam Notes), atau pilih fewer sections dalam Features accordion. Cuba Build semula.

Masalah #3

Symptom: "Model returned no content".

Punca: AI provider returned empty response. Jarang berlaku.

Cara baiki: Cuba Build semula. Quota tidak dikira. Kalau berulang, hubungi support dengan project ID.

2.Quota & subscription errors

Masalah #4

Symptom: "Had AI bulanan dah penuh" — block Build.

Punca: Anda dah guna semua AI actions untuk bulan ini + tiada baki top-up.

Cara baiki: Beli top-up di /account/topup (kekal walaupun cycle reset) atau upgrade plan.

Masalah #5

Symptom: "Pilih projek untuk simpan" page muncul.

Punca: Anda over-quota — drafts/sites melebihi had plan (biasanya selepas downgrade ke Free).

Cara baiki: Pergi ke /account/pick-to-keep → pilih projek mana untuk simpan. Yang lain archived (30 hari grace) sebelum permanent delete.

Masalah #6

Symptom: Sites live tiba-tiba return 404 / "Subscription expired".

Punca: Tempoh langganan dah tamat dan belum renew.

Cara baiki: Pergi ke /account/renew → bayar untuk cycle baru. Sites live back online dalam 1 minit. Free tier: 7-hari publish dah expired, mesti upgrade.

3.Publish & subdomain errors

Masalah #7

Symptom: "Subdomain dah digunakan" / subdomain_taken.

Punca: Nama subdomain dah claim oleh user lain (first-come-first-served).

Cara baiki: Pilih subdomain lain. Tip: tambah business location (cth: pizzahut-shah-alam berbanding pizzahut).

Masalah #8

Symptom: "Cannot publish staged".

Punca: Projek anda staged (24-hour overflow). Tak boleh publish staged drafts.

Cara baiki: Hapus draft lama dalam /account/sites, atau upgrade plan dulu untuk simpan sebagai permanent draft. Lepas itu boleh publish.

4.Custom domain errors

Masalah #9

Symptom: Custom domain stuck pada "Pending DNS" lebih dari 15 minit.

Punca: DNS record tak ada / salah / belum propagate.

Cara baiki:

Buka mxtoolbox.com → DNS Lookup → masukkan domain anda → lihat ada CNAME ke cname.vercel-dns.com? Kalau tiada, tambah di Cloudflare.
Untuk apex (foo.com): pastikan A record ke 76.76.21.21 exists.
Klik "Periksa semula" di /account/domains.

Masalah #10

Symptom: "DNS tidak betul" status pada row domain.

Punca: DNS record ada tapi target salah (cth: pointing ke server lain).

Cara baiki: Edit record di Cloudflare → tukar value ke cname.vercel-dns.com (atau 76.76.21.21 untuk A). Tunggu 5 minit, klik Periksa semula. Pastikan mode DNS only (gray cloud), bukan proxied (orange).

Masalah #11

Symptom: Custom domain verified tapi browser kata "Not Secure" / SSL error.

Punca: Vercel masih dalam proses issue Let's Encrypt cert. Biasa ambil 1-5 minit selepas DNS verified.

Cara baiki: Tunggu 5 minit. Refresh page. Cert auto-issued — tiada action diperlukan.

5.Payment & integration errors

Masalah #12

Symptom: Visitor di site anda klik "Beli" tapi tiada apa berlaku.

Punca: Payment provider belum diset di /account/settings.

Cara baiki: Setup ToyyibPay/CHIP/BillPlz dulu. Detail di Setup payment di site anda.

Masalah #13

Symptom: "Payment provider rejected" — checkout fail.

Punca: API key payment provider invalid atau expired.

Cara baiki: Re-paste API key di /account/settings. Cuba payment lagi. Kalau masih fail, regenerate key di dashboard provider, lepas itu paste yang baru.

6.Image errors

Masalah #14

Symptom: Image tak nampak dalam published site.

Punca:

URL gambar http:// (bukan https://) — browser block mixed content.
URL gambar private (cth: Google Drive yang tak shared).
Format tak disokong (cth: HEIC dari iPhone).

Cara baiki: Pastikan URL https://, public, dan format JPG/PNG/WebP/GIF. Atau drag-drop fail terus dalam editor — kami auto-host di ImgBB dengan URL yang betul.

7.Account errors

Masalah #15

Symptom: Tak boleh log masuk — "email_not_confirmed".

Punca: Anda daftar tapi belum klik link sahkan emel.

Cara baiki: Buka emel anda (semak Spam juga). Klik link sahkan. Kalau tak jumpa: pergi ke /auth/check-email + klik "Resend email".

💡 Masalah anda tiada di sini? Email hello@aranis.site dengan: project ID + screenshot + apa yang anda buat sebelum error.

← Sebelum

Affiliate — jana income

Seterusnya →

FAQ — soalan lazim