The App Blink Doctor diagnostic engine inspects your development workstation's toolchain, identifying missing SDKs, outdated binaries, and broken paths before they disrupt your build or deployment pipelines.
Unlike manual terminal debugging across various SDK commands (flutter doctor, firebase --version, fastlane --version, node -v), App Blink Doctor performs a single consolidated verification directly within your editor.
π Diagnostic Checklist
When you run App Blink: Run Doctor Diagnostics, the engine checks the following subsystems:
| Toolchain | Minimum Required Version | What Doctor Inspects |
|---|---|---|
| Flutter SDK | 3.24.0+ |
Dart SDK path, channel stability, mobile compilation targets |
| Node.js | 18.0.0+ |
Node runtime for Angular and Cloud Functions |
| Package Managers | pnpm 9+ or npm 10+ |
Workspace lockfiles and package resolution |
| Firebase CLI | 13.0.0+ |
firebase-tools global binary and active authenticated user |
| Fastlane | 2.210.0+ |
Bundler / Fastlane binary for Google Play Supply and Apple Pilot |
| CocoaPods | 1.14.0+ |
Pod binary for iOS native dependency resolution |
| Android Toolchain | JDK 17+ & Android SDK 34+ | JAVA_HOME, ANDROID_HOME, and platform-tools |
| Git | 2.30.0+ |
Repository clean status, remotes, and active branch |
π How to Run Doctor
Via Command Palette
1. Press `Cmd+Shift+P` (macOS) or `Ctrl+Shift+P` (Windows/Linux). 2. Type **App Blink: Run Doctor Diagnostics** and hit `Enter`. 3. An output channel opens displaying color-coded diagnostic results.Via Sidebar
1. Open the App Blink sidebar. 2. In the **Services** panel header, click the **Doctor** icon (`$(stethoscope)`).π οΈ Interpreting Doctor Output
[App Blink Doctor] Running diagnostic suite for: my-workspace
------------------------------------------------------------------
β Node.js: v20.12.2 (/usr/local/bin/node)
β Package Manager: pnpm v9.1.0 (/usr/local/bin/pnpm)
β Flutter SDK: 3.24.3 (Dart 3.5.3) channel stable
β Firebase CLI: 13.15.1 (Logged in as: dev@company.com)
β Fastlane: 2.220.0 (/usr/local/bin/fastlane)
β CocoaPods: 1.15.2 (/usr/local/bin/pod)
β Java Environment: OpenJDK 17.0.10 (JAVA_HOME set)
β Git: 2.44.0 (Working directory clean)
------------------------------------------------------------------
Result: 8/8 Passed. All systems ready for mobile & web deployment.
Automatic Recovery Actions
If any tool is missing or misconfigured, App Blink Doctor provides direct actionable fix buttons:- Missing Firebase CLI: Click Install Firebase Tools to automatically run
npm install -g firebase-tools. - Outdated Dependencies: Click Install Workspace Dependencies (
appblink.installDependencies) to executepnpm installorflutter pub get. - Missing CocoaPods: Click Fix Pods to clean and reinstall iOS Podfiles.
π€ Agent Execution Specification
Autonomous coding agents can invoke doctor diagnostics using the command ID:
{
"command": "appblink.doctor",
"category": "App Blink",
"expectedOutput": "Diagnostic summary channel populated with subsystem statuses."
}