Error reference
Every coded error the Catalyst framework can emit. Each entry is the same content shown by the Docs: link printed alongside the error in your terminal.
AI
- AI provider request failedAI-000
- AI is disabledAI-001
- AI provider not configuredAI-002
- Invalid AI request bodyAI-003
- Native AI bridge unavailableAI-004
- Native AI stream not readyAI-005
- Native AI request failedAI-006
- Native AI reported an errorAI-007
- Web AI worker unavailableAI-008
- Web AI worker crashedAI-009
ANDROID
- Android build failed in an upstream toolchain stepANDROID-000
- Timed out waiting for the Android emulator to bootANDROID-001
- No upload key for the release buildANDROID-005
- Upload key settings are incomplete or wrongANDROID-006
- No JDK 17 to 23 foundANDROID-007
- Android SDK setup was declinedANDROID-008
- Could not install the Android command-line toolsANDROID-009
- App icon is not usableANDROID-010
- No Android phone connectedANDROID-011
BUNDLE
CCA
- An upstream command failedCCA-000
- Invalid project nameCCA-001
- Target directory already existsCCA-002
- Invalid language optionCCA-003
- Invalid state management optionCCA-004
- Invalid --yes optionCCA-005
- Failed to pack create-catalyst-appCCA-006
- Failed to extract template filesCCA-007
- MCP server setup failedCCA-008
- .gitignore already existsCCA-009
IOS
- iOS build failed in an upstream toolchain stepIOS-000
- Could not find an installed iOS Simulator appIOS-001
- Full Xcode is not installed or selectedIOS-002
- Xcode setup is not finishedIOS-003
- No iOS simulator runtime installedIOS-004
- App icon is not usableIOS-005
- App icon has transparencyIOS-006
- iOS code signing is not set upIOS-010
- App Store Connect API key settings are incomplete or wrongIOS-011
- Manual signing inputs are incomplete or wrongIOS-012
- Unknown iOS export methodIOS-013
- No connected iPhone foundIOS-014
- No address the iPhone can reach this Mac onIOS-015
NATIVE
- Release build points at a local or private hostNATIVE-001
- Invalid build numberNATIVE-002
- Release build uses a placeholder app idNATIVE-003
- Invalid production URLNATIVE-004
- A step needs your answer and there is no terminal to ask onNATIVE-005
- The dev server did not answerNATIVE-006
- The credentials secret could not be unpackedNATIVE-007
- No credentials to exportNATIVE-008
- Credentials are too large for one secretNATIVE-009
- Invalid app idNATIVE-010
- A release with this version and build number already existsNATIVE-011
PREFLIGHT
- config not found in config folderPREFLIGHT-001
- config export is not an objectPREFLIGHT-002
- required key missing inside config.jsonPREFLIGHT-003
- package.json not found in the projectPREFLIGHT-004
- package.json should be defined in project root directoryPREFLIGHT-005
- moduleAliases not found in package.jsonPREFLIGHT-006
- moduleAliases named object should be exported from package.jsonPREFLIGHT-007
- catalyst keyword is restricted for defining aliasesPREFLIGHT-008
- required module alias not defined inside package.jsonPREFLIGHT-009
- preServerInit named function should be defined in server/index.jsPREFLIGHT-010
- preServerInit should be a function present in server/index.jsPREFLIGHT-011
- addMiddlewares named function not found in server/server.jsPREFLIGHT-012
- addMiddlewares should be a function present in server/server.jsPREFLIGHT-013
- reducer not found in src/js/containers/App/reducerPREFLIGHT-014
- reducer should be present in src/js/containers/App/reducerPREFLIGHT-015
- configureStore not found in file src/js/store/index.jsPREFLIGHT-016
- configureStore should be a function exported from src/js/store/index.jsPREFLIGHT-017
- getRoutes not found in file src/js/routes/utils.jsPREFLIGHT-018
- getRoutes should be a function exported from src/js/routers/index.jsPREFLIGHT-019
- document not found in file server/document.jsPREFLIGHT-020
- document should be a react component exported from server/document.jsPREFLIGHT-021
- The build is stale: config/config.json changed since it was builtPREFLIGHT-022
PROCESS
RUNTIME-NATIVE
- Permission deniedRUNTIME-NATIVE-001
- Permission requiredRUNTIME-NATIVE-002
- No internet connectionRUNTIME-NATIVE-003
- Download failedRUNTIME-NATIVE-004
- File not foundRUNTIME-NATIVE-005
- File too largeRUNTIME-NATIVE-006
- Storage fullRUNTIME-NATIVE-007
- File corruptedRUNTIME-NATIVE-008
- Operation cancelledRUNTIME-NATIVE-009
- No file selectedRUNTIME-NATIVE-010
- Invalid file typeRUNTIME-NATIVE-011
- Invalid parametersRUNTIME-NATIVE-012
- Native feature unavailableRUNTIME-NATIVE-013
- Feature not supportedRUNTIME-NATIVE-014
- An unexpected error occurredRUNTIME-NATIVE-015
- Camera unavailableRUNTIME-NATIVE-016
- Camera in useRUNTIME-NATIVE-017
- Invalid callback interfaceRUNTIME-NATIVE-018
- No handler registered for this bridge interfaceRUNTIME-NATIVE-019
- A registered bridge callback handler threwRUNTIME-NATIVE-020
- Invalid bridge callback registrationRUNTIME-NATIVE-021
- WebBridge could not be initializedRUNTIME-NATIVE-022