chore: delete the docs and ui-website redirect-only apps

[vivek7405]

Problem

docs/ and packages/ui/packages/website/ are two whole npm workspaces, two Railway services, two Dockerfile stages, and two compose services that exist only to return a 301. Since #1098 and #1099 merged the documentation into website/app/docs and the component gallery into website/app/ui, neither app renders a single byte of HTML: each is one middleware.ts returning a redirect, plus a stub app/page.ts.

That work has now moved to the edge. Two Cloudflare Redirect Rules on the webjs.dev zone (46692b879a06f3a6a987b99915560393, Free plan) replace both apps:

Expression	Action
http.host eq "docs.webjs.dev"	301 static to https://webjs.dev/docs
http.host eq "ui.webjs.dev"	301 static to https://webjs.dev/ui

Both are deployed and verified: every probed URL on both hosts redirects, and no response carries x-railway-request-id, so Cloudflare answers at the edge and never contacts an origin. The two apps are now dead weight.

Design / approach

Delete both app directories and every reference to them, then let the owner remove the two Railway services.

The Cloudflare rules are a deliberate downgrade from what the middleware did, and this is accepted. The middleware was path-preserving and path-aware; the rules collapse every path onto the hub page. The owner chose the two-rule version after we measured the SEO exposure: zero third-party inbound links to either host, zero recent traffic (Railway HTTP logs empty on both services), neither subdomain in the 139-URL sitemap, and the destinations (/docs 43 URLs, /ui 33 URLs) already canonicalised and indexed. There is no ranking signal left to lose, and the seven-rule path-mapping alternative was scoped out on purpose.

Consequences the owner accepted. Do NOT re-litigate these in the PR:

• ui.webjs.dev/registry/<name>.json now 301s to an HTML page. Published @webjsdev/ui 0.3.1 through 0.3.8 hard-code that URL (confirmed by unpacking the 0.3.5 tarball) and will fetch HTML then fail to parse it as JSON. 0.3.9+ resolves local-first (ui: local-first registry, on-demand example delivery, MCP ui tool #983) and is unaffected. The owner is handling this separately.
• Deep paths no longer land on their equivalent (docs.webjs.dev/docs/routing goes to /docs, not /docs/routing).
• Old asset URLs (ui.webjs.dev/public/og.png, referenced by already-scraped social cards) now redirect to the gallery page.

Implementation notes (for the implementing agent)

Delete these two directories

• docs/, the workspace @webjsdev/docs-redirect (holds middleware.ts, app/page.ts, public/tailwind.css, package.json, tsconfig.json, AGENTS.md, CLAUDE.md)
• packages/ui/packages/website/, the workspace @webjsdev/ui-website (holds middleware.ts, app/page.ts, package.json, tsconfig.json, README.md, AGENTS.md)

LANDMINE: do not touch packages/ui/packages/registry/

packages/ui/packages/registry/ is a DIFFERENT workspace that must stay. It holds the component sources that website/scripts/copy-registry.mjs mirrors into website/components/ui/ at build time, which the gallery detail pages (website/app/ui/[name]/page.ts) statically import. Deleting it 500s every component page in production, which is exactly regression #526. The packages/ui/packages/* workspace glob covers both, so only the website subdirectory goes.

Where to edit

• In package.json L14, drop the "docs" workspace entry. The ui site rides the packages/ui/packages/* glob (L12), so that glob stays as-is.
• In package.json L33, drop the "ui:dev": "npm run dev --workspace=@webjsdev/ui-website" script. Check the surrounding dev and start scripts for concurrently-style invocations referencing the docs or ui-website ports.
• Regenerate package-lock.json with npm install after the workspace removal. Do not hand-edit it.
• In Dockerfile, remove L52 to L56 (COPY packages/ui/packages/website/package.json, COPY docs/package.json) and L70 (COPY docs ./docs). The build FAILS on a missing COPY source, so these must go in the same commit. L124 to L125 already carries a comment about both services; update it rather than leaving a comment describing deleted things.
• In compose.yaml, remove the docs service (L33 to L36, port 15002) and the ui-website service (L71 to L74, port 15003). Update the header comment at L1 to L8, which says "four services".
• In .github/workflows/ci.yml, fix L37 and L53. Both loops read for app in examples/blog website docs packages/ui/packages/website and become examples/blog website. Update the step names on L35 and L51 ("blog, website, docs host, ui host"). Also review the comments at L462 to L463, L493, and L502 to L509, several of which explain why the redirect hosts are or are not covered.

Test surfaces

Delete these two, which test middleware that will not exist:

• test/docs/docs-host-redirect.test.mjs (93 lines)
• test/ui/ui-host-redirect.test.mjs (135 lines)

Then update the references in:

• test/preload-subset.test.mjs (2 refs)
• test/e2e/form-submission-and-race.test.mjs (6 refs)
• test/e2e/nested-layout-partial-swap.test.mjs (6 refs)
• test/bun/app-boot.mjs (1 ref)
• scripts/run-bun-tests.js (1 ref)
• packages/server/test/check/check.test.js (1 ref)
• packages/server/test/dev/dev-handler.test.js (1 ref)
• test/repo-health/dockerfile-bakes-ui-registry.test.mjs, which guards dogfood: bake the ui-website registry into the deploy image (Bun serve 500s without it) #526 and must KEEP passing. It references packages/ui/packages/registry (staying), but check whether it also asserts on the website host's Dockerfile lines.

State this coverage gap plainly in the PR body rather than papering over it: the two deleted tests asserted that the redirect hosts keep resolving. That behaviour now lives in Cloudflare and CI cannot see it. Do not invent a network test against the live zone to replace them, since a CI job that fails when Cloudflare has a bad minute is worse than the gap. Note the gap and move on.

Doc surfaces (all mandatory; this is a doc-sync task as much as a deletion)

• AGENTS.md L88 reads "Run webjs doctor too when you touched an in-repo app (examples/blog, website, docs, packages/ui/packages/website) ... over all four". It becomes two apps.
• AGENTS.md L520, the CLI-reference paragraph naming "the redirect-only docs/ and packages/ui/packages/website/ hosts".
• framework-dev.md L3 and L9, both describing the four in-repo apps and the one-image deploy.
• framework-dev.md L38, the Cloudflare cache-purge section, says all four hostnames are proxied in the one zone. That stays TRUE (the hostnames still exist as redirects), but re-read it for accuracy.
• README.md L153 ("all four apps at once"), L163 (the ports table row for ui.webjs.dev redirect), L173 ("Override ports when running all four"). Check for a docs.webjs.dev table row too.
• website/AGENTS.md (2 refs)
• .claude/skills/webjs-start-work/SKILL.md (5 refs)

Invariants to respect

• Cut a worktree first (git worktree add -b <prefix>/<slug> ../webjs-<slug> origin/main); never work in the primary checkout. Enforced by .claude/hooks/require-worktree-for-edits.sh.
• Run npm run worktree:link inside the fresh worktree, NOT a hand-rolled root node_modules symlink. packages/server keeps a nested ws@8 that a root-only link resolves up to ws@7, failing hundreds of assertions that never name ws.
• AGENTS.md invariant 11: no em-dashes, no pause-hyphens or pause-semicolons in prose, WebJs capitalized in prose and lowercase only as a code token.
• Conventional commit subject (chore: or refactor:), imperative, under 72 chars, no AI attribution.

Verification

• npm install then npm test clean.
• node --test test/repo-health/ clean (the dogfood: bake the ui-website registry into the deploy image (Bun serve 500s without it) #526 guard specifically).
• Docker build succeeds, since the COPY removals are the risky part: docker build -t webjs-test .
• npm run dev still boots the remaining apps without a missing-workspace error.
• The live hosts still redirect after the Railway services are deleted (the owner runs this):

  for u in https://docs.webjs.dev/ https://ui.webjs.dev/ ; do
    printf '%-30s -> ' "$u"; curl -sSI -m 15 "$u" | tr -d '\r' | awk 'tolower($1)=="location:"{print $2}'
  done

Out of scope for this issue (owner-driven, in order, AFTER merge)

1. Repoint DNS. The docs and ui records currently CNAME to Railway and must become CNAME -> webjs.dev, proxied. The redirect rules fire before the origin fetch so they work regardless, but a CNAME to a deleted Railway host is fragile and can surface Error 1016 on any path that bypasses a rule.
2. Delete the Railway custom domains, then the services, in project webjs (1d05ab75-b64e-4920-94ef-1ca7d04778fc):
   • @webjsdev/docs 35d994ce-2076-483a-8271-7b29b70122c7 (domain c32a97f9-9ede-4737-b734-19ad6ba2f83c)
   • @webjsdev/ui-website 66a96b5e-9a00-4c58-9ddb-fb655b99d8e6 (domain 32c090bd-fd79-4777-9207-a36e92343b84)

Acceptance criteria

• docs/ and packages/ui/packages/website/ are gone; packages/ui/packages/registry/ is untouched
• package.json workspaces and scripts carry no reference to either; package-lock.json regenerated via npm install
• Dockerfile builds clean with no COPY pointing at a deleted path
• compose.yaml runs the two remaining apps with no dead service
• .github/workflows/ci.yml loops over examples/blog website only, in both the check and doctor steps
• test/docs/docs-host-redirect.test.mjs and test/ui/ui-host-redirect.test.mjs are deleted; every other referencing test updated and passing
• test/repo-health/dockerfile-bakes-ui-registry.test.mjs still passes (the dogfood: bake the ui-website registry into the deploy image (Bun serve 500s without it) #526 guard)
• AGENTS.md, framework-dev.md, README.md, website/AGENTS.md, and .claude/skills/webjs-start-work/SKILL.md no longer describe four in-repo apps
• npm test clean; npm run dev boots without a missing-workspace error
• The PR body states the CI coverage gap (the redirect behaviour is now untested by this repo) rather than hiding it