Merge pull request #25 from nightt5879/nightt5879/cloudflare-git-build-1.3.4

fix: pin Cloudflare Pages build runtime for 1.3.4

Author: nightt5879

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version-file: .node-version
           cache: npm
 
       - name: Install dependencies

.node-version

@@ -0,0 +1 @@
+22.16.0

CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [1.3.4] - 2026-05-03
+
+### Added
+- Added a root `.node-version` file so Cloudflare Pages Git builds and GitHub Actions use the same pinned Node.js runtime.
+- Added a root `wrangler.jsonc` Pages configuration that records the `doubleducklab` project and `dist` build output directory.
+- Documented the expected Cloudflare Pages Git build settings for the production CMS site.
+
+### Changed
+- Bumped the package version from `1.3.3` to `1.3.4` for Cloudflare Git build stability.
+- Updated GitHub Actions to read the pinned Node.js version from `.node-version`.
+
+### Fixed
+- Reduced production deploy drift between GitHub CI, local builds, manual Wrangler uploads, and Cloudflare Pages Git builds.
+
 ## [1.3.3] - 2026-05-03
 
 ### Changed

README_EN.md

@@ -211,6 +211,7 @@ venue: "Conference Name"
 - Content map: [content-map.md](./content-map.md)
 - Content edit guide: [docs/content-edit-guide.md](./docs/content-edit-guide.md)
 - Content ops checklist: [docs/content-ops-checklist.md](./docs/content-ops-checklist.md)
+- Cloudflare Pages build settings: [docs/cloudflare-pages-build-settings.md](./docs/cloudflare-pages-build-settings.md)
 - Release baseline checklist: [docs/release-baseline-checklist.md](./docs/release-baseline-checklist.md)
 - Roadmap: [docs/roadmap.md](./docs/roadmap.md)
 
@@ -226,6 +227,7 @@ venue: "Conference Name"
 - `1.3.1`: CMS live enablement follow-up with a Cloudflare Worker OAuth proxy package and production environment validation notes
 - `1.3.2`: CMS stability patch that adds stable legacy news slugs, removes CMS test residue, and tightens news slug validation
 - `1.3.3`: build-log cleanup that clears Astro content cache before builds to remove duplicate news id warnings
+- `1.3.4`: Cloudflare Pages Git build stability patch that pins Node.js and records the Pages output directory in repo config
 
 ## License
 

docs/cloudflare-pages-build-settings.md

@@ -0,0 +1,30 @@
+# Cloudflare Pages Build Settings
+
+Use these settings for the `doubleducklab` Pages project when GitHub is connected directly to Cloudflare Pages.
+
+## Build Settings
+
+- Production branch: `main`
+- Build command: `npm run build`
+- Build output directory: `dist`
+- Node.js version: `22.16.0`
+
+The repository pins the Node.js version in `.node-version`, and the Pages project also has `NODE_VERSION=22.16.0` set for production builds. This keeps GitHub Actions, local release builds, manual Wrangler uploads, and Cloudflare Pages Git builds on the same runtime family.
+
+## Required Production Variables
+
+- `CMS_GITHUB_REPO=nightt5879/DoubleDuckLab`
+- `CMS_BRANCH=main`
+- `CMS_OAUTH_BASE_URL=https://doubleducklab-cms-oauth.<account>.workers.dev`
+- `PUBLIC_SITE_URL=https://doubleducklab.pages.dev`
+
+`NODE_VERSION` is a build-environment pin, not a CMS secret. It is listed with Pages secrets only because Wrangler manages Pages variables through `wrangler pages secret`.
+
+## Verification
+
+After merging a deployment-config change:
+
+1. Check that Cloudflare Pages creates a production Git deployment for the merge commit.
+2. Confirm the production deployment succeeds without needing a manual `wrangler pages deploy`.
+3. Visit `/admin/config.yml` and confirm it is the enabled CMS config, not the setup-required fallback.
+4. Visit `/news/` and `/en/news/` to confirm public routes still build normally.

package-lock.json

@@ -1,7 +1,7 @@
 {
   "name": "double-duck-lab",
   "type": "module",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "private": true,
   "scripts": {
     "dev": "astro dev",

package.json

@@ -0,0 +1,9 @@
+{
+  "name": "doubleducklab",
+  "pages_build_output_dir": "dist",
+  "compatibility_date": "2026-05-03",
+  "env": {
+    "production": {},
+    "preview": {}
+  }
+}