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.
Ruby b2b-commercee-commerceecommerceecommerce-apiecommerce-frameworkecommerce-platformheadlessheadless-commerceheadless-ecommercemarketplacemulti-tenantmulti-vendormulti-vendor-ecommerceopen-sourcespree-commerce
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.mdxindex 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.mdxindex 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.6description: 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.mdxindex 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.7description: 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 incrementallydiff --git a/docs/developer/upgrades/4.x-to-4.8.mdx b/docs/developer/upgrades/4.x-to-4.8.mdxnew file mode 100644index 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.jsonindex 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",