Repository navigation
chore: remove Netlify and Vercel config after the move to Cloudflare - #7060
Merged
Merged
Conversation
docs.cypress.io is served by the cypress-documentation Cloudflare Worker, so netlify.toml and vercel.json no longer configure anything. static/_redirects becomes the only redirect list: netlify.toml carried the same rules in the same order, and vercel.json's six were already in it. The contributor and agent guides now point at static/_redirects alone, and add the two placement rules Cloudflare needs: exact paths above the wildcards, and no new wildcard that overlaps another one. CONTRIBUTING describes the Cloudflare preview, and says that PRs from forks don't get one, so outside contributors know to check their changes locally. Comments that compared things to Netlify now say how they work today. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WUv8r4AAgMMw1DSbt1H69h
jennifer-shehane
force-pushed
the
claude/remove-netlify
branch
from
November 6, 2026 18:30
404dd51 to
4a02a8a
Compare
jennifer-shehane
marked this pull request as ready for review
November 6, 2026 18:30
cypress-documentation
 |
||||||||||||||||||||||||||||||||||||||||
| Project |
cypress-documentation
|
| Branch Review |
claude/remove-netlify
|
| Run status |
|
| Run duration | 02m 13s |
| Commit |
|
| Committer | Jennifer Shehane |
| View all properties for this run ↗︎ | |
| Test results | |
|---|---|
 |
0
|
 |
0
|
 |
0
|
 |
0
|
 |
427
|
| View all changes introduced in this branch ↗︎ | |
UI Coverage
32.85%
|
|
|---|---|
|
|
738
|
|
|
25
|
Accessibility
98.93%
|
|
|---|---|
|
|
2 critical
5 serious
4 moderate
1 minor
|
|
|
74
|
cypress-documentation
|
||||||||||||||||||||||||||||||||||||||||
| Project |
cypress-documentation
|
| Branch Review |
main
|
| Run status |
|
| Run duration | 02m 16s |
| Commit |
|
| Committer | Jennifer Shehane |
| View all properties for this run ↗︎ | |
| Test results | |
|---|---|
|
|
0
|
|
|
0
|
|
|
0
|
|
|
0
|
|
|
427
|
| View all changes introduced in this branch ↗︎ | |
UI Coverage
32.91%
|
|
|---|---|
|
|
737
|
|
|
26
|
Accessibility
98.9%
|
|
|---|---|
|
|
2 critical
6 serious
4 moderate
1 minor
|
|
|
153
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Note
Rebased onto
mainafter cypress-io/cypress-documentation#7059 merged. That PR's/app/cloud/*redirect, which the new guidance inAGENTS_REFERENCE.mdrefers to, is in place instatic/_redirects. After this merges, turn off the Netlify site (steps at the end).Summary
Removes the Netlify and Vercel hosting config now that docs.cypress.io is served by the
cypress-documentationCloudflare Worker.static/_redirectsbecomes the only redirect list. The contributor and agent guides, README, and code comments now describe the Cloudflare setup.Why
Production moved to Cloudflare in cypress-io/cypress-documentation#7058. Since then,
netlify.tomlandvercel.jsonconfigure hosts that no longer serve the site. While they stay in the repo, contributors are told to keep two redirect lists in sync, and the docs point outside contributors to Netlify preview links that will stop existing.We also decided that PRs from forks won't get preview links. The Cloudflare preview needs repository secrets that GitHub withholds from forks, and that's an acceptable tradeoff. CONTRIBUTING now says so, and tells outside contributors how to check their changes locally instead.
What changed
netlify.toml. All of its redirect rules were already instatic/_redirects, in the same order. Its sitemap plugin isn't needed: Docusaurus buildssitemap.xmlitself, with the same 338 pages (without Netlify's stray/404entry).vercel.json. Its 6 redirects were already instatic/_redirects. Removed.vercelfrom.gitignore.AGENTS.md,AGENTS_REFERENCE.md,.cursor/BUGBOT.md): points only atstatic/_redirects, and adds two placement rules Cloudflare needs:CONTRIBUTING.md: replaced the Netlify preview instructions and screenshot with thecloudflare/previewstatus and itspr-<number>URL, plus the fork note.README.md: removed the Netlify status badge.ci.yml,tag-docs-release.yml,scripts/report-tagging-failure.mjs, andwrangler.jsoncno longer compare things to Netlify.The Netlify mentions in
docs/app/run-tests/continuous-integration/overview.mdx, the changelog, anddocs/cloud/guides/webhooks.mdxstay. They're about Cypress users' own Netlify setups, not about where these docs are hosted.Notes for reviewers
npm run lint:fix,npm run build, andnpm run typecheckpass.npx wrangler deploy --dry-runreads all 9,336 files.npm run serveanswers on port 3000, as the new CONTRIBUTING text says.netlify.toml, which this PR deletes. I resolved it by keeping the deletion.cypress-docsNetlify site, removedocs.cypress.iofrom it, and remove this repository from the Netlify GitHub App, so its preview and rule checks stop appearing on PRs. None of these are required checks in branch protection.🤖 Generated with Claude Code
https://claude.ai/code/session_01WUv8r4AAgMMw1DSbt1H69h
Note
High Risk
Drops two legacy redirect layers; any mismatch with
static/_redirectswould break inbound URLs in production, so reviewers should verify parity before merge.Overview
Cloudflare is now the documented deployment path.
CONTRIBUTING.md,README.md, Bugbot rules, and both AGENTS docs only mention the Cloudflare preview (cloudflare/previewstatus plus thepr-<number>-cypress-documentation.cypress-io.workers.devURL) and retire Netlify/Vercel instructions.Hosting config cleanup mirrors that shift.
netlify.toml,vercel.json, and.vercelin.gitignoreare removed, while redirect guidance narrows tostatic/_redirectswith extra Cloudflare wildcard cautions and comments inwrangler.jsonc,ci.yml,tag-docs-release.yml, andscripts/report-tagging-failure.mjsdescribing the Worker-based flow.Risk note: confirm
static/_redirectsalready contained every rule from the deleted hosts so inbound links keep working; if anything drifts, the traffic loss would show up in production only.Reviewed by Cursor Bugbot for commit 4a02a8a. Bugbot is set up for automated code reviews on this repo. Configure here.