Account and reference · Chapter 16

Troubleshooting

Most problems are found and fixed by Chirai before you see them. When something still isn't right, start here.

The preview says "Build failed"

Chirai repairs most failures itself — its own repair first (in milliseconds, no AI), then AI repair for what's left. If the preview still fails:

Press Fix with IILA — it reads the error and repairs the file.
If that doesn't work, press Try again.
Still failing? Email support-note@chirai.dev with the error message and your app's name.

The preview takes a long time to open

The first time each page opens in the preview it's prepared on the spot, which can take a few seconds. It's fast after that, and the live site is always fast.

IILA says it can't make a change

"This is one of Chirai's own pages": shop, product, cart, checkout and account pages are built to work with your data. Change products and prices in Manage site; ask IILA only for styling (colours, spacing, fonts) on these pages.
The change touches many pages: ask for one page at a time, naming the page ("on the About page…").

A page shows a database error or an empty list

Empty list: there are no records yet, or they're all sample records you deleted. Add some in Manage site.
"Please sign in first": the page saves something that belongs to a person — sign in, then try.
A message like "Description must be at least 20 characters": that's your site's own rule; fill the field as asked.

My domain stays "pending"

Check the records exactly match what the Domains page shows (no extra dots, @ for the root).
On Cloudflare, set them to DNS only.
Records can take a few hours to spread. Chirai checks every 10 minutes for two weeks — press Check now to check immediately.

Payments don't work

Use test keys and a test card first; switch to live keys for real customers.
Razorpay: make sure the account is activated for live payments.
With your own payment link, orders stay "awaiting payment" until you mark them paid.

Customers don't get emails

Emails sent through Chirai can land in spam. Set up your own sender in Email (Brevo, Gmail with an app password, SendGrid, Mailgun) and send yourself a test.

Google Play or the App Store says something is missing

Play: the App content questions (including Data safety) must be answered in Play Console; new personal accounts need a 14-day closed test with 12 testers before production.
App Store: App Privacy must be answered in App Store Connect. The build log lists what Apple still needs.

Something else

Open ⚙ Manage site → Site check to see what Chirai found on your live site, and use the "Ask anything" box in the Studio's publishing guide for store questions.