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 execute pnpm install or flutter 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."
}