Skip to content
Help Center
Try Draftbit Free

Common Issues

Quick fixes for the most frequently reported problems

This page collects fixes for issues we hear about most often. If you don’t see your problem here, ask in the in‑app support chat or post in the Community.

Preview won’t load or is stuck

Section titled “Preview won’t load or is stuck”

The preview sandbox can occasionally enter a stuck state, especially after large changes or package additions.

  • Click Restart Preview in the preview toolbar before asking the agent to “fix it again.” Restarting is usually faster — and free — compared to letting the agent retry.
  • If the preview reports running (with errors), expand the Logs panel to see which file failed. Errors there are often a quick syntax or import fix.
  • If you’ve just added or removed a package, you may need a new native build to pick it up.

Agent runs in a fix-it loop

Section titled “Agent runs in a fix-it loop”

If you find yourself sending “fix it” → “still broken” → “try again,” you’re likely paying for the same context to be re‑processed.

  • Stop, read the most recent error in Logs or the chat output, and send a single targeted message describing the actual error.
  • If the thread has more than ~15 messages, start a fresh thread with a short summary of the current state plus the specific error.
  • See Using Credits Efficiently for the full playbook.

”Module not found” or import errors

Section titled “”Module not found” or import errors”

Most often this means a file was moved or renamed, or a package wasn’t installed.

  • For a missing package, ask the agent to add it — it will install via npm and update app.json if needed. See the Adding Packages with AI Chat guide.
  • For a missing file, check the path in the import. Imports are case‑sensitive — ./userProfile and ./UserProfile are different files on the build server even if they look the same on macOS.

Save is blocked due to syntax errors

Section titled “Save is blocked due to syntax errors”

The Code Editor checks every file for syntax errors before saving. If save is blocked, look for the inline diagnostic in the gutter and fix the highlighted line, then save again.

Native build fails on iOS or Android

Section titled “Native build fails on iOS or Android”
  • Confirm your publishing config is complete on the Publishing page (App Store Connect / Play Console credentials, signing key).
  • If credentials look corrupted (e.g., signing key error after a key rotation), use the Reset credentials action on the publishing config to regenerate certificates or re‑upload the signing key.
  • If a build started but never finished, check the build log on the Publishing page for the actual error.

App preview works but the published app is broken

Section titled “App preview works but the published app is broken”

The published app uses the values in App Config (bundle identifier, scheme, icons, splash, etc.), not the project Settings. If a setting only shows up after publishing, double-check App Config.

Browser issues in the Builder itself

Section titled “Browser issues in the Builder itself”
  • Use Chrome, a Chromium-based browser, or Firefox. Safari has known compatibility limitations.
  • Disable ad-blockers or privacy extensions for draftbit.com if the Builder fails to load assets or the agent can’t reach the sandbox.
  • If a screen is blank, do a hard reload (Cmd/Ctrl + Shift + R) and check the browser console for errors.

Still stuck?

Section titled “Still stuck?”