Skip to main content

Troubleshooting

Solutions to common issues.

Build & Deployment Issues​

Build failed​

Symptoms: Deployment shows "failed" status

Solutions:

  1. Check the activity log for specific error messages
  2. AI Fix Agent usually resolves common issues automatically
  3. If it persists, try: 
    "Fix the build error: [paste error message]"

TypeScript errors​

Symptoms: "Property X does not exist on type Y"

Solutions:

  • AI Fix Agent handles most TypeScript errors
  • For persistent issues: 
    "Add the missing type definition for [component/variable]"

Dependency conflicts​

Symptoms: "npm ERR! ERESOLVE unable to resolve dependency tree"

Solutions:

  • Usually auto-fixed by AI Fix Agent
  • If not: 
    "Fix the npm dependency conflict"

Deployment timeout​

Symptoms: Build takes too long and times out

Solutions:

  • Simplify the change and try again
  • Break large changes into smaller steps
  • Check if external APIs are responding

App Issues​

App shows blank page​

Possible causes:

  • JavaScript error in console
  • API endpoint not responding
  • Missing environment variables

Solutions:

  1. Open browser developer tools (F12)
  2. Check Console tab for errors
  3. Describe the error: 
    "The app shows a blank page. Console shows: [error]"

Data not saving​

Possible causes:

  • Backend API issue
  • Database connection problem
  • Validation error

Solutions:

  1. Check activity log for API errors
  2. Verify database is running
  3. Check form validation: 
    "The form doesn't save. Check the API endpoint and validation."

Styling looks wrong​

Possible causes:

  • CSS not loading
  • Wrong Tailwind classes
  • Responsive breakpoint issues

Solutions:

  1. Hard refresh the page (Ctrl/Cmd + Shift + R)
  2. Check browser width for responsive issues
  3. Fix specific styling: 
    "The sidebar should be 250px wide on desktop, full width on mobile"

Mobile App Issues​

QR code won't scan​

Solutions:

  1. Ensure Expo Go is installed
  2. Make sure your phone and computer are on the same network
  3. Try refreshing the QR code
  4. On Android, use Expo Go to scan (not camera app)

App crashes on startup​

Possible causes:

  • Missing dependencies
  • Invalid code
  • API not reachable from device

Solutions:

  1. Check Appifex activity log
  2. Ensure backend URLs are accessible from internet
  3. Describe the issue: 
    "The mobile app crashes on startup with error: [message]"

Features work in web but not mobile​

Possible causes:

  • Web-only APIs used (window, document)
  • Different navigation patterns
  • Native permissions needed

Solutions:

"[Feature] doesn't work on mobile. It works on web.
 Make it compatible with React Native."

GitHub Issues​

Repository not syncing​

Solutions:

  1. Check GitHub connection in Settings
  2. Verify webhook is registered
  3. Try reconnecting GitHub:
    • Settings → Disconnect GitHub
    • Reconnect and reauthorize

Push permission denied​

Solutions:

  1. Ensure Appifex has write access to the repository
  2. Check repository settings on GitHub
  3. Reauthorize if permissions changed

Branch conflicts​

Symptoms: "Merge conflict" when syncing

Solutions:

  1. Use "Sync with main" feature
  2. Or resolve manually on GitHub
  3. For complex conflicts: 
    "Help me resolve the merge conflict in [file]"

Authentication Issues​

Can't log in​

Solutions:

  1. Try resetting your password
  2. Clear browser cookies
  3. Try a different browser
  4. Contact support if persistent

Session expired frequently​

Solutions:

  1. Ensure cookies are enabled
  2. Check "Remember me" when logging in
  3. Clear cache and re-login

Performance Issues​

App is slow​

Possible causes:

  • Too many API calls
  • Large data sets without pagination
  • Unoptimized images

Solutions:

"Optimize the [page/component]:
 - Add pagination to the list
 - Cache API responses
 - Lazy load images"

Long generation times​

Solutions:

  • Break complex features into smaller prompts
  • Be more specific about requirements
  • Avoid regenerating entire apps

Getting More Help​

Collect information​

Before asking for help, gather:

  1. What you were trying to do
  2. What happened instead
  3. Error messages (copy full text)
  4. Steps to reproduce

Discord support​

Join our Discord for community help.

Email support​

For account or billing issues, contact support through the app.