Preview issues
Preview not loading
Preview not loading
- Click the Restart Metro button in the preview panel
- If that doesn’t help, ask the AI: “restart the preview with cache reset”
- Check that your browser allows the preview iframe to load
Preview shows errors
Preview shows errors
Runtime errors display with a count badge in the preview panel.
- Click Fix All Errors to let the AI diagnose and fix them automatically
- Or describe the error to the AI: “I’m seeing an error on the home screen”
App looks different on phone vs browser
App looks different on phone vs browser
This is expected. The browser preview uses React Native’s web renderer, which approximates but doesn’t perfectly match native rendering.Native differences include:
- Navigation bars and tab bars
- Modal presentations
- Date and time pickers
- Platform-specific animations
- Shadows and elevation
Camera, biometrics, or notifications don't work in preview
Camera, biometrics, or notifications don't work in preview
These features require native device APIs that aren’t available in the browser preview. Test camera and biometrics on a physical device using Expo Go. Push notifications don’t arrive in Expo Go or in the preview on your phone: the browser preview shows a test as a labelled banner, and real notifications arrive once your app is installed on its own. See push notifications.
Build and deployment issues
Build fails
Build fails
The build card shows the reason. Ask the AI to read the build’s logs and fix the problem. Common causes:
- Missing or invalid app icon
- Invalid
app.jsonconfiguration - Android: wrong keystore password or key alias
- iOS: expired Apple session or Apple Developer certificates
Can't connect GitHub
Can't connect GitHub
- Make sure you’re logged into GitHub in your browser
- Check that you’ve authorized Fastshot to access your GitHub account
- Try revoking and re-granting access in GitHub Settings > Applications
Can't connect your Apple account
Can't connect your Apple account
- “This Apple ID isn’t in the Apple Developer Program”: join at developer.apple.com/programs, then sign in again
- “Apple session expired”: click Re-authenticate under Apple Credentials on the iOS tab
App behavior issues
Data isn't saving
Data isn't saving
- If using local storage: data resets when the app is reloaded in the browser preview. Test on a physical device for persistent storage.
- If using Supabase: check that your Supabase project is connected and the database tables exist.
App crashes on launch
App crashes on launch
Ask the AI to check for errors: “The app crashes when it opens.” The AI will inspect the Metro logs and code for issues like missing imports, undefined variables, or configuration errors.
Account and credits
Running low on credits
Running low on credits
- Send focused, one-change-at-a-time messages (more efficient than large multi-change requests)
- Simple UI tweaks cost less than full feature additions
- Check your balance on the credits page
Can't log in
Can't log in
- Check your email address is correct
- Try resetting your password
- Clear browser cookies and try again