screenshot

Screenshot

Capture a screenshot of a URL or route. Nothing else — no tables, no analysis, just the image.

Arguments

• {url-or-route} — URL or route path (default: /). If starts with /, prepends http://localhost:{DEV_PORT}.
• --mobile — Resize viewport to 375x667 (iPhone SE) before capturing
• --no-auth — Skip authentication (use for login page or public pages)

Configuration

Read cloudstack.json from the project root at the start of execution. Extract:

• FRONTEND_PATH = frontend.path (default: web)
• DEV_PORT = frontend.devPort (default: 5173)
• UI_LIBRARY = frontend.uiLibrary (default: shadcn)
• STATE_SERVER = frontend.stateManagement.server (default: tanstack-query)
• STATE_CLIENT = frontend.stateManagement.client (default: zustand)
• MULTI_TENANT = backend.multiTenancy (default: false)

If cloudstack.json does not exist, auto-detect by checking package.json dependencies.

Auth Configuration

Check cloudstack.json for localDev.authConfig:

{
  "localDev": {
    "authConfig": {
      "storageKey": "auth-storage",
      "state": {
        "isAuthenticated": true,
        "token": "dev-token"
      }
    }
  }
}

If localDev.authConfig is not present, use a generic dev auth pattern:

1. Check for an auth store file (e.g., auth-store.ts, useAuthStore.ts) to find the localStorage key and expected shape
2. Fall back to injecting: localStorage.setItem('auth-storage', JSON.stringify({ state: { isAuthenticated: true }, version: 0 }))

Process

Step 1: Resolve URL

If the argument starts with /, prepend http://localhost:{DEV_PORT}. Otherwise use the full URL as-is.

Step 2: Authenticate (unless --no-auth)

Skip this step if --no-auth is passed or the URL is not on localhost:{DEV_PORT}.

Navigate to http://localhost:{DEV_PORT} first to establish the origin, then inject auth via localStorage.

If localDev.authConfig is defined in cloudstack.json, use that directly:

localStorage.setItem('{storageKey}', JSON.stringify({authConfig.state}))