Catalogskills.sh · rstackjs

rspack-v2-upgrade

Use when upgrading a Rspack 1.x project to v2, including dependency and configuration updates.

Pending analysisVerified hub502 installs

Savant verdict: Pending analysis

Imported from the source hub; Savant's analysis is still running.

Live evaluation

Not evaluated yet. Workspaces can request a live evaluation.

Security assessment

Scan pending.

Structure

  • No license declaredConfirm you may reuse this skill before importing it into your repository.

SKILL.md

---
name: rspack-v2-upgrade
description: Use when upgrading a Rspack 1.x project to v2, including dependency and configuration updates.
---

# Rspack 1.x to v2 upgrade

## Workflow

1. **Confirm current setup**
   - Read `package.json` to identify Rspack packages in use.
   - Locate the Rspack config file (commonly `rspack.config.(ts|js|mjs|cjs)`).

2. **Open the official migration guide**
   - Use the official guide as the single source of truth:
     - https://rspack.rs/guide/migration/rspack_1.x

3. **Plan required changes**
   - Compare the current project config with the migration guide.
   - List breaking changes that apply to the project’s current config and plugins.
   - Note any removed or renamed options, defaults, or plugin APIs.

4. **Update dependencies**
   - Upgrade Rspack packages to v2: `@rspack/core`, `@rspack/cli`, `@rspack/dev-server`, `@rspack/plugin-react-refresh`.

5. **Apply migration changes**
   - Update the Rspack config and related code according to the official guide.
   - Remove deprecated or unsupported options.

6. **Validate**
   - Run build and dev commands.
   - Run project tests or type checks.
   - Fix any warnings or errors surfaced by the new version.