What’s new
When Bitrise scans a Flutter project, it now detects web targets and uses that to shape the generated workflows. What you get depends on what your project actually targets. Whether your Flutter project targets web only or combines web with mobile, Bitrise now produces a config that matches your project, without manual cleanup.
What problem are we solving
When the Flutter scanner encountered a project with a web/ directory, it had no way to distinguish it from a mobile project. Web-only Flutter projects could end up with a build_app workflow that referenced native iOS and Android build steps, which simply do not apply to web targets. Teams building web-only Flutter apps had to manually strip out those steps or start from scratch, defeating the purpose of scanning.
On the other side, projects that combined mobile and web targets needed clarity: does web affect the build config, or just the test config? The answer was unclear, and the generated output didn’t help.
What the solution looks like
The scanner now checks for a web/ directory to determine whether a Flutter project has web support, then uses that signal to shape the generated workflows.
Web-only projects get a single run_tests workflow. There is no build_app workflow, because Web-only projects don’t need it. The workflow covers: SSH key activation, git clone, Flutter installer (version-pinned if detected), Dart cache restore, Flutter test or analyze, Dart cache save, and deploy to Bitrise.
Mobile + web projects get both run_tests and build_app. The build_app workflow is scoped entirely to the mobile targets. It includes certificate installer (iOS only), Flutter analyse, Flutter test, and Flutter-build with the platform set to iOS, Android, or both based on what was detected.
How to use it
No action is required. The next time you scan a Flutter project, the scanner will detect your web target automatically and generate the appropriate config.
If your project has a web/ directory, expect:
- Web-only: a single run_tests workflow with no build_app
- Mobile + web: run_tests and build_app, with build_app targeting your mobile platforms only
If you previously scanned a web-only project and received a build_app workflow, re-scanning will produce the corrected config. You can trigger a rescan from your app’s settings on Bitrise.
Docs