Scoped Build Runner
Run Dart build_runner scoped to a single file — no more waiting for full-project builds.
Features
- Single-file builds — Run
build_runner build filtered to just the file you're working on
- Single-file watch — Watch mode scoped to a single file for fast iterative development
- Full-project build — Run
build_runner build across the entire project when needed
- Part file navigation — Quickly jump to generated
.g.dart, .freezed.dart, and other part files
- Delete generated files — Remove stale generated part files for the current file
- FVM support — Automatically uses
fvm dart when enabled (disabled by default — enable via settings)
- Monorepo support — Finds the nearest
pubspec.yaml for each file, works in nested packages
- Status bar indicator — See when
build_runner watch is active and click to stop it
- Keyboard shortcuts — Default keybindings for fast access
Commands
| Command |
Title |
Shortcut |
scopedBuildRunner.run |
Run build_runner |
Cmd+Alt+B (Mac) / Ctrl+Alt+B |
scopedBuildRunner.watch |
Watch build_runner |
Cmd+Alt+W (Mac) / Ctrl+Alt+W |
scopedBuildRunner.runAll |
Run build_runner (full project) |
— |
scopedBuildRunner.goToPartFile |
Go to generated part file |
— |
scopedBuildRunner.deleteGenerated |
Delete generated files |
— |
Settings
| Setting |
Type |
Default |
Description |
scopedBuildRunner.useFvm |
boolean |
false |
Use fvm to run dart commands |
scopedBuildRunner.deleteConflictingOutputs |
boolean |
true |
Pass --delete-conflicting-outputs to build_runner |
scopedBuildRunner.showGoToPartFile |
boolean |
false |
Show "Go to generated part file" in the explorer context menu |
scopedBuildRunner.showDeleteGenerated |
boolean |
false |
Show "Delete generated files" in the explorer context menu |
Usage
Right-click any .dart file in the Explorer to access:
- Run build_runner — one-time build filtered to this file
- Watch build_runner — continuous watch filtered to this file
- Go to generated part file — open related generated files (opt-in via settings)
- Delete generated files — remove generated part files (opt-in via settings)
Command Palette
Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "build_runner" to see all available commands.
Keyboard Shortcuts
Cmd+Alt+B / Ctrl+Alt+B — Run build_runner for the active fileCmd+Alt+W / Ctrl+Alt+W — Watch build_runner for the active file
Status Bar
When build_runner watch is active, a status bar item appears showing $(eye) build_runner. Click it to stop the watch.
Requirements
- A Dart or Flutter project with
build_runner in dev_dependencies
- FVM (optional, disabled by default — enable via settings)
License
MIT
| |
