Add LATCHKEY_DISABLE_SPINNER env var for debugging

Add environment variable to disable the spinner overlay that hides
browser activity during credential finalization. This is useful for
debugging browser automation sequences.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-authored-by: Sculptor <sculptor@imbue.com>

Author: 3 people

docs/development.md

@@ -91,6 +91,13 @@ npx playwright codegen --target=javascript https://login-page.example.com/
 ```
 
 
+## Environment variables
+
+The following environment variables can be set for development and debugging:
+
+- `LATCHKEY_DISABLE_SPINNER=1`: Disables the spinner overlay that normally hides browser activity during credential finalization. Useful for debugging browser automation sequences.
+
+
 ## Style guidelines
 
 - Try to make new code look as similar to existing code as possible.

src/playwrightUtils.ts

@@ -159,8 +159,13 @@ function createSpinnerOverlayScript(serviceName: string): string {
 /**
  * Show a spinner overlay that hides page content from the user.
  * The overlay persists across page navigations within the browser context.
+ *
+ * Can be disabled by setting LATCHKEY_DISABLE_SPINNER=1 environment variable.
  */
 export async function showSpinnerPage(context: BrowserContext, serviceName: string): Promise<void> {
+  if (process.env.LATCHKEY_DISABLE_SPINNER === '1') {
+    return;
+  }
   const spinnerPage = await context.newPage();
   await spinnerPage.evaluate(createSpinnerOverlayScript(serviceName));
   await spinnerPage.bringToFront();