Skip to content

Pin the container preview to Node 22 and document local setup with corepack - #891

Open
bennyvasquez wants to merge 1 commit into
masterfrom
containerfile-node22-setup
Open

bennyvasquez wants to merge 1 commit into
masterfrom
containerfile-node22-setup

Conversation

@bennyvasquez

Copy link
Copy Markdown
Member

This follows up on the README and deploy docs PR that merged last week. It makes the two local preview paths match what the deploy uses.

What changes

  • Containerfile: both stages now use node:22-alpine instead of node:lts-alpine. The LTS tag will move off Node 22, and when it does, the container preview would stop matching the deploy workflow, which pins Node 22.
  • Contributor guide: the local setup section now says to use Node.js 22 on every operating system and to turn on yarn with corepack enable, then run the existing yarn install and yarn docs:dev steps. It replaces the old tip that only mentioned installing Node.js on Windows and macOS.

How I tested it

  • Built the image from the Containerfile and ran it with the documented mount. The dev server started on Node 22.23.5 and VuePress compiled with no errors. I used Docker for this, since the Containerfile is the same for Podman.
  • Ran corepack enable in node:22-alpine with this repo's package.json. Since there's no packageManager field, corepack provides yarn 1.22.22, which matches the yarn 1 lock file the deploy installs from.
  • Prettier passes on the changed guide.

Something I'd like a second opinion on

The guide says you can install Node.js 22 from your operating system's package manager. I haven't confirmed that every distribution's Node.js package includes corepack, since some split it into a separate package. If you know of one where corepack is missing, tell me and I'll add a line about it.

…repack

The Containerfile used node:lts-alpine for both stages, so the container preview could drift from the Node 22 the deploy workflow uses. Both stages now use node:22-alpine. The image builds, and the dev server starts and serves the wiki on Node 22.23.5.

The contributor guide's local setup now says to use Node.js 22 on every operating system and to turn on yarn 1 with corepack enable, which ships with Node.js 22. With no packageManager field in package.json, corepack provides yarn 1.22.22, which matches the yarn.lock format the deploy installs from.
@bennyvasquez
bennyvasquez marked this pull request as ready for review November 16, 2026 18:35

This branch has not been deployed

No deployments
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.

1 participant