Engineering GuidesTroubleshooting & FAQ
Diagnostics & Solutions
Troubleshooting & FAQ
Quick answers and diagnostic tooling to resolve environment, routing, and build issues.
Running Diagnostics (bloom doctor)
Run bloom doctor to verify Dart SDK, Flutter toolchains, Android SDK, and Xcode setups:
Terminal
bash
Frequently Asked Questions
Why is my new route in lib/routes/ not resolving?
Run bloom dev or bloom generate to trigger AST route generation. Bloom will compile the new route into lib/app/routes.g.dart automatically.
How do I pass parameters to modal dialogs?
Use BloomDialog.show(context, builder: (ctx) => MyDialog(param: value)) or pass route query parameters in the URL scheme.
Can I use Bloom UI components in a non-Bloom Flutter app?
Yes! Install bloom_ui from pub.dev and import the components directly. Bloom UI has zero framework runtime dependencies and works in any standard Flutter project.
What should I do if native permissions fail on iOS?
Ensure your permission string in bloom.yaml is declared with a descriptive message, then run bloom prebuild to re-sync ios/Runner/Info.plist.