spree-upgrade

Automate Spree Commerce upgrades with gem updates, migrations, and data backfills.

4|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/spree/agent-skills --skill spree-upgrade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spree-upgrade
Source: https://github.com/spree/agent-skills/tree/main/skills/spree-upgrade
Command: npx skills add https://github.com/spree/agent-skills --skill spree-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the complexity and potential risks associated with upgrading Spree to a new version, providing a streamlined process to ensure a smooth transition.

Core Features & Use Cases

  • Automated Upgrade Process: Handles the entire upgrade process, including updating gems, applying migrations, and running data backfills.
  • Version-Specific Data Backfills: Ensures that version-specific data is correctly backfilled during the upgrade.
  • Interactive and Non-Interactive Modes: Supports both interactive and non-interactive modes for use in CI/CD pipelines and production environments.

Quick Start

Run the spree upgrade command to start the upgrade process.

Frequently Asked Questions about spree-upgrade

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

FAQPage Schema
How do I upgrade Spree Commerce to the latest version?▼

The Spree upgrade process handles gem updates, database migrations, and data backfills automatically, ensuring all necessary steps are taken to update your application to the latest version.

Can I run the Spree upgrade process in a CI/CD pipeline?▼

Yes, you can run the Spree upgrade in a CI/CD pipeline using the supported non-interactive mode, which automates the upgrade process without requiring manual input during gem updates and migrations.

What does the Spree upgrade process do with database migrations and data backfills?▼

The Spree upgrade process automatically applies database migrations and runs version-specific data backfills, ensuring your database schema and data are correctly updated to match the new Spree version.

Does the Spree upgrade tool work for both development and production environments?▼

Yes, the Spree upgrade tool is designed for both development and production environments, offering interactive and non-interactive modes to safely handle gem updates and data backfills across different deployment contexts.

What is the best way to handle version-specific data backfills when upgrading Spree?▼

The best way to handle version-specific data backfills during a Spree upgrade is to use the automated upgrade command, which ensures version-specific data is correctly backfilled as part of the migration process.

Why does upgrading Spree Commerce require handling gem updates and migrations separately?▼

Upgrading Spree Commerce does not require handling them separately; the automated upgrade process consolidates gem updates, database migrations, and data backfills into a single streamlined workflow to reduce complexity and risk.