feat/add package prereleases #1399

stevedylandev · 2025-12-12T20:09:53Z

This PR closes #1359 by adding the following:

snapshot-release.yml - Automatically publishes @next packages and docker images for commits to main
preview-release.yml - A manual workflow that can be run to create @preview packages for a branch, helpful for testing a PR before merging to main
Updates package.json to support scripting in new workflows
Updates docs at ensnode.io/docs/contributing/releases with new flow

vercel · 2025-12-12T20:09:54Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
admin.ensnode.io	Ready	Preview, Comment	Jan 1, 2026 6:58pm
ensnode.io	Ready	Preview, Comment	Jan 1, 2026 6:58pm
ensrainbow.io	Ready	Preview, Comment	Jan 1, 2026 6:58pm

changeset-bot · 2025-12-12T20:09:56Z

⚠️ No Changeset found

Latest commit: 7e778f8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

tk-o

Looks awesome to me 🚀 I suggested some minor changes, feel free to merge the PR once ready.

.github/workflows/preview-release.yml

lightwalker-eth

@stevedylandev Thanks, excited for this! Shared some questions and requests for advice 👍

docs/ensnode.io/src/content/docs/docs/contributing/releases.mdx

.github/workflows/snapshot-release.yml

.github/workflows/release_snapshot.yml

.github/workflows/preview_release.yml

.github/workflows/snapshot_release.yml

.github/workflows/release_snapshot.yml

Co-authored-by: lightwalker.eth <126201998+lightwalker-eth@users.noreply.github.com> Co-authored-by: Tomek Kopacki <tomasz@kopacki.net>

lightwalker-eth

@stevedylandev Thanks for updates. Reviewed and shared feedback.

.github/workflows/release_preview.yml

docs/ensnode.io/src/content/docs/docs/contributing/releases.mdx

lightwalker-eth · 2026-01-01T17:12:50Z

docs/ensnode.io/src/content/docs/docs/contributing/releases.mdx

-npm install @ensnode/package-name@next  
-docker run ghcr.io/namehash/ensnode:next
+npm install @ensnode/[package-name]@next  
+docker run ghcr.io/namehash/ensnode/[app-name]:next


@stevedylandev @shrugs @jarmint Appreciate your advice on this I'm not familiar with how Docker handles these things.

Goal: All installation instructions we share (including for snapshot releases) should never auto-upgrade themselves as we publish future iterations of releases. Our docs should instruct everyone building on any form of ENSNode artifacts to always fully pin all version numbers of their ENSNode dependencies such that they retain full and explicit control over if and when to consume any updated ENSNode artifacts.

lightwalker-eth · 2026-01-01T17:14:24Z

docs/ensnode.io/src/content/docs/docs/contributing/releases.mdx

+### Snapshot Releases
 :::caution
