Build Web Job | FlightStack

Build Web Job

Compiles your Flutter app for the web and uploads the resulting bundle as an artifact for the Deploy Web job (or for download).

Step ref: flightstack/build-web@1.0.0.

Requirements

Any platform agent (web builds run on macOS, Linux, or Windows).
Flutter SDK with web enabled. The agent verifies this at registration time.

Configuration

Option	Description	Default
Build Mode	`release`, `profile`, `debug`	`release`
Target	Entry-point file	`lib/main.dart`
Renderer	`canvaskit`, `html`, or `auto`	`auto`
Base href	URL path the app is served from (e.g. `/app/`)	`/`
PWA strategy	`offline-first`, `none`	`offline-first`
Flavor	Flutter flavor (`--flavor`)	—
Dart defines	List of `KEY=value` injected at build time	—
Source maps	Emit source maps for release builds	`false`

Build command

flutter build web \
  --release \
  --web-renderer canvaskit \
  --base-href "/" \
  --pwa-strategy offline-first \
  --dart-define=ENV=prod

Artifacts

Artifact	Location
Web bundle	`build/web/` (zipped)

The bundle is uploaded as web-release.zip and is consumed downstream by Deploy Web or any custom shell step.

Example pipeline

┌──────────┐    ┌───────────┐    ┌────────────┐
│ On Push  │───▶│ Build Web │───▶│ Deploy Web │
└──────────┘    └───────────┘    └────────────┘

Troubleshooting

“Web is not enabled for this Flutter SDK” The agent needs flutter config --enable-web. Re-register the agent so its capability is updated, or run flightstack agent doctor.

Slow CanvasKit cold start Switch to --web-renderer html for marketing pages; use canvaskit for heavy graphics.