Vibe Checks are App Blink's automated code-quality guardrails. While traditional linters only catch syntax errors and formatting issues, Vibe Checks validate high-level architectural patterns, monorepo DRY policies, and state lifecycle rules.


πŸ›‘οΈ Core Built-In Vibe Checks

App Blink ships with built-in guardrails tailored for Flutter, Angular, and Firebase:

1. Monorepo DRY (Don't Repeat Yourself) Policy

* **Rule**: Developers and AI agents must check shared packages (`workern_widgets`, `angular/packages/components`) before writing a new UI component. * **Violation Example**: Creating a custom rating star widget inside an app when a standardized rating component already exists in the shared package.

2. Flutter State Lifecycle & Notifier Cleanup

* **Rule**: All `ChangeNotifier`, `ValueNotifier`, and stream controllers created in providers must implement explicit disposal or cleanup to avoid memory leaks. * **Auto-Fix**: Generates proper dispose methods and session teardown hooks.

3. Angular Signal & Standalone Standards

* **Rule**: Components must be standalone, use `@angular/core` signals for local state, and avoid legacy NgModules. * **Violation Example**: Unnecessary subscription management instead of `toSignal()` or computed values.

4. Firebase Function Security Guards

* **Rule**: All callable Cloud Functions must enforce authentication checks (`request.auth != null`) and input schema validation before executing database transactions.

πŸ“Š Vibe Check Coverage Studio

To inspect rule compliance across your entire workspace:

  1. Open the sidebar and find the Vibe Check Coverage webview (appBlinkVibeCheckCoverage).
  2. The interactive matrix displays:
    • Total files evaluated vs passing files.
    • Breakdown by framework (Flutter, Angular, Cloud Functions).
    • Exact lines of code violating specific guardrails.
    • 1-Click AI Fix: Prompts an AI agent to automatically refactor the file into compliance.

πŸ”’ Pre-Commit & Task Enforcement

You can configure Vibe Checks to run automatically before Git commits or task completions:

  • In Settings: Enable appblink.vibecheck.requireBeforeCommit: true.
  • In Agent Workflows: When using #appblink_task_complete, the extension verifies that #appblink_vibecheck_complete returned a passed status before staging code changes.