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	Dec 30, 2025 9:03pm
ensnode.io	Ready	Preview, Comment	Dec 30, 2025 9:03pm
ensrainbow.io	Ready	Preview, Comment	Dec 30, 2025 9:03pm

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

⚠️ No Changeset found

Latest commit: 5898bce

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 Sharing feedback on the latest changes.

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

lightwalker-eth · 2025-12-21T21:31:40Z

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

 **When to use:**
- When you need maximum stability and reliability
- When you want thoroughly tested features
+- Production deployments and any critical infrastructure


"... and any critical infrastructure"

What does this mean? How is it distinct from "Production deployments"?

lightwalker-eth · 2025-12-21T21:32:40Z

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

- When you need maximum stability and reliability
- When you want thoroughly tested features
+- Production deployments and any critical infrastructure
+- When you need maximum stability and control over updates


What is the goal for writing this? I find this confusing and unclear.

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

lightwalker-eth · 2025-12-21T21:34:52Z

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

- Stable, well-tested releases
- Complete release notes and changelog entries
+- Stable, well-tested releases with complete release notes
+- The version will never change - you control when to upgrade


This is confusing and unclear. It should be written better.

lightwalker-eth · 2025-12-21T21:35:52Z

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

 **What to expect:**
- Stable, well-tested releases
- Complete release notes and changelog entries
+- Stable, well-tested releases with complete release notes


We aren't performing strong enough testing yet for us to fairly claim "well-tested releases" yet.

We shouldn't write things that sound nice if they are not true.

lightwalker-eth · 2025-12-21T21:37:30Z

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
+
+**Important:** 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).


Can we just completely remove any use of the latest tag on all the Docker images we publish (current and future)?

Note that use of the latest tag is a key issue with Docker images. It's not as big of an issue for NPM packages.

To clarify, are you asking to remove any mention of latest for Docker images in the docs? Or are you suggesting opening another issue to remove latest as a possibility for Docker image publishing?

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

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

stevedylandev · 2025-12-30T21:04:18Z

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

 import { LinkCard } from '@astrojs/starlight/components';

-We use [changesets](https://github.com/changesets/changesets) to manage version bumps and release notes for our NPM packages and Docker images (ENSIndexer, ENSAdmin, and ENSRainbow).
+We use [changesets](https://github.com/changesets/changesets) to manage version bumps and release notes for our monorepo's artifacts (NPM packages, Docker images, and Lambda zips).


Opted for artifacts as a term to refer NPM packages, Docker images, and Lambda zips per @shrugs suggestion

stevedylandev · 2025-12-30T21:05:06Z

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

+The example version below of `1.0.0` is a placeholder. Visit the [Releases Page](https://github.com/namehash/ensnode/releases) to pick a pinned full release.
+:::
+```bash
+npm install @ensnode/[package-name]@1.0.0


Switched to [package-name] and ensnode/[app-name] per suggestion from @shrugs

stevedylandev · 2025-12-30T21:05:58Z

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

+- **NPM Packages**: Available on the [npm registry](https://www.npmjs.com/search?q=%40ensnode) under the `@ensnode` organization
+- **Docker Images**: Available on [GitHub Container Registry](https://github.com/orgs/namehash/packages?repo_name=ensnode)
+- **GitHub Releases**: Full releases are documented with release notes on the [ENSNode GitHub releases page](https://github.com/namehash/ensnode/releases)
+- **Lambda Zip Artifacts**: Available in the Artifact section of a successful workflow run


@shrugs @lightwalker-eth open to suggestions on a better way to link/reference Lambda zips. As far as I know they can only be seen in successful workflow runs, e.g. https://github.com/namehash/ensnode/actions/runs/20581435373

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

lightwalker-eth reviewed Dec 21, 2025

View reviewed changes

chore: Update docs/ensnode.io/src/content/docs/docs/contributing/rele…

cdcdbc4

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

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

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

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

stevedylandev marked this pull request as draft December 26, 2025 10:48

chore: merge main into feat/add-package-prereleases

c3935ed

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

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

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

chore: refactored release docs page

10b0c51

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

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

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

chore: added lambda build and publish to snapshot and preview releases

01fb85d

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

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

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

chore: corrected run name

7dde353

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

vercel bot deployed to Preview – ensnode.io December 30, 2025 21:00 View deployment

vercel bot deployed to Preview – admin.ensnode.io December 30, 2025 21:00 View deployment

chore: refactored docs page to include lambdas

5898bce

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

vercel bot deployed to Preview – ensnode.io December 30, 2025 21:03 View deployment

vercel bot deployed to Preview – admin.ensnode.io December 30, 2025 21:03 View deployment

stevedylandev commented Dec 30, 2025

View reviewed changes

stevedylandev marked this pull request as ready for review December 30, 2025 21:09

feat/add package prereleases #1399

Are you sure you want to change the base?

feat/add package prereleases #1399

Uh oh!

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!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 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

stevedylandev Dec 30, 2025 •

edited

Loading