Skip to content

docs(gas-sponsorship): add dashboard guide for redesigned policies#1434

Draft
Richard-Dang wants to merge 1 commit into
mainfrom
rdang/TXE-308-gas-sponsorship-docs-guide
Draft

docs(gas-sponsorship): add dashboard guide for redesigned policies#1434
Richard-Dang wants to merge 1 commit into
mainfrom
rdang/TXE-308-gas-sponsorship-docs-guide

Conversation

@Richard-Dang

Copy link
Copy Markdown
Contributor

Summary

Adds a single-page walkthrough of the redesigned Gas Sponsorship dashboard and updates every stale legacy Gas Manager dashboard deep-link across content/ to the redesigned app-scoped /gas-sponsorship route.

Key changes

  • New content/wallets/pages/transactions/sponsor-gas/dashboard-guide.mdx: opening the surface, creating a policy via the 2-step modal, the four policy types and when to use each, per-type rule tabs, going live, and monitoring spend on the Usage tab.
  • Wire the guide into content/docs.yml under the Sponsor gas section, and link to it from sponsor-gas/overview.mdx (new Card) and the legacy setup-a-gas-manager-policy tutorial (Info pointer).
  • Update all ~46 stale legacy Gas Manager dashboard deep-links across 38 files (gas-policies/new, services/gas-manager/configuration, gas-manager, gas-manager/policy/create) to https://dashboard.alchemy.com/apps/latest/gas-sponsorship.

Technical details

The guide follows the wallet docs conventions (second person, "sponsor gas" terminology, relative /docs/... links, Steps for the create procedure). Policy-type labels and per-type tab sets are sourced from the dashboard code: PolicyType / POLICY_TYPE_LABELS in policyOptions.ts and getEditorTabIds in editorTabs.ts.

Screenshots: the guide embeds four screenshots of the redesigned surface (create type picker, create chain selection, ERC-20 editor, Usage tab) captured from the running redesigned dashboard with GasSponsorshipRedesignEnabled ON. The Cloudinary URLs are currently placeholders (v_TODO); the source PNGs are in the worktree under screenshots-todo/ (not committed) pending Cloudinary upload. Once uploaded, the four v_TODO URLs will be replaced with the secure Cloudinary URLs and the broken-links check re-run. Do not merge until the Cloudinary URLs are substituted.

Acceptance criteria

  • New single-page dashboard guide exists under content/wallets/pages/transactions/sponsor-gas/ and is wired into content/docs.yml under the Sponsor gas section
  • Guide walks through creating a policy and documents all 4 redesigned policy types (sponsorship, solana, erc20, bundler_sponsorship) with when-to-use guidance and the per-type rule tabs
  • Guide embeds fresh screenshots of the redesigned dashboard (flag ON) uploaded to Cloudinary, never committed to git — pending Cloudinary upload
  • All stale legacy dashboard deep-links in content/ updated to the redesigned /gas-sponsorship route
  • Broken-links check passes — pending Cloudinary URLs; will re-run pnpm lint:broken-links (needs .env) or verify via the PR preview once images are hosted

Docs-repo acceptance criteria (dashboard-tab wiring lives in the companion dashboard PR #8106):

  • Docs static checks pass: pnpm lint, pnpm validate:docs-yml, pnpm test:run

Testing

Static checks (all green): pnpm validate:docs-yml (docs.yml nav structure), pnpm test:run (vitest, 233 tests), pnpm run typecheck (tsc --noEmit), pnpm exec eslint and pnpm exec prettier --check over all 43 changed files.

Manual link verification: every new internal link resolves to an existing file (verified conditional-sponsorship-rules, pay-gas-with-any-token, solana, low-level-infra/gas-manager/policy-management/api-endpoints, and the new dashboard-guide slug against content/ and docs.yml). External dashboard links point at the canonical redesigned route. pnpm lint:broken-links requires .env (lychee + Algolia/Redis), so the final broken-link pass runs in the PR preview once the Cloudinary screenshot URLs are substituted.

New test files: none (MDX content; pnpm test:run covers existing scripts/utils and stays green).

Linear Task

TXE-308

Add a single-page walkthrough of the redesigned Gas Sponsorship dashboard
under sponsor-gas/dashboard-guide, covering opening the surface, creating a
policy, the four policy types and when to use each, per-type rule tabs,
going live, and monitoring spend on the Usage tab. Wire it into docs.yml
under the Sponsor gas section and link to it from the overview page and the
legacy gas-manager policy tutorial.

Update every stale legacy Gas Manager dashboard deep-link across content/
to the redesigned app-scoped /gas-sponsorship route.

Screenshot Cloudinary URLs are placeholders pending upload; source PNGs are
in the worktree under screenshots-todo/ (not committed).

Linear: TXE-308
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Jul 7, 2026, 11:38 PM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant