docs(scripts): add Playwright screenshot capture scaffolding

[rodrigopavezi]

Adds the infrastructure for capturing Dashboard and Secure Payment screenshots
into images/dashboard/ and images/secure-payments/ for the new use-case and
tools pages. Screenshots themselves are not committed — run the script
locally once the services are up.

Bring-up path: reuse the existing docker-compose.local.yml in request-e2e-tests
(brings up postgres × 2, redis × 2, migrations, and all four services with
healthchecks and proper wiring). Then point DASHBOARD_URL and SECURE_PAYMENT_URL
at it and run pnpm capture-screenshots.

Wallet-gated screens (Dashboard interior, payment options, success) are
flagged as MANUAL by the script and need either an AUTH_STATE storage dump
or, ideally, a separate "screenshots" Playwright project inside
request-e2e-tests that drives the existing dashboard.helpers.ts /
payment.helpers.ts (TODO).

Files:

• package.json — playwright, sharp, tsx, @types/node, typescript
• tsconfig.json — strict ESM config for the script
• scripts/capture-screenshots.ts — capture entry point, no default URLs
  (refuses to run without explicit DASHBOARD_URL and SECURE_PAYMENT_URL)
• .gitignore — exclude node_modules, auth-state.json, lockfiles

[rodrigopavezi]

• docs(review): apply Tristan's two must-fix items from the final review #97
• docs(review): address Greptile review feedback across the stack #96
• docs(feedback): apply Tristan's revisions from RequestNetwork/request-api#806 #95
• docs(kyt): document KYT-screened payments as a use case + payee-destination field #94
• docs(secure-payments): document redirectUrl + redirectLabel #93
• docs(verify): fix broken cross-refs surfaced by mintlify broken-links #92
• docs(scripts): add Playwright screenshot capture scaffolding #91 👈 (View in Graphite)
• docs(content): add use-case pages, Dashboard + Secure Payment tools pages #90
• docs(content): refresh Tron coverage, batch-payment EVM scope, webhook 12-event list #89
• docs(nav): restructure navigation, remove legacy pages, retire Portal #88
• docs: fix broken links and clarify edge cases #87
• docs: add missing feature documentation for recent API changes #86
• docs: fix implementation discrepancies across API docs #85
• docs: remove beta banner and legacy SDK tab #78
• Remove AI-generated content warnings and update internal links #77
• docs(lifecycle): replace external image with local asset and remove AI-generated warning #76
• docs: remove AI-generated content warnings and simplify Request Scan page #75
• docs(resources): remove community page from navigation #74
• docs(supported-chains): add Tron network support and enhance currency documentation #73
• docs(supported-chains): streamline supported chains and currencies documentation #72
• docs(api-reference): add v2 endpoints overview and switch docs OpenAPI to v2-only spec Improve API Reference navigation by introducing a dedicated Endpoints Overview page in docs and wiring Mintlify OpenAPI rendering to a local v2-only spec. - add `api-re #71
• docs(authentication): simplify auth guide with API key vs Client ID methods and remove AI-generated content #70
• docs(fee-breakdowns): rewrite to focus on API response locations and reconciliation usage #69
• docs(protocol-fees): add protocol fees documentation and navigation #68
• docs(platform-fees): simplify configuration guide and remove AI-generated content warning #67
• docs(query-payments): rewrite with practical implementation focus and remove AI warning #66
• docs(query-requests): simplify and refactor query requests documentation for practical implementation #65
• docs(payment-detection): simplify content and remove AI warning #64
• docs(partial-payments): rewrite with step-by-step implementation guide and clarify API usage #63
• docs(standard-payments): remove AI warning, restructure content with step-by-step flow, and update API references #62
• docs(conversion-payments): rewrite with step-by-step implementation guide and remove AI-generated warning #61
• docs(payment-types): simplify overview and add payment type selection guidance #60
• docs(crypto-to-fiat): expand comprehensive guide with sandbox access, compliance flows, and implementation details #59
• docs(recurring-payments): rewrite with comprehensive workflow, security details, and practical implementation guide #58
• docs(batch-payments): add comprehensive implementation guide with examples, workflow diagrams, and demo videos #57
• docs(crosschain-payments): replace AI-generated content with comprehensive implementation guide #56
• docs(create-requests): rewrite with workflows, examples, and remove AI warning #55
• feat: add complete integration tutorial with Node.js backend and React frontend #54
• docs(getting-started): remove AI warning and refactor to focus on practical payment integration #53
• docs(api-portal): remove AI warning, add local screenshot, and update .gitignore #52
• docs: remove release notes section and streamline use cases to core features #51
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[greptile-apps]

Greptile Summary

This PR adds Playwright-based screenshot capture scaffolding (scripts/capture-screenshots.ts, package.json, tsconfig.json) for generating Dashboard and Secure Payment images used in the Mintlify docs. Screenshots are not committed; the script is run locally against the request-e2e-tests Docker stack, and wallet-gated screens are flagged as MANUAL.

• capture-screenshots.ts: Iterates over a declared shot list, navigates each URL, runs an optional setup interaction, and saves a .webp via sharp. Wallet-gated shots require AUTH_STATE or are printed as MANUAL lines.
• package.json / tsconfig.json: Introduces playwright, sharp, and tsx as dev dependencies under a strict ESM TypeScript config — @playwright/test duplication is being removed in sibling PR docs(review): address Greptile review feedback across the stack #96.
• .gitignore: Excludes node_modules/, auth-state.json, and lockfiles, consistent with the repo's existing convention.

Confidence Score: 5/5

Safe to merge — this is additive scaffolding with no impact on existing docs content or CI pipelines.

All four files are net-new additions (or appendages to .gitignore). The script only runs locally on developer machines when explicitly invoked with both DASHBOARD_URL and SECURE_PAYMENT_URL set. No existing behaviour is altered.

No files require special attention; the two minor logic issues in scripts/capture-screenshots.ts affect only the clarity of the run summary output, not correctness of the captured screenshots.

Important Files Changed

Filename	Overview
scripts/capture-screenshots.ts	New screenshot-capture script; two minor logic issues: skipped shots miscounted as manual, and browser not closed in a finally guard.
package.json	Introduces new package.json for the tooling; still lists @playwright/test alongside playwright (addressed in sibling PR #96).
tsconfig.json	Strict ESM TypeScript config targeting ES2022 with bundler resolution — appropriate for tsx-executed scripts.
.gitignore	Adds node_modules, auth-state.json, and lockfile exclusions consistent with the repo's existing convention.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
A([pnpm capture-screenshots]) --> B{DASHBOARD_URL &\nSECURE_PAYMENT_URL set?}
B -- No --> C[Print error & exit 2]
B -- Yes --> D[chromium.launch]
D --> E[Iterate shots\ndashboardShots + securePaymentShots]
E --> F{needsAuth\n&& !AUTH_STATE?}
F -- Yes --> G[Log MANUAL:\nreturn 'manual']
F -- No --> H[page.goto url]
H --> I{setup\ndefined?}
I -- Yes --> J[Run setup fn]
J --> K{returns false?}
K -- Yes --> L[Log SKIP:\nreturn 'manual']
K -- No --> M[waitForTimeout 800ms]
I -- No --> M
M --> N[page.screenshot PNG]
N --> O[sharp to .webp quality 88]
O --> P[Write to images/]
P --> Q[Log OK: return 'ok']
G & L & Q --> R{More shots?}
R -- Yes --> E
R -- No --> S[browser.close]
S --> T[Print summary]
T --> U{fail > 0?}
U -- Yes --> V[exit 1]
U -- No --> W[exit 0]

Loading

_{Reviews (2): Last reviewed commit: "docs(scripts): add Playwright screenshot..." | Re-trigger Greptile}

[rodrigopavezi]

Merge activity

• May 12, 4:02 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• May 12, 5:12 PM UTC: Graphite rebased this pull request as part of a merge.
• May 12, 5:12 PM UTC: @rodrigopavezi merged this pull request with Graphite.