# React Router Template Dep Bump

> React Router Template Dep Bump is an Agent Skill for development published in the remix-run/react-router-templates repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Update pinned react-router and @react-router package versions in the remix-run/react-router-templates repo, refresh the pnpm lockfile, and verify with the Playwright suite in .tests.

- Skill name: `react-router-template-dep-bump`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/remix-run/react-router-templates/blob/HEAD/.agents/skills/react-router-template-dep-bump/SKILL.md
- Repository: remix-run/react-router-templates (649 GitHub stars when collected)

## SKILL.md

# React Router Template Dep Bump

Use this when updating React Router dependencies in `react-router-templates`.

Run these commands from the repo root.

## 1. Confirm the current pins

```sh
rg -n '(@react-router/[^@\" ]+@|react-router@|"(?:react-router|@react-router/[^"]+)"\s*:)' . \
  --glob '!**/node_modules/**' \
  --glob '!pnpm-lock.yaml' \
  --glob '!deno.lock'
```

This repo has both Node and Deno templates. Do not limit the search to
`package.json` files: the Deno template pins React Router packages in
`deno/deno.jsonc`, including both task commands such as
`deno run -A npm:@react-router/dev@x.y.z ...` and import-map entries such as
`"react-router": "npm:react-router@x.y.z"`.

## 2. Resolve the latest published React Router versions

```sh
pnpm view react-router version
pnpm view <currently-used-@react-router-package> version
```

Run the second command once for each `@react-router/*` package currently used
in the template pins from step 1. Use the shared latest version across that
family when they match.

## 3. Update the pinned versions in every affected template

Update all matching pins for `react-router` and every currently used
`@react-router/*` dependency:

- `package.json` entries in Node-based templates
- `deno/deno.jsonc` task command pins and import-map entries

Check the touched files with:

```sh
git diff --name-only
```

## 4. Refresh the lockfile

```sh
pnpm install
```

If `deno/deno.jsonc` changed, also refresh Deno's local install/lock metadata:

```sh
deno install
```

`deno/deno.lock` is intentionally untracked in this repo. Do not add it unless
the repository starts tracking it separately.

## 5. Run the Playwright tests

Install the browser if needed:

```sh
pnpm --dir .tests playwright install chromium
```

Then run the suite:

```sh
pnpm --dir .tests test
```

If Chromium fails to launch with a macOS sandbox error like `MachPortRendezvousServer ... Permission denied`, rerun the same test command outside the sandbox or with elevated permissions.

## 6. Sanity check the diff

```sh
git status --short
git diff --stat
```

Expected result:
- template `package.json` files and `deno/deno.jsonc` updated to one React
  Router version
- `pnpm-lock.yaml` refreshed
- `deno/deno.lock` not added unless it was already tracked
- `pnpm --dir .tests test` passes

## 7. Report other outdated packages

After the React Router bump is complete and tests pass, run:

```sh
pnpm outdated -r --format json
```

Reply with the remaining outdated packages grouped by update type:
- major
- minor
- patch

Then ask whether the user wants to update any of those packages next.

---

Source: https://www.openparable.com/skill/development/react-router-template-dep-bump (OpenParable). Cite the canonical URL above.
