shotops-mcp 0.9.5 → 0.9.7

package/README.md

@@ -86,11 +86,14 @@ The key is never copied, printed, or sent to ShotOps, and no release tool is ins
   `text` (and a single caption's `subtitle`) is per-RENDER input (never stored — a look carries
   styling only). Captions auto-layout in a band at the top of the panel, and the device does NOT
   move to make room.
-- **`style.layout`** — the panel **composition** in one word: `"standard"`, `"bleed"`, or
-  `"top-bleed"`. It settles the headline's reserved region, device placement, camera pose, and
-  roll together. `standard` (the shipped default) puts the whole device
-  under a 2-line region — about 36 characters — and crops nothing; `bleed` reserves 4 lines (~72
-  characters) and runs the device 10% off the bottom edge. The region is **reserved, not fitted**:
+- **`style.layout`** — the panel **composition** in one word: `"standard"`, `"bleed"`, `"top-bleed"`,
+  `"lean-right"`, `"lean-left"`, `"swipe"` or `"corner-bleed"`. It settles the headline's reserved
+  region, device placement, camera pose, and roll together. `standard` (the shipped default) puts
+  the whole device under a 2-line region — about 36 characters — and crops nothing; `bleed` reserves
+  4 lines (~72 characters) and runs the device 10% off the bottom edge. The last four run it off a
+  SIDE edge instead, into the neighbouring screenshot, so the set reads as one continuous swipe —
+  pick one for **every** panel or none, and never mirror `lean-right` against `lean-left`, which
+  puts two devices into the same seam. The region is **reserved, not fitted**:
   it is held at full size whether or not the headline fills it, which is what makes every panel in
   a swiped set land on the same line. **Precedence** — the template expands *first*, then any
   explicit `shotLook` composition field or caption layout field you also pass **overrides** it
@@ -292,8 +295,8 @@ screenshot unavailable; public privacy disclosures must accurately state this re
    shown once — copy it then.
 2. **Supabase service env** (already in the repo's `.env.local` for local dev): `SUPABASE_URL`
    and `SUPABASE_SERVICE_ROLE_KEY`. The server loads `../.env.local` automatically.
-3. Playwright's Chromium (installed with the package; run `npx playwright install chromium`
-   once if it's missing).
+3. Playwright's Chromium. The first render downloads it automatically into Playwright's cache if
+   it's missing; run `npx playwright install chromium` first to skip that one-time wait.
 
 ## Run it
 
@@ -303,7 +306,8 @@ npm install
 npm run dev            # boots on http://localhost:8788/mcp  (override with MCP_PORT)
 ```
 
-Chromium boots lazily on the first `render_strip` / `emit_bundle` call, so startup is fast.
+Chromium boots lazily on the first `render_strip` / `emit_bundle` call, so startup is fast — and
+that first render also installs Chromium if it isn't cached yet, adding ~20-25s to that one call.
 `GET /health` is an unauthenticated liveness probe.
 
 ## Connect ChatGPT (Developer Mode)
@@ -419,13 +423,26 @@ the transport and a few account-shaped tools differ.
 claude mcp add shotops -- npx -y shotops-mcp
 ```
 
-One-time setup: Chromium isn't bundled in the npm package (it's ~150MB) — Playwright downloads
-it on first run, or install it explicitly:
+Chromium isn't bundled in the npm package (it's ~150MB). The first render on a machine without
+Playwright's Chromium installs it automatically into Playwright's cache, then renders. That first
+render takes ~20-25s longer, and its result `note` says so. Install it ahead of time to skip the wait:
 
 ```bash
 npx playwright install chromium
 ```
 
+Offline, that automatic download fails and the first render refuses with `upstream_unavailable`
+until you're back online.
+
+### Claude Desktop (macOS and Windows)
+
+The same local server ships as a Claude Desktop extension, no terminal needed. Download
+**<https://shotops.dev/download/shotops.mcpb>** (always the latest version; a specific one is
+`shotops-mcp-<version>.mcpb` beside it) and double-click it. Leave the **ShotOps API token**
+setting empty to preview free without an account, or paste a token from the Studio app → account
+menu → **API tokens** to save projects and looks. The extension bundles everything except
+Chromium, which the first render downloads once as described above.
+
 **Screenshots are read straight off your disk** — no upload dance. Pass a local file path
 instead of `{ ref }`/`{ url }`: