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

Context Menu

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 file
• Cmd+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