Skip to main content

Troubleshooting

Running into issues? Here are solutions for the most common problems.

My build failed​

Most build errors fix themselves — the AI fix agent automatically retries up to 3 times.

If it still fails:

  1. Check the progress log for the error message
  2. Paste the error in chat: "Fix the build error: [paste error message]"
  3. If the change was complex, try breaking it into smaller steps

I see a blank page​

Open browser dev tools (F12), check the Console tab, and tell Appifex what you see:

"The app shows a blank page. The console says: [paste error]"

My data isn't saving​

Common causes:

  • Backend not ready — Wait a moment and retry
  • Form validation — Check for required fields you might have missed
  • Schema mismatch — Describe the issue in chat and let AI fix it

The styling looks wrong​

  1. Hard refresh (Ctrl/Cmd + Shift + R) to clear cached styles
  2. Check if it's only at certain screen sizes
  3. Be specific about what's wrong:
"The sidebar should be 250px wide on desktop and full width on mobile"

The QR code won't scan​

  1. Make sure the Appifex app is installed on iOS (App Store); QR scanning is currently iOS-only
  2. Open the Appifex app and use it to scan the QR code
  3. If you're on Android or desktop browser, open the preview link directly in your browser and sign in to the same Appifex account
  4. Make sure you're logged into the Appifex app with the same account
  5. Try refreshing the QR code in Appifex

My app works on web but not mobile​

The code might be using a web-only feature. Tell Appifex:

"[Feature name] works on web but not on mobile. Fix it for mobile."

My app crashes on startup (mobile)​

Check the progress log for error messages. If the app uses a backend, make sure the backend preview is running -- previews pause after inactivity. Click "Resume preview" to restart.

GitHub isn't syncing​

  • Check your GitHub connection in Settings — try disconnecting and reconnecting
  • Make sure Appifex has write access to your repository
  • For merge conflicts, use Sync with main in Appifex or resolve on GitHub

The preview stopped working​

Previews pause after 20 minutes of inactivity. Click Resume preview to bring it back.

If it says "Restart preview," the environment was cleaned up — click to recreate it.

Still stuck?​

Before reaching out, gather:

  1. What you were trying to do
  2. What happened instead
  3. Any error messages (copy the full text)

Then: