Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Added Spree 5.0 to 5.1 upgrade guide

Damian Legawiec481dc20c84e1
diff --git a/docs/developer/upgrades/5.0-to-5.1.mdx b/docs/developer/upgrades/5.0-to-5.1.mdx
new file mode 100644
index 0000000000..aa79d5cedc
--- /dev/null
+++ b/docs/developer/upgrades/5.0-to-5.1.mdx
@@ -0,0 +1,34 @@
+---
+title: Upgrading to Spree 5.1
+description: This guide covers upgrading a Spree 5.0 application to Spree 5.1.
+---
+
+<Info>
+ Before proceeding to upgrade, please ensure you're at [Spree 5.0](/developer/upgrades/4.10-to-5.0)
+</Info>
+
+## Upgrade steps
+
+<AccordionGroup>
+ <Accordion title="1. Update gems">
+
+ ```bash
+ bundle update
+ ```
+ </Accordion>
+
+ <Accordion title="2. Install and run missing migrations">
+
+ ```bash
+ bin/rake spree:install:migrations && bin/rails db:migrate
+ ```
+ </Accordion>
+
+ <Accordion title="3. Migrate admin user accounts to the new system">
+ Spree 5.1 introduces a new better way of managing admin user accounts. To ensure your existing admin user accounts are migrated to the new system, run the following command:
+
+ ```bash
+ bin/rake db:migrate_admin_users_to_role_users
+ ```
+ </Accordion>
+</AccordionGroup>
diff --git a/docs/docs.json b/docs/docs.json
index 85f02272c7..39e9a2a6d3 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -117,6 +117,7 @@
{
"group": "Upgrade Guides",
"pages": [
+ "developer/upgrades/5.0-to-5.1",
"developer/upgrades/4.10-to-5.0",
"developer/upgrades/4.9-to-4.10",
"developer/upgrades/4.8-to-4.9",