skills.rest
rstackjs
rstackjsOFFICIAL
Explore all skills by this author →
Website𝕏@rspack_devGitHub

rspress-v2-upgrade

Migrate Rspress v1 projects to v2 by updating dependencies, configs, and themes.

86|1|Updated Jan 20, 2026
Search Tags:#dependencies#migration#config#themes#upgrade#rspress#v2
One-click install
npx skills add https://github.com/rstackjs/agent-skills --skill rspress-v2-upgrade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rspress-v2-upgrade
Source: https://github.com/rstackjs/agent-skills/tree/main/skills/rspress-v2-upgrade
Command: npx skills add https://github.com/rstackjs/agent-skills --skill rspress-v2-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill migrates Rspress v1 projects to v2 by updating dependencies, configs, and themes to align with the official migration guide.

Core Features & Use Cases

  • Update dependencies to @rspress/core@^2.0.0 and remove deprecated plugins that are bundled into the core.
  • Update import paths and theme usage to their v2 equivalents, ensuring compatibility with new runtime APIs.
  • Validate the upgrade by running the build and dev server following the official migration guide.

Quick Start

Run the upgrade workflow against your Rspress v1 project to migrate to v2 using the official guide.

Frequently Asked Questions about rspress-v2-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my Rspress v1 project to v2?▼

Migrate your Rspress v1 project to v2 by updating dependencies to @rspress/core@^2.0.0, removing deprecated plugins now bundled in core, updating import paths, and validating the build. This Skill applies the official migration guide automatically across configs, plugins, and themes.

What dependencies need to be updated for Rspress v2?▼

Upgrade to @rspress/core@^2.0.0 and remove deprecated plugins that are now part of the core package. Import paths and theme usage also change in v2 to align with new runtime APIs.

Do I need to update my Rspress config and theme files for v2?▼

Yes. Rspress v2 requires updating configs and themes to match v2 equivalents. Import paths and theme usage change to support new runtime APIs, and this migration enforces those updates per the official guide.

How do I validate that my Rspress v2 migration worked?▼

Validate the upgrade by running the build and dev server after migration. This confirms dependencies, configs, plugins, and themes are correctly aligned with v2 and working as expected.

Can I automate the Rspress v1 to v2 upgrade process?▼

Yes. This Skill automates the full Rspress migration workflow, handling dependency updates, import-path changes, config revisions, and theme updates against the official v2 migration guide.

What happens to deprecated Rspress plugins during v2 migration?▼

Deprecated plugins are removed during migration because they're now bundled into @rspress/core@^2.0.0. The migration enforces this cleanup to align with v2 architecture.

Related Skills

Explore More Software Engineering Skills→
ruxelionruxelion

rspress-v2-upgrade

Automate Rspress project migration from version 1 to version 2.

Official
Advanced
first-mover-twfirst-mover-tw
7

sui-deployer

Orchestrate staged SUI Move package deployments across devnet, testnet, and mainnet.

Official
Advanced
TheBushidoCollectiveTheBushidoCollective
187

tailwind-configuration

Configure tailwind.config.js for content paths, theme extensions, plugins, and core options.

Official
Intermediate
lazygopherslazygophers
7

rspress-best-practices

Review and troubleshoot Rspress v2 documentation site configurations, navigation metadata, and build behavior.

Official
Advanced