Add new release process (#14916)

Author: brophdawg11

.github/workflows/release.yml

@@ -1,234 +1,82 @@
-# We use this singular file for all of our releases because we can only specify
-# a singular GitHub workflow file in npm's Trusted Publishing configuration.
-# See https://docs.npmjs.com/trusted-publishers for more info.
-#
-# Specific jobs only run on the proper trigger:
-#
-# - Changesets-driven pre-releases/stable releases
-#   - Trigger: push to release-next/release-v6 branch
-#   - jobs: release -> find_package_version -> comment
-# - Nightly releases
-#   - Trigger: schedule/cron
-#   - jobs: release-nightly
-# - Experimental releases (from a workflow_dispatch trigger)
-#   - Trigger: workflow_dispatch
-#   - jobs: release-experimental
+name: 🚢 Release/Publish
 
-name: 🚢 Release
 on:
-  # Changesets-driven prereleases and stable releases
   push:
     branches:
-      - "release-next"
-      - "release-v6"
-  # Nightly releases
-  schedule:
-    - cron: "0 7 * * *" # every day at 12AM PST
-  # Experimental Releases
-  workflow_dispatch:
-    inputs:
-      branch:
-        required: true
+      - "release"
+      - "hotfix"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
-env:
-  CI: true
-
 jobs:
-  release:
-    name: 🦋 Changesets Release
-    if: github.repository == 'remix-run/react-router' && github.event_name == 'push'
+  check:
+    name: Check release readiness
+    if: github.repository == 'remix-run/react-router'
     runs-on: ubuntu-latest
     outputs:
-      published_packages: ${{ steps.changesets.outputs.publishedPackages }}
-      published: ${{ steps.changesets.outputs.published }}
-    permissions:
-      contents: write # enable pushing changes to the origin
-      id-token: write # enable generation of an ID token for publishing
-      pull-requests: write # enable opening a PR for the release
+      has_change_files: ${{ steps.check.outputs.has_change_files }}
     steps:
-      - name: ⬇️ Checkout repo
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      - name: 📦 Setup pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: ⎔ Setup node
-        uses: actions/setup-node@v6
-        with:
-          node-version: 24 # Needed for npm@11 for Trusted Publishing
-          cache: "pnpm"
-
-      - name: 📥 Install deps
-        run: pnpm install --frozen-lockfile
-
-        # This action has two responsibilities. The first time the workflow runs
-        # (initial push to a `release-*` branch) it will create a new branch and
-        # then open a PR with the related changes for the new version. After the
-        # PR is merged, the workflow will run again and this action will build +
-        # publish to npm.
-      - name: 🚀 PR / Publish
-        id: changesets
-        # PLEASE KEEP THIS PINNED TO 1.4.10 to avoid a regression in 1.5.*
-        # See https://github.com/changesets/action/issues/465
-        uses: changesets/action@v1.4.10
-        with:
-          version: pnpm run changeset:version
-          commit: "chore: Update version for release"
-          title: "chore: Update version for release"
-          publish: pnpm run release
-          createGithubReleases: false
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  find_package_version:
-    name: 🦋 Find Package
-    needs: [release]
-    runs-on: ubuntu-latest
-    if: github.repository == 'remix-run/react-router' && github.event_name == 'push' && github.ref_name != 'release-v6' && needs.release.outputs.published == 'true'
-    outputs:
-      package_version: ${{ steps.find_package_version.outputs.package_version }}
-    steps:
-      - name: ⬇️ Checkout repo
-        uses: actions/checkout@v6
-
-      - name: 📦 Setup pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: ⎔ Setup node
-        uses: actions/setup-node@v6
-        with:
-          node-version: 24 # Needed for npm@11 for Trusted Publishing
-          cache: "pnpm"
+      - name: Checkout
+        uses: actions/checkout@v4
 
-      - id: find_package_version
+      - name: Check for change files
+        id: check
         run: |
-          package_version=$(node ./scripts/find-release-from-changeset.js)
-          echo "package_version=${package_version}" >> $GITHUB_OUTPUT
-        env:
-          PACKAGE_VERSION_TO_FOLLOW: "react-router"
-          PUBLISHED_PACKAGES: ${{ needs.release.outputs.published_packages }}
-
-  comment:
-    name: 📝 Comment on related issues and pull requests
-    if: github.repository == 'remix-run/react-router' && github.event_name == 'push' && github.ref_name != 'release-v6' && needs.find_package_version.outputs.package_version != ''
-    needs: [release, find_package_version]
-    runs-on: ubuntu-latest
-    permissions:
-      issues: write # enable commenting on released issues
-      pull-requests: write # enable commenting on released pull requests
-    steps:
-      - name: ⬇️ Checkout repo
-        uses: actions/checkout@v6
-        with:
-          fetch-depth: 0
-
-      # IMPORTANT: if you make changes here, also make them in release-comment-manual.yml
-      - name: 📝 Comment on related issues and pull requests
-        uses: remix-run/release-comment-action@v0.5.1
-        with:
-          DIRECTORY_TO_CHECK: "./packages"
-          PACKAGE_NAME: "react-router"
-          ISSUE_LABELS_TO_REMOVE: "awaiting release"
-          ISSUE_LABELS_TO_KEEP_OPEN: "🗺 Roadmap"
+          # Look for change files in any package's .changes directory (excluding README.md)
+          change_files=$(find packages/*/.changes -name "*.md" ! -name "README.md" 2>/dev/null)
+          if [ -n "$change_files" ]; then
+            echo "Change files found (blocking publish):"
+            echo "$change_files"
+            echo "has_change_files=true" >> $GITHUB_OUTPUT
+          else
+            echo "No change files found, proceeding to publish."
+            echo "has_change_files=false" >> $GITHUB_OUTPUT
+          fi
 
-  # HEADS UP! this "nightly" job will only ever run on the `main` branch due to
-  # it being a cron job, and the last commit on main will be what github shows
-  # as the trigger however in the checkout below we specify the `dev` branch,
-  # so all the scripts in this job will be ran from that, confusing i know, so
-  # in some cases we'll need to create multiple PRs when modifying nightly
-  # release processes
-  release-nightly:
-    name: 🌒 Nightly Release
-    if: github.repository == 'remix-run/react-router' && github.event_name == 'schedule'
+  pull_request:
+    name: Open pull request
+    needs: check
+    if: needs.check.outputs.has_change_files == 'true'
     runs-on: ubuntu-latest
     permissions:
       contents: write # enable pushing changes to the origin
-      id-token: write # enable generation of an ID token for publishing
-    outputs:
-      # will be undefined if there's no release necessary
-      NEXT_VERSION: ${{ steps.version.outputs.NEXT_VERSION }}
+      pull-requests: write # enable opening a PR for the release
     steps:
-      - name: ⬇️ Checkout repo
-        uses: actions/checkout@v6
+      - name: Checkout
+        uses: actions/checkout@v4
         with:
-          ref: dev
-          # checkout using a custom token so that we can push later on
-          token: ${{ secrets.GITHUB_TOKEN }}
-          fetch-depth: 0
+          token: ${{ secrets.FORMAT_PAT }}
 
-      - name: 📦 Setup pnpm
+      - name: Install pnpm
         uses: pnpm/action-setup@v4
 
-      - name: ⎔ Setup node
-        uses: actions/setup-node@v6
+      - name: Install Node.js
+        uses: actions/setup-node@v4
         with:
-          node-version: 24 # Needed for npm@11 for Trusted Publishing
-          cache: "pnpm"
+          node-version: 24 # Needed to run typescript scripts directly
+          cache: pnpm
 
-      - name: 📥 Install deps
+      - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: 🕵️ Check for changes
-        id: version
-        run: |
-          SHORT_SHA=$(git rev-parse --short HEAD)
-
-          # get latest nightly tag
-          LATEST_NIGHTLY_TAG=$(git tag -l v0.0.0-nightly-\* --sort=-creatordate | head -n 1)
-
-          # check if last commit to dev starts with the nightly tag we're about
-          # to create (minus the date)
-          # if it is, we'll skip the nightly creation
-          # if not, we'll create a new nightly tag
-          if [[ ${LATEST_NIGHTLY_TAG} == v0.0.0-nightly-${SHORT_SHA}-* ]]; then
-            echo "🛑 Latest nightly tag is the same as the latest commit sha, skipping nightly release"
-          else
-            # yyyyMMdd format (e.g. 20221207)
-            DATE=$(date '+%Y%m%d')
-            # v0.0.0-nightly-<short sha>-<date>
-            NEXT_VERSION=0.0.0-nightly-${SHORT_SHA}-${DATE}
-            # set output so it can be used in other jobs
-            echo "NEXT_VERSION=${NEXT_VERSION}" >> $GITHUB_OUTPUT
-          fi
-
-      - name: ⤴️ Update version
-        if: steps.version.outputs.NEXT_VERSION
-        run: |
-          git config --local user.email "hello@remix.run"
-          git config --local user.name "Remix Run Bot"
-          git checkout -b nightly/${{ steps.version.outputs.NEXT_VERSION }}
-          pnpm run version ${{steps.version.outputs.NEXT_VERSION}}
-          git push origin --tags
-
-      - name: 🏗 Build
-        if: steps.version.outputs.NEXT_VERSION
-        run: pnpm build
-
-      - name: 🚀 Publish
-        if: steps.version.outputs.NEXT_VERSION
-        run: pnpm run publish
+      - name: Update PR
+        run: pnpm changes:pr
+        env:
+          GITHUB_TOKEN: ${{ secrets.FORMAT_PAT }}
 
-  release-experimental:
-    name: 🧪 Experimental Release
-    if: github.repository == 'remix-run/react-router' && github.event_name == 'workflow_dispatch'
+  publish:
+    name: Publish
+    needs: check
+    if: needs.check.outputs.has_change_files == 'false'
     runs-on: ubuntu-latest
     permissions:
       contents: write # enable pushing changes to the origin
       id-token: write # enable generation of an ID token for publishing
     steps:
       - name: ⬇️ Checkout repo
         uses: actions/checkout@v6
-        with:
-          ref: ${{ github.event.inputs.branch }}
-          # checkout using a custom token so that we can push later on
-          token: ${{ secrets.GITHUB_TOKEN }}
-          fetch-depth: 0
 
       - name: 📦 Setup pnpm
         uses: pnpm/action-setup@v4
@@ -242,18 +90,10 @@ jobs:
       - name: 📥 Install deps
         run: pnpm install --frozen-lockfile
 
-      - name: ⤴️ Update version
-        run: |
-          git config --local user.email "hello@remix.run"
-          git config --local user.name "Remix Run Bot"
-          SHORT_SHA=$(git rev-parse --short HEAD)
-          NEXT_VERSION=0.0.0-experimental-${SHORT_SHA}
-          git checkout -b experimental/${NEXT_VERSION}
-          pnpm run version ${NEXT_VERSION}
-          git push origin --tags
-
-      - name: 🏗 Build
+      - name: Build packages
         run: pnpm build
 
-      - name: 🚀 Publish
-        run: pnpm run publish
+      - name: Publish to npm and create releases
+        run: pnpm changes:publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

CHANGELOG.md

@@ -24,8 +24,8 @@ We manage release notes in this file instead of the paginated Github Releases Pa
     - [Patch Changes](#patch-changes-1)
     - [Unstable Changes](#unstable-changes-1)
   - [v7.13.1](#v7131)
-  - [What's Changed](#whats-changed-1)
-    - [URL Masking (unstable)](#url-masking-unstable)
+    - [What's Changed](#whats-changed-1)
+      - [URL Masking (unstable)](#url-masking-unstable)
     - [Patch Changes](#patch-changes-2)
     - [Unstable Changes](#unstable-changes-2)
   - [v7.13.0](#v7130)
@@ -408,29 +408,6 @@ We manage release notes in this file instead of the paginated Github Releases Pa
 
 </details>
 
-<!-- To add a new release, copy from this template:
-
-## v7.X.Y
-
-Date: YYYY-MM-DD
-
-### What's Changed
-
-#### Big New Feature 1
-
-#### Big New Feature 2
-
-### Minor Changes
-
-### Patch Changes
-
-### Unstable Changes
-
-⚠️  _[Unstable features](https://reactrouter.com/community/api-development-strategy#unstable-flags) are not recommended for production use_
-
-**Full Changelog**: [`v7.X.Y...v7.X.Y`](https://github.com/remix-run/react-router/compare/react-router@7.X.Y...react-router@7.X.Y)
--->
-
 ## v7.14.0
 
 Date: 2026-04-02
@@ -576,9 +553,9 @@ This parameter is primarily needed when adopting the new `future.unstable_passth
 
 Date: 2026-02-23
 
-## What's Changed
+### What's Changed
 
-### URL Masking (unstable)
+#### URL Masking (unstable)
 
 This release includes a new `<Link unstable_mask>` API which brings first-class support for URL masking to Framework/Data Mode ([RFC](https://github.com/remix-run/react-router/discussions/9864)). This allows the same type of UI you could achieve in Declarative Mode via [manual `backgroundLocation` management](https://github.com/remix-run/react-router/tree/main/examples/modal). That example has been converted to Data Mode using the new API [here](https://github.com/remix-run/react-router/tree/main/examples/modal-data-router).