Troubleshooting
Common issues and solutions when using App Factory.
Common Issues
Claude Code doesn't recognize the repository
Symptoms
- • Claude doesn't understand the App Factory pipeline
- • Responses don't follow the expected workflow
Solutions
- • Ensure you're in the AppFactory/the_factory directory
- • Verify CLAUDE.md exists in the repository root
- • Try reopening the repository in Claude Code
Pipeline fails mid-build
Symptoms
- • Build process starts but stops before completion
- • Error messages about missing or incomplete specifications
Solutions
- • Review the error message for specific issues
- • Try describing your app more clearly with additional details
- • Check that Claude Code has the required API access
Generated app won't start
Symptoms
- • Expo CLI throws errors on start
- • Metro bundler fails to compile
Solutions
- • Delete node_modules and run 'npm install'
- • Run 'npx expo install --check' to fix dependency versions
- • Check app.json for valid configuration
- • Ensure bundle identifier is properly set
RevenueCat integration issues
Symptoms
- • Paywall doesn't load offerings
- • Purchase flow fails silently
Solutions
- • Verify EXPO_PUBLIC_REVENUECAT_API_KEY is set
- • Check RevenueCat dashboard for product configuration
- • Ensure offerings are properly set up in RevenueCat
- • Review the generated services/revenuecat.ts file
iOS Simulator won't launch
Symptoms
- • Simulator list is empty
- • App doesn't appear on simulator
Solutions
- • Ensure Xcode is installed from App Store
- • Install iOS simulators via Xcode > Preferences > Components
- • Run: xcrun simctl list devices iOS available
- • Boot a simulator manually: xcrun simctl boot 'iPhone 16 Pro'
Missing assets in generated app
Symptoms
- • App icon or splash screen not showing
- • Image assets appear broken
Solutions
- • Check the assets/ directory in your build folder
- • Verify icon.png and splash.png exist and are valid images
- • Run 'npx expo prebuild --clean' to regenerate native projects
Getting Help
If you're still stuck after trying the solutions above: