Publishing

Source Of Truth

The canonical source lives at C:\PagePoint\engineering-portal\src. The published website at engineering.pagepoint.io is only the deployed copy.

Static Build

Until a build tool is required, publishing is a static copy from src to dist.

Remove-Item -Recurse -Force .\dist\*
Copy-Item -Recurse .\src\* .\dist\

Cloudflare Role

• Cloudflare hosts the finished portal.
• Cloudflare is not the source of truth.
• If Cloudflare is unavailable, the portal source remains intact locally.
• Publishing currently uses Wrangler OAuth login, not a project API token.

Wrangler Authentication

• Normal publishing should use the existing Wrangler OAuth login.
• Do not set CLOUDFLARE_API_TOKEN for normal interactive Engineering Portal deployment.
• On 2026-07-14, a malformed CLOUDFLARE_API_TOKEN was found only in the already-running Codex process environment inherited from its launch shell. It was not found in Windows User, Machine, or Volatile environment, PagePoint project files, PowerShell profiles, npm config, or Wrangler config.
• Verification after unsetting the process variable: wrangler auth token --json reported OAuth authentication, wrangler whoami succeeded, and a normal wrangler pages deploy .\dist --project-name pagepoint-engineering-portal deployment succeeded.

Publish Checklist

• Update the relevant source pages.
• Review Current Sprint and Current Context for accuracy.
• Run npm.cmd run build.
• Run npm.cmd run check.
• Publish with npx.cmd wrangler pages deploy .\dist --project-name pagepoint-engineering-portal.
• Verify engineering.pagepoint.io loads the new version.