boot-gate

Validate Capacitor, React, and Vite app boot and rendering with Playwright.

Updated May 30, 2026
One-click install
npx skills add https://github.com/InnerScopeHearing/otchealth-claude-tools --skill boot-gate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: boot-gate
Source: https://github.com/InnerScopeHearing/otchealth-claude-tools/tree/main/skills/boot-gate
Command: npx skills add https://github.com/InnerScopeHearing/otchealth-claude-tools --skill boot-gate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @playwright/test, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the issue of apps failing to boot or render correctly on devices, which can be missed during development. It fills the gap between passing unit tests and ensuring the app's UI actually loads and functions as expected.

Core Features & Use Cases

  • Boot Smoke Test: Validates that the app boots without errors and reaches an interactive screen within a specified time frame.
  • Visual Walkthrough: Captures screenshots of each screen and checks for flat-color issues, ensuring the UI is not stuck on a blank or single-color screen.
  • Build Environment Check: Ensures that required environment variables are set correctly before the build process.
  • Error Boundary: Provides a visible fallback UI in case of boot errors, improving user experience and debugging.
  • Use Case: Use this Skill before deploying a new app version to ensure that it boots and renders correctly on both web and iOS platforms.

Quick Start

Run the boot smoke test on your app by executing the command: npm run boot-smoke.

Frequently Asked Questions about boot-gate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate that my Capacitor React app boots without rendering errors?

To validate that a Capacitor React app boots without rendering errors, you can run an automated boot smoke test using Playwright to verify the app reaches an interactive state and correctly renders the UI.

What is the best way to check if a Vite app is stuck on a blank screen during boot?

The best way to check if a Vite app is stuck on a blank screen is to perform a visual walkthrough that captures screenshots of each screen and checks for flat-color rendering issues.

Do I need Playwright to run automated boot validation for React apps?

Yes, you need Playwright to run automated boot validation for React apps, as this Skill relies on the @playwright/test dependency to execute visual checks and verify rendering integrity.

How do I ensure required environment variables are set before building my Capacitor app?

To ensure required environment variables are set before building your Capacitor app, you can execute a build environment check that validates configurations and prevents faulty deployments.

Can I use boot validation to test app rendering on both web and iOS platforms?

Yes, you can use boot validation to test app rendering on both web and iOS platforms, ensuring the UI loads correctly and reaches an interactive state before deployment.

Why does my React app need an error boundary during the boot smoke test?

Your React app needs an error boundary during the boot smoke test to provide a visible fallback UI in case of boot errors, improving user experience and debugging.