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.