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
[Skip CI] improve 5.2->5.3 upgrade guide
Damian Legawiec4fddfa8b679f
diff --git a/bin/sandbox.sh b/bin/sandbox.shindex f5a25e9773..2f25f0d31f 100755--- a/bin/sandbox.sh+++ b/bin/sandbox.sh@@ -8,5 +8,5 @@ cd "$(dirname "$0")/.."echo "Creating Spree sandbox application..."-./install.sh --app-name=sandbox --verbose --auto-accept --local --force+./install.sh --app-name=sandbox --verbose --auto-accept --local --force --storefront=railsrm -rf sandbox/.gitdiff --git a/docs/developer/upgrades/5.2-to-5.3.mdx b/docs/developer/upgrades/5.2-to-5.3.mdxindex 7a28055161..b69489cff9 100644--- a/docs/developer/upgrades/5.2-to-5.3.mdx+++ b/docs/developer/upgrades/5.2-to-5.3.mdx@@ -23,6 +23,26 @@ bin/rake spree:install:migrations && bin/rails db:migrateThis will setup new database schema for the new features in Spree 5.3 like Price Lists and Customer Groups.+### Re-run Admin Panel Install Generator++Admin Panel was completely rewritten to use Tailwind v4 so you need to re-run the install generator to setup Tailwind and remove any Dart Sass related files.++ ```bash+ bin/rails g spree:admin:install+ ```++This will also modify your `Procfile.dev` file to include the new Tailwind CSS watch task instead of the old Dart Sass watch task.++#### Add listen gem to Gemfile++You also need to add `listen` gem to your Gemfile in the development group, unless you already have it.++ ```ruby+ group :development do+ gem 'listen', '>= 3.0'+ end+ ```+### Run counter cache rake tasksSpree 5.3 introduces counter caches for products, taxons and variants. You need to run the following rake tasks to populate the counter caches:@@ -55,26 +75,6 @@ This will populate the product metrics for all products in your database. ProducThis rake task will enqueue background jobs to populate the product metrics for all products in your database so you need to make sure that your background jobs are configured correctly.-### Re-run Admin Panel Install Generator--Admin Panel was completely rewritten to use Tailwind v4 so you need to re-run the install generator to setup Tailwind and remove any Dart Sass related files.-- ```bash- bin/rails g spree:admin:install- ```--This will also modify your `Procfile.dev` file to include the new Tailwind CSS watch task instead of the old Dart Sass watch task.--#### Add listen gem to Gemfile--You also need to add `listen` gem to your Gemfile in the development group, unless you already have it.-- ```ruby- group :development do- gem 'listen', '>= 3.0'- end- ```-### Update Storefront to Tailwind v4 (Optional)<Info>@@ -83,6 +83,8 @@ This is optional if you're not using the `spree_storefront` gem.Spree 5.3 requires Tailwind v4 as it's also used now for the Admin panel so you need to update your Storefront to Tailwind v4 as well.+If you didn't update your Storefront to Tailwind v4 in the previous upgrade guide, you need to do it now.+Running `bundle update` previously installed Tailwind v4. You only need to run```bash@@ -93,3 +95,13 @@ This will:1. Overwrite `config/tailwind.config.js` file with the new Tailwind v4 configuration.2. Add `app/assets/tailwind/application.css` file with the new Tailwind v4 styles. If you modified `app/assets/stylesheets/application.tailwind.css` file, you will need to merge your changes with the new one.++### Include Page Builder factories (Optional)++Page Builder was extracted to a separate gem (`spree_page_builder`) so you need to include the Page Builder factories in your test suite if you were using them in your tests++Add this line to your `spec_helper.rb` file:++ ```ruby+ require 'spree/page_builder/testing_support/factories'+ ```\ No newline at end of filediff --git a/docs/docs.json b/docs/docs.jsonindex 3fa845f936..6f35b08387 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -169,7 +169,6 @@"developer/customization/metadata","developer/customization/routes","developer/customization/api",- "developer/customization/promotions","developer/customization/extensions"]},