-Never use the `latest` tag for Docker deployments (e.g., `ghcr.io/namehash/ensnode:latest` or `ghcr.io/namehash/ensnode`). The `latest` tag is a mutable pointer that will automatically pull different versions over time, causing unexpected updates and potential breaking changes in your deployment. Always pin to a specific version number from the [GitHub releases page](https://github.com/namehash/ensnode/releases).
+The `next` tag is a floating pointer that always references the most recent snapshot release. When using Docker images with the `next` tag, you must run `docker pull` to update your local Docker cache if you want to get the actual latest image. Without pulling, you may continue using an older cached version.


Please see my comment below. I'm concerned about how we're currently describing use of the next tag. Advice appreciated.

this :next tag seems redundant for me and just adds uncertainty.

the :latest tag has it's own use for POCs / Demos / development / test environments / CI builds for pulling cache faster. But as mentioned in already placed document: should never be used for running in production.

@jarmint Let's move this discussion into Slack.

docs/ensnode.io/src/content/docs/docs/contributing/releases.mdx

lightwalker-eth · 2026-01-01T17:43:38Z

docs/ensnode.io/src/content/docs/docs/contributing/releases.mdx

- The version will never change - you control when to upgrade
- No unexpected breaking changes or behavior changes
+:::caution
+Never use the `latest` tag for Docker deployments (e.g., `ghcr.io/namehash/ensnode:latest` or `ghcr.io/namehash/ensnode`). The `latest` tag is a mutable pointer that will automatically pull different versions over time, causing unexpected updates and potential breaking changes in your deployment. Always pin to a specific version number from the [GitHub releases page](https://github.com/namehash/ensnode/releases).


I'm not so clear here right now. Specifically I'm confused about docs updates vs updates to how things actually work.

My understanding is that we have a goal to completely remove any use of the latest tag from our Docker images. Not only in our docs, but also that there's no longer any published artifacts tagged latest.

Is that true?

Assuming so, what remaining actions need to be taken for us to achieve this.

Please help me understand both the goal state, what state will be achieved when this PR is merged, and what additional follow-up actions if any are required after merging this PR to reach the goal state.

Co-authored-by: lightwalker.eth <126201998+lightwalker-eth@users.noreply.github.com>

lightwalker-eth

All goals on this PR have been achieved with carve outs for a few separate follow-up issues:

#1451
#1452

stevedylandev added 2 commits December 12, 2025 14:59

feat: added new workflows and updated package.json

f0fb693

chore: updated docs

514cb51

vercel bot deployed to Preview – ensrainbow.io December 12, 2025 20:10 View deployment

vercel bot deployed to Preview – ensnode.io December 12, 2025 20:10 View deployment

vercel bot deployed to Preview – admin.ensnode.io December 12, 2025 20:11 View deployment

chore: Merge branch 'main' into feat/add-package-prereleases

3df428e

vercel bot deployed to Preview – ensrainbow.io December 12, 2025 20:15 View deployment

vercel bot deployed to Preview – ensnode.io December 12, 2025 20:16 View deployment

stevedylandev marked this pull request as ready for review December 12, 2025 20:16

vercel bot deployed to Preview – admin.ensnode.io December 12, 2025 20:16 View deployment

stevedylandev requested a review from a team as a code owner December 12, 2025 20:16

tk-o approved these changes Dec 13, 2025

View reviewed changes

.github/workflows/preview-release.yml Show resolved Hide resolved

.github/workflows/preview-release.yml Outdated Show resolved Hide resolved

lightwalker-eth reviewed Dec 14, 2025

View reviewed changes

chore: Apply suggestions from code review

ddd2468

Co-authored-by: lightwalker.eth <126201998+lightwalker-eth@users.noreply.github.com> Co-authored-by: Tomek Kopacki <tomasz@kopacki.net>

vercel bot deployed to Preview – ensrainbow.io December 14, 2025 16:18 View deployment

vercel bot deployed to Preview – ensnode.io December 14, 2025 16:18 View deployment

vercel bot deployed to Preview – admin.ensnode.io December 14, 2025 16:19 View deployment

chore: redacted NODE_AUTH_TOKEN

cc05a10

vercel bot deployed to Preview – ensrainbow.io December 15, 2025 14:16 View deployment

vercel bot deployed to Preview – ensnode.io December 15, 2025 14:17 View deployment

vercel bot deployed to Preview – admin.ensnode.io December 15, 2025 14:17 View deployment

chore: removed unused files

89a4dd0

vercel bot deployed to Preview – ensrainbow.io December 15, 2025 14:21 View deployment

vercel bot deployed to Preview – ensnode.io December 15, 2025 14:22 View deployment

vercel bot deployed to Preview – admin.ensnode.io December 15, 2025 14:22 View deployment

chore: redacted force_pr_comment and logic

ea0ecc0

vercel bot deployed to Preview – ensrainbow.io December 15, 2025 14:33 View deployment

vercel bot deployed to Preview – ensnode.io December 15, 2025 14:33 View deployment

chore: added caution block for snapshot releases

556d877

vercel bot deployed to Preview – ensrainbow.io December 31, 2025 20:11 View deployment

vercel bot deployed to Preview – ensnode.io December 31, 2025 20:11 View deployment

vercel bot deployed to Preview – admin.ensnode.io December 31, 2025 20:11 View deployment

lightwalker-eth reviewed Jan 1, 2026

View reviewed changes

chore: Apply suggestions from code review

801c6f9

Co-authored-by: lightwalker.eth <126201998+lightwalker-eth@users.noreply.github.com>

vercel bot deployed to Preview – ensrainbow.io January 1, 2026 17:58 View deployment

vercel bot deployed to Preview – ensnode.io January 1, 2026 17:58 View deployment

vercel bot deployed to Preview – admin.ensnode.io January 1, 2026 17:58 View deployment

chore: added caution block regarding semver

67dfba8

vercel bot deployed to Preview – ensrainbow.io January 1, 2026 18:05 View deployment

vercel bot deployed to Preview – ensnode.io January 1, 2026 18:06 View deployment

vercel bot deployed to Preview – admin.ensnode.io January 1, 2026 18:06 View deployment

chore: refactored logic for fetching PR data in preview release

3d3780c

vercel bot deployed to Preview – ensrainbow.io January 1, 2026 18:08 View deployment

vercel bot deployed to Preview – ensnode.io January 1, 2026 18:08 View deployment

vercel bot deployed to Preview – admin.ensnode.io January 1, 2026 18:08 View deployment

chore: updated npm tag from latest to [version]

c99e883

vercel bot deployed to Preview – ensrainbow.io January 1, 2026 18:14 View deployment

vercel bot deployed to Preview – ensnode.io January 1, 2026 18:15 View deployment

vercel bot deployed to Preview – admin.ensnode.io January 1, 2026 18:15 View deployment

chore: updated pinned full release versions section

7e778f8

vercel bot deployed to Preview – ensrainbow.io January 1, 2026 18:57 View deployment

vercel bot deployed to Preview – ensnode.io January 1, 2026 18:58 View deployment

vercel bot deployed to Preview – admin.ensnode.io January 1, 2026 18:58 View deployment

This was referenced Jan 2, 2026

Remove latest tag from all existing and future GHCR packages #1451

Open

For investigation: Remove next tag from GHCR published images #1452

Open

lightwalker-eth approved these changes Jan 2, 2026

View reviewed changes

lightwalker-eth merged commit ce1540a into main Jan 2, 2026
12 checks passed

lightwalker-eth deleted the feat/add-package-prereleases branch January 2, 2026 12:41

feat/add package prereleases #1399

feat/add package prereleases #1399

Conversation

stevedylandev commented Dec 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot commented Dec 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Dec 12, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

tk-o left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

lightwalker-eth left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lightwalker-eth left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lightwalker-eth Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

lightwalker-eth Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

jarmint Jan 2, 2026

Choose a reason for hiding this comment

Uh oh!

lightwalker-eth Jan 2, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

lightwalker-eth Jan 1, 2026

Choose a reason for hiding this comment

Uh oh!

lightwalker-eth left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

stevedylandev commented Dec 12, 2025 •

edited

Loading

vercel bot commented Dec 12, 2025 •

edited

Loading

changeset-bot bot commented Dec 12, 2025 •

edited

Loading