Skip to content

ci: deploy to Cloudflare Workers with GitHub Actions - #139

Merged
rtomas merged 2 commits into
docs/v3from
ci/cloudflare-deploy-workflow
Oct 21, 2026
Merged

rtomas merged 2 commits into
docs/v3from
ci/cloudflare-deploy-workflow

Conversation

@arminx86-77616c

Copy link
Copy Markdown
Contributor

What

Adds a Deploy workflow so docs/v3 can be QA'd on docs-next.walletconnect.com, with a preview URL for every PR.

  • Push to docs/v3: pnpm build, then wrangler deploy to the walletconnect-docs Worker. Terraform binds that Worker to docs-next.walletconnect.com (WalletConnect/infra#618).
  • Same-repo PRs: wrangler versions upload --preview-alias pr-<N>, then a PR comment with the preview URL. PRs from forks are skipped because they get no secrets.
  • wrangler.jsonc: sets workers_dev and preview_urls explicitly (preview URLs live on workers.dev). Notes that custom domains are owned by Terraform, so no routes here.
  • README and AGENTS.md: replace the Workers Builds references with this workflow.

Uses the CLOUDFLARE_API_TOKEN secret and the CLOUDFLARE_ACCOUNT_ID variable on this repo. The token is scoped to the Reown account with Workers Scripts Edit and Account Settings Read only.

Required before this can pass (on docs/v3, not in this PR)

  1. Commit public/. .gitignore line 100 (public, an old Gatsby rule) ignores it, so images, logos and the favicon exist only locally. A CI build has 94 broken /images/... references.
  2. Commit pnpm-lock.yaml. It is in .gitignore, and the workflow runs pnpm install --frozen-lockfile.

Please do not

  • Connect Workers Builds in the Cloudflare dashboard as well. Two deployers on one Worker overwrite each other.
  • Merge docs/v3 into main before the cutover. Mintlify still builds docs.walletconnect.com from main.

At cutover

Change branches: [docs/v3] to [main] in deploy.yml, together with the infra PR that moves docs.walletconnect.com from Mintlify to the Worker.

Suggested follow-ups (not in this PR)

  • Send X-Robots-Tag: noindex from worker/index.ts when the host is not docs.walletconnect.com.
  • update-specs.yml still adds Mintlify paths (api/, docs.json) that no longer exist on v3.
  • Mintlify serves sitemap.xml, robots.txt and an MCP server at /mcp today. v3 has none of them.

Verify after the first deploy

curl -sI https://docs-next.walletconnect.com/ | head -1
curl -sI https://docs-next.walletconnect.com/images/app-id-1.png | head -1
curl -sI https://docs-next.walletconnect.com/api-reference/foo | grep -i location
curl -s  https://docs-next.walletconnect.com/wallets/android/usage.md | head -3
curl -sI https://docs-next.walletconnect.com/nope | head -1

🤖 Generated with Claude Code

arminx86-77616c and others added 2 commits October 21, 2026 15:58
Pushes to docs/v3 run wrangler deploy (served at docs-next.walletconnect.com).
Same-repo PRs upload a version with a pr-<N> preview alias and comment the URL.
Replaces the Workers Builds references in README and AGENTS.md.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@arminx86-77616c arminx86-77616c self-assigned this Oct 21, 2026
@rtomas
rtomas merged commit cfbf159 into docs/v3 Oct 21, 2026
1 of 2 checks passed
@rtomas
rtomas deleted the ci/cloudflare-deploy-workflow branch October 21, 2026 14:55
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.

2 participants