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.

Spree 4.8 upgrade guide

Damian Legawiec3ed1bf083b2c
diff --git a/docs/developer/upgrades/4.4-to-4.5.mdx b/docs/developer/upgrades/4.4-to-4.5.mdx
index 129e8b166d..fa4055b5f8 100644
--- a/docs/developer/upgrades/4.4-to-4.5.mdx
+++ b/docs/developer/upgrades/4.4-to-4.5.mdx
@@ -1,8 +1,13 @@
---
title: 4.4 to 4.5
-description: This guide covers upgrading a 4.4 Spree application to Spree 4.5.
+description: This guide covers upgrading a 4.4 Spree application to Spree 4.5
---
+<Warning>
+We recommend [upgrading straight to 4.8](4.7-to-4.8), as we improved how we handle translations in 4.8.
+This also means easier database migration, especially if you have a big product catalog.
+</Warning>
+
<Note>
If you're on an older version than 4.4 please follow previous upgrade guides and perform those upgrades incrementally, eg.
diff --git a/docs/developer/upgrades/4.5-to-4.6.mdx b/docs/developer/upgrades/4.5-to-4.6.mdx
index 3a7daa2891..f7c2fcce09 100644
--- a/docs/developer/upgrades/4.5-to-4.6.mdx
+++ b/docs/developer/upgrades/4.5-to-4.6.mdx
@@ -3,6 +3,11 @@ title: 4.5 to 4.6
description: This guide covers upgrading a 4.5 Spree application to Spree 4.6.
---
+<Warning>
+We recommend [upgrading straight to 4.8](4.7-to-4.8), as we improved how we handle translations in 4.8.
+This also means easier database migration, especially if you have a big product catalog.
+</Warning>
+
<Note>
If you're on an older version than 4.5 please follow previous upgrade guides and perform those upgrades incrementally, e.g.
diff --git a/docs/developer/upgrades/4.6-to-4.7.mdx b/docs/developer/upgrades/4.6-to-4.7.mdx
index b473ba0deb..8f7f20a497 100644
--- a/docs/developer/upgrades/4.6-to-4.7.mdx
+++ b/docs/developer/upgrades/4.6-to-4.7.mdx
@@ -3,6 +3,11 @@ title: 4.6 to 4.7
description: This guide covers upgrading a 4.6 Spree application to Spree 4.7.
---
+<Warning>
+We recommend [upgrading straight to 4.8](4.7-to-4.8), as we improved how we handle translations in 4.8.
+This also means easier database migration, especially if you have a big product catalog.
+</Warning>
+
<Note>
If you're on an older version than 4.6 please follow previous upgrade guides and perform those upgrades incrementally
diff --git a/docs/developer/upgrades/4.x-to-4.8.mdx b/docs/developer/upgrades/4.x-to-4.8.mdx
new file mode 100644
index 0000000000..a994e43496
--- /dev/null
+++ b/docs/developer/upgrades/4.x-to-4.8.mdx
@@ -0,0 +1,48 @@
+---
+title: Upgrading to Spree 4.8
+description: This guide covers upgrading a Spree 4 application to Spree 4.8.
+---
+
+<Info>
+ Before proceeding to upgrade, please ensure you're at Spree 4.4 or later and Rails 6.1 or later.
+</Info>
+
+<AccordionGroup>
+ <Accordion title="1. Update gems">
+
+ ```bash
+ bundle update
+ ```
+ </Accordion>
+
+ <Accordion title="2. Install and run missing migrations">
+
+ ```bash
+ bin/rake railties:install:migrations && bin/rails db:migrate
+ ```
+ </Accordion>
+
+ <Accordion title="5. (Optional) Install importmap-rails gem">
+ We've switched to using [importmap-rails](https://github.com/rails/importmap-rails) for asset management. If you're using the `spree_backend` or `spree_frontend` gem, you'll need to install the `importmap-rails` gem.
+
+ ```bash
+ bundle add importmap-rails
+ ```
+
+ and run generators:
+
+ ```bash
+ bin/rails importmap:install && bin/rails turbo:install && bin/rails stimulus:install
+ ```
+
+ You can also remove the `jsbundling-rails` gem from your `Gemfile`:
+
+ ```bash
+ bundle remove jsbundling-rails
+ ```
+ </Accordion>
+</AccordionGroup>
+
+## Read the release notes
+
+For information about changes contained within this release, please read the [Spree 4.7.0 Release Notes.](https://github.com/spree/spree/releases/tag/v4.7.0)
diff --git a/docs/mint.json b/docs/mint.json
index cdc277e5c4..2663e6be9a 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -123,6 +123,7 @@
{
"group": "Upgrade Guides",
"pages": [
+ "developer/upgrades/4.x-to-4.8",
"developer/upgrades/4.6-to-4.7",
"developer/upgrades/4.5-to-4.6",
"developer/upgrades/4.4-to-4.5",