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
Docs fixes for CLI usage (#14156)
Damian Legawiecb0257cedabe0
diff --git a/docs/developer/admin/admin.mdx b/docs/developer/admin/admin.mdxindex 521aa1e542..0dfec62954 100644--- a/docs/developer/admin/admin.mdx+++ b/docs/developer/admin/admin.mdx@@ -175,7 +175,17 @@ The Admin Dashboard uses [Tailwind CSS v4](https://tailwindcss.com/) for styling### Generator Commands-```bash+<CodeGroup>++```bash Spree CLI (Docker)+# Generate a complete admin section (controller, views, routes)+spree generate spree:admin:scaffold Spree::Brand++# Generate just a controller+spree generate controller Spree::Admin::Brands --skip-routes+```++```bash Without Spree CLI# Generate a complete admin section (controller, views, routes)bin/rails g spree:admin:scaffold Spree::Brand@@ -183,6 +193,8 @@ bin/rails g spree:admin:scaffold Spree::Brandbin/rails g controller Spree::Admin::Brands --skip-routes```+</CodeGroup>+## Authentication & Authorization### Authenticationdiff --git a/docs/developer/admin/custom-css.mdx b/docs/developer/admin/custom-css.mdxindex 6064d94639..fe50d2b006 100644--- a/docs/developer/admin/custom-css.mdx+++ b/docs/developer/admin/custom-css.mdx@@ -147,16 +147,32 @@ If you have admin-related code in non-standard locations, add additional `@sourcDuring development, run the Tailwind CSS watcher to automatically rebuild styles when you make changes:-```bash-bin/rails spree:admin:tailwindcss:watch+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:admin:tailwindcss:watch```-Or if you're using `Procfile.dev` with foreman:+```bash Without Spree CLI+bundle exec rake spree:admin:tailwindcss:watch+```-```bash+</CodeGroup>++Or run the full development process, which includes the watcher when it's defined in `Procfile.dev`:++<CodeGroup>++```bash Spree CLI (Docker)+spree dev+```++```bash Without Spree CLIbin/dev```+</CodeGroup>+The watcher monitors:- Your host app's CSS files in `app/assets/tailwind/`- The Spree Admin engine's CSS filesdiff --git a/docs/developer/core-concepts/pricing.mdx b/docs/developer/core-concepts/pricing.mdxindex 979d67656a..87d7129ba6 100644--- a/docs/developer/core-concepts/pricing.mdx+++ b/docs/developer/core-concepts/pricing.mdx@@ -230,18 +230,34 @@ endPrice history retention defaults to 30 days and can be configured globally. A Rake task is provided for cleanup:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:price_history:prune+```++```bash Without Spree CLIbundle exec rake spree:price_history:prune```+</CodeGroup>+### Seeding Existing PricesAfter enabling price history on an existing store, seed the current prices as a baseline:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:price_history:seed+```++```bash Without Spree CLIbundle exec rake spree:price_history:seed```+</CodeGroup>+## Related Documentation- [Products](/developer/core-concepts/products) — Products, Variants, and base pricesdiff --git a/docs/developer/core-concepts/translations.mdx b/docs/developer/core-concepts/translations.mdxindex b05c39d147..a500f8574a 100644--- a/docs/developer/core-concepts/translations.mdx+++ b/docs/developer/core-concepts/translations.mdx@@ -106,10 +106,18 @@ Spree stores UI translation strings in a separate project: [Spree I18n](https://To install UI translations:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_i18n+```++```bash Without Spree CLIbundle add spree_i18n```+</CodeGroup>+Once installed, all translation files are available automatically — no need to copy any files.<Info>diff --git a/docs/developer/customization/authentication.mdx b/docs/developer/customization/authentication.mdxindex aab7ef1119..8596738376 100644--- a/docs/developer/customization/authentication.mdx+++ b/docs/developer/customization/authentication.mdx@@ -20,10 +20,18 @@ Spree.user_class = 'User'Now, run the generator to set up Spree integration with Devise:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:authentication:devise+```++```bash Without Spree CLIbin/rails g spree:authentication:devise```+</CodeGroup>+This will create a new file in `lib/spree/authentication_helpers.rb` that serves as a bridge between Spree and your existing authentication system routes. You can then use this file to customize the routes to your liking. It should automatically pick up standard Devise routes.Secondly, this generator will add necessary modules to your `User` model.@@ -64,10 +72,18 @@ Spree.user_class = 'User'Now, run the generator to set up Spree integration with your custom authentication system:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:authentication:custom+```++```bash Without Spree CLIbin/rails g spree:authentication:custom```+</CodeGroup>+This will create a new file in `lib/spree/authentication_helpers.rb` that serves as a bridge between Spree and your existing authentication system routes. You will need to customize this file to fit your needs.Secondly, this generator will add necessary modules to your `User` model.diff --git a/docs/developer/customization/decorators.mdx b/docs/developer/customization/decorators.mdxindex f13cea2bc4..a4b2b21484 100644--- a/docs/developer/customization/decorators.mdx+++ b/docs/developer/customization/decorators.mdx@@ -90,10 +90,18 @@ Spree provides generators to create decorator files with the correct structure:### Model Decorator Generator-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:model_decorator Spree::Product+```++```bash Without Spree CLIbin/rails g spree:model_decorator Spree::Product```+</CodeGroup>+This creates `app/models/spree/product_decorator.rb`:```ruby@@ -110,10 +118,18 @@ end### Controller Decorator Generator-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:controller_decorator Spree::Admin::ProductsController+```++```bash Without Spree CLIbin/rails g spree:controller_decorator Spree::Admin::ProductsController```+</CodeGroup>+This creates `app/controllers/spree/admin/products_controller_decorator.rb`:```rubydiff --git a/docs/developer/customization/emails.mdx b/docs/developer/customization/emails.mdxindex b75c875bde..88eadb1d78 100644--- a/docs/developer/customization/emails.mdx+++ b/docs/developer/customization/emails.mdx@@ -14,10 +14,18 @@ Spree uses [postmark templates](https://github.com/wildbit/postmark-templates),Spree offers an emails preview generator for development purposes. To generate them, use the command:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:emails:install+```++```bash Without Spree CLIbin/rails g spree:emails:install```+</CodeGroup>+After that, start the rails server locally and go to: `localhost:3000/rails/mailers`(it requires a seeded development database in order to work properly)diff --git a/docs/developer/customization/model-preferences.mdx b/docs/developer/customization/model-preferences.mdxindex ccbc6f23b6..c11a61b2ba 100644--- a/docs/developer/customization/model-preferences.mdx+++ b/docs/developer/customization/model-preferences.mdx@@ -15,16 +15,32 @@ To define a model preference, you need to add them to your model class.Make sure to generate a migration to add the `preferences` column to the table. This column will store the preferences in a serialized format.-```ruby-rails g migration AddPreferencesToSpreeUsers preferences:text+<CodeGroup>++```bash Spree CLI (Docker)+spree generate migration AddPreferencesToSpreeUsers preferences:text```+```bash Without Spree CLI+bin/rails g migration AddPreferencesToSpreeUsers preferences:text+```++</CodeGroup>+Run the migration.-```ruby-rails db:migrate+<CodeGroup>++```bash Spree CLI (Docker)+spree migrate```+```bash Without Spree CLI+bin/rails db:migrate+```++</CodeGroup>+```rubyclass Spree::User < ApplicationRecord# ... you existing code ...diff --git a/docs/developer/deployment/caching.mdx b/docs/developer/deployment/caching.mdxindex f24ad54678..d847aa946a 100644--- a/docs/developer/deployment/caching.mdx+++ b/docs/developer/deployment/caching.mdx@@ -19,9 +19,16 @@ When `REDIS_URL` is set, Spree automatically uses it for caching. When not set,To enable caching in the development environment:-```bash-cd server+<CodeGroup>++```bash Spree CLI (Docker)+spree rails dev:cache+```++```bash Without Spree CLIbin/rails dev:cache```+</CodeGroup>+You will need to restart your web server after this.diff --git a/docs/developer/deployment/environment_variables.mdx b/docs/developer/deployment/environment_variables.mdxindex d08ff2f48b..e7f1d29e48 100644--- a/docs/developer/deployment/environment_variables.mdx+++ b/docs/developer/deployment/environment_variables.mdx@@ -86,10 +86,18 @@ After setting these, enable the provider and reindex:Spree.search_provider = 'Spree::SearchProvider::Meilisearch'```-```bash-rake spree:search:reindex+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:search:reindex+```++```bash Without Spree CLI+bundle exec rake spree:search:reindex```+</CodeGroup>+## Error Tracking (Sentry)| Variable | Default | Description |diff --git a/docs/developer/multi-store/quickstart.mdx b/docs/developer/multi-store/quickstart.mdxindex 835090e57b..a57c2ff157 100644--- a/docs/developer/multi-store/quickstart.mdx+++ b/docs/developer/multi-store/quickstart.mdx@@ -5,10 +5,18 @@ sidebarTitle: QuickstartTo enable multiple stores, you will need to add the `spree_multi_store` gem to your project via:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_multi_store+```++```bash Without Spree CLIbundle add spree_multi_store```+</CodeGroup>+<Info>Spree Multi-Store is licensed under the [AGPL v3 License](https://opensource.org/licenses/AGPL-3.0).diff --git a/docs/developer/multi-tenant/core-concepts.mdx b/docs/developer/multi-tenant/core-concepts.mdxindex abb630b804..9a9813e1c5 100644--- a/docs/developer/multi-tenant/core-concepts.mdx+++ b/docs/developer/multi-tenant/core-concepts.mdx@@ -17,10 +17,18 @@ All models that are tenanted inherit from `SpreeMultiTenant::Base` class. `spreeWhen creating a new model that you want to be tenanted remember to inherit from `SpreeMultiTenant::Base` and not from `Spree::Base` and add `tenant_id` column to the table, eg.-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate model Spree::NewModel tenant:references name:string --parent SpreeMultiTenant::Base+```++```bash Without Spree CLIbin/rails g model Spree::NewModel tenant:references name:string --parent SpreeMultiTenant::Base```+</CodeGroup>+<Info>You don't need to add `belongs_to :tenant` to the model, it's handled by gem.</Info>diff --git a/docs/developer/multi-tenant/installation.mdx b/docs/developer/multi-tenant/installation.mdxindex 972938cd9c..c8a24b9ac8 100644--- a/docs/developer/multi-tenant/installation.mdx+++ b/docs/developer/multi-tenant/installation.mdx@@ -43,10 +43,18 @@ Admin user classes will be shared across tenants allowing them to manage multiplLet's create a new model with Devise (unless you already have one):-```bash-rails g devise Spree::AdminUser+<CodeGroup>++```bash Spree CLI (Docker)+spree rails g devise Spree::AdminUser+```++```bash Without Spree CLI+bin/rails g devise Spree::AdminUser```+</CodeGroup>+Replace the generated Devise code with the following:```ruby@@ -89,16 +97,32 @@ Spree.admin_user_class = "Spree::AdminUser"2. Install gems:- ```bash+ <CodeGroup>++ ```bash Spree CLI (Docker)+ spree bundle install+ ```++ ```bash Without Spree CLIbundle install```+ </CodeGroup>+3. Run generators:- ```bash- bundle exec rails g spree_enterprise:install && bundle exec rails g spree_multi_tenant:install+ <CodeGroup>++ ```bash Spree CLI (Docker)+ spree generate spree_enterprise:install && spree generate spree_multi_tenant:install```+ ```bash Without Spree CLI+ bin/rails g spree_enterprise:install && bin/rails g spree_multi_tenant:install+ ```++ </CodeGroup>+<Info>This will copy and run migrations for `spree_enterprise` and `spree_multi_tenant` gems.</Info>diff --git a/docs/developer/multi-vendor/installation.mdx b/docs/developer/multi-vendor/installation.mdxindex ff89897ec8..4e6f4a452c 100644--- a/docs/developer/multi-vendor/installation.mdx+++ b/docs/developer/multi-vendor/installation.mdx@@ -38,16 +38,32 @@ description: Learn how to set up a multi-vendor marketplace with Spree2. Install gems:- ```bash+ <CodeGroup>++ ```bash Spree CLI (Docker)+ spree bundle install+ ```++ ```bash Without Spree CLIbundle install```+ </CodeGroup>+3. Run generators:- ```bash- bundle exec rails g spree_enterprise:install && bundle exec rails g spree_multi_vendor:install+ <CodeGroup>++ ```bash Spree CLI (Docker)+ spree generate spree_enterprise:install && spree generate spree_multi_vendor:install+ ```++ ```bash Without Spree CLI+ bin/rails g spree_enterprise:install && bin/rails g spree_multi_vendor:install```+ </CodeGroup>+<Info>This will copy and run migrations for `spree_enterprise` and `spree_multi_vendor` gems.</Info>diff --git a/docs/developer/storefront/rails/custom-css.mdx b/docs/developer/storefront/rails/custom-css.mdxindex dbc825a768..3124e56cb4 100644--- a/docs/developer/storefront/rails/custom-css.mdx+++ b/docs/developer/storefront/rails/custom-css.mdx@@ -10,10 +10,18 @@ Spree Storefront is built on top of [Tailwind CSS 4](https://tailwindcss.com/).If you're missing this file, or migrating from a previous version of Spree, you can generate it using the following command:-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:storefront:install+```++```bash Without Spree CLIbin/rails g spree:storefront:install```+</CodeGroup>+<Info>Tailwind 4 uses a CSS-first configuration approach. There's no `tailwind.config.js` file - all configuration is done directly in CSS using the `@theme` directive.</Info>diff --git a/docs/developer/storefront/rails/storefront.mdx b/docs/developer/storefront/rails/storefront.mdxindex 6785111606..d99d7711fd 100644--- a/docs/developer/storefront/rails/storefront.mdx+++ b/docs/developer/storefront/rails/storefront.mdx@@ -22,23 +22,53 @@ Rails Storefront is a mobile-first storefront that is fully customizable & themeYou can install it by running- ```bash- bundle add spree_storefront- ```+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_storefront+```++```bash Without Spree CLI+bundle add spree_storefront+```++</CodeGroup>Then run the install generator:- ```bash- bin/rails g spree:storefront:install- ```+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:storefront:install+```++```bash Without Spree CLI+bin/rails g spree:storefront:install+```++</CodeGroup>This will set up the storefront views, Tailwind CSS configuration, and page builder migrations.-You will also need to create your first theme:+You will also need to create your first theme. Open the Rails console:++<CodeGroup>++```bash Spree CLI (Docker)+spree console+```++```bash Without Spree CLI+bin/rails console+```++</CodeGroup>++And run:- ```bash- Spree::Store.default.send(:create_default_theme)- ```+```ruby+Spree::Store.default.send(:create_default_theme)+```### Architecturediff --git a/docs/developer/storefront/rails/themes.mdx b/docs/developer/storefront/rails/themes.mdxindex e34c865e22..c33beb7ab9 100644--- a/docs/developer/storefront/rails/themes.mdx+++ b/docs/developer/storefront/rails/themes.mdx@@ -18,10 +18,18 @@ Spree comes with a default theme called `default`. It is used as a base for allYou can create your custom themes by following the steps below.-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree generate spree:storefront:theme MyTheme+```++```bash Without Spree CLIbin/rails g spree:storefront:theme MyTheme```+</CodeGroup>+This command will create a new theme called `my_theme` in the `app/views/themes` directory and copy the default theme files to the new theme.It will also add a line in your `config/initializers/spree.rb` file to load the new theme.diff --git a/docs/developer/upgrades/5.4-to-5.5.mdx b/docs/developer/upgrades/5.4-to-5.5.mdxindex 3d7231fa58..2c3a23a41c 100644--- a/docs/developer/upgrades/5.4-to-5.5.mdx+++ b/docs/developer/upgrades/5.4-to-5.5.mdx@@ -20,15 +20,15 @@ For applications created via `create-spree-app` command we greatly recommend usi<CodeGroup>-```bash Spree CLI+```bash Spree CLI (Docker)spree upgrade``````bash Without Spree CLI# cd backend if you're in the monorepo rootbundle update-bin/rake spree:install:migrations && bin/rails db:migrate-bin/rake spree:upgrade+bundle exec rake spree:install:migrations && bin/rails db:migrate+bundle exec rake spree:upgrade```</CodeGroup>@@ -43,30 +43,46 @@ npm install -g @spree/clinpx @spree/cli upgrade```-The **Without Spree CLI** path is the bare equivalent. Use this on production: `bundle update` and `db:migrate` are part of your existing deploy pipeline (Heroku release phase, K8s init container, Capistrano hook, Render auto-migrate). Once the 5.5 release is up, run `bin/rake spree:upgrade` from a one-off dyno / job container / `kubectl exec` to perform the data backfills.+The **Without Spree CLI** path is the bare equivalent. Use this on production: `bundle update` and `db:migrate` are part of your existing deploy pipeline (Heroku release phase, K8s init container, Capistrano hook, Render auto-migrate). Once the 5.5 release is up, run `bundle exec rake spree:upgrade` from a one-off dyno / job container / `kubectl exec` to perform the data backfills.-Skipping versions and re-running are both safe — `bin/rake spree:upgrade` figures out what still needs to happen and does nothing on data that's already migrated.+Skipping versions and re-running are both safe — `bundle exec rake spree:upgrade` figures out what still needs to happen and does nothing on data that's already migrated.## What the upgrade does-This is reference material — what `bin/rake spree:upgrade` (and equivalently `spree upgrade`) actually executes on your data. Skip if you trust the tool; read on if something failed or you're curious.+This is reference material — what `bundle exec rake spree:upgrade` (and equivalently `spree upgrade`) actually executes on your data. Skip if you trust the tool; read on if something failed or you're curious.### Migrate legacy variant-pinned mediaIn 5.5 the [product is the default owner of media](/developer/core-concepts/media#product-level-gallery). Existing variant-pinned images keep rendering, but new admin uploads attach to the product. To consolidate both into a single gallery, the upgrade runs:-```bash-bin/rails spree:media:migrate_master_images_to_product_media+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:media:migrate_master_images_to_product_media+```++```bash Without Spree CLI+bundle exec rake spree:media:migrate_master_images_to_product_media```+</CodeGroup>+The task enqueues one `Spree::Media::MigrateProductAssetsJob` per product onto the `images` queue — make sure your job runner is processing that queue. Each job is idempotent, so re-running the task is safe; it skips products that no longer have variant-pinned assets.For larger catalogs, tune the batching with `BATCH_SIZE`:-```bash-bin/rails spree:media:migrate_master_images_to_product_media BATCH_SIZE=1000+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:media:migrate_master_images_to_product_media BATCH_SIZE=1000+```++```bash Without Spree CLI+bundle exec rake spree:media:migrate_master_images_to_product_media BATCH_SIZE=1000```+</CodeGroup>+<Warning>Run the task locally and on production. It does not block storefront rendering — new uploads attach to the product immediately — but until the enqueued jobs finish, old assets remain pinned to variants.</Warning>@@ -77,10 +93,18 @@ Spree 5.5 introduces [Sales Channels](/developer/core-concepts/channels) — a pThe migrations add a `default` boolean on `spree_channels`, a `store_id` column on `spree_products`, and create the new `spree_product_publications` table — **but they do not seed default channels, attach existing products to a store, or backfill order channels**. That work is done by an idempotent rake task:-```bash-bin/rake spree:channels:upgrade+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:channels:upgrade+```++```bash Without Spree CLI+bundle exec rake spree:channels:upgrade```+</CodeGroup>+The task runs four sub-tasks in order:1. `spree:channels:create_defaults` — creates the default "Online Store" channel for every existing store (via `Store#ensure_default_channel`).@@ -98,10 +122,18 @@ The task is fully idempotent — safe to re-run if it fails partway, and a no-opThe last step rebuilds the search index against the configured [search provider](/developer/core-concepts/search-filtering):-```bash-bin/rake spree:search:reindex+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:search:reindex+```++```bash Without Spree CLI+bundle exec rake spree:search:reindex```+</CodeGroup>+This is a no-op on the default Database provider (there is no external index to maintain). For Meilisearch — or any other external search provider — it is required, and it must run **after** the Channels upgrade: products only become visible to `Product.for_store` once they have a `store_id`, so reindexing before the channels step would index zero products. The manifest orders the steps accordingly.#### Multi-store catalogs@@ -140,7 +172,7 @@ The SDK bump pairs with one storefront code change in this release: the [payment## Required post-upgrade configuration-`bin/rake spree:upgrade` doesn't touch your job-runner config — every app uses a different scheduler, so this one is on you.+`bundle exec rake spree:upgrade` doesn't touch your job-runner config — every app uses a different scheduler, so this one is on you.### Schedule the Stock Reservations expiry jobdiff --git a/docs/integrations/analytics/google-analytics.mdx b/docs/integrations/analytics/google-analytics.mdxindex 2e84f6af4e..ed12021a7c 100644--- a/docs/integrations/analytics/google-analytics.mdx+++ b/docs/integrations/analytics/google-analytics.mdx@@ -16,10 +16,18 @@ With minimal setup required, you can gain valuable insights into how visitors inBefore you can enable Google Analytics 4, it must be installed. To do so, you need to run the following command:-```bash-bundle add spree_google_analytics && bundle exec rails g spree_google_analytics:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_google_analytics && spree generate spree_google_analytics:install+```++```bash Without Spree CLI+bundle add spree_google_analytics && bin/rails g spree_google_analytics:install```+</CodeGroup>+After that, make sure to restart your server if it was running.## Connect Google Analyticsdiff --git a/docs/integrations/analytics/google-tag-manager.mdx b/docs/integrations/analytics/google-tag-manager.mdxindex 12c5e2968a..3985921170 100644--- a/docs/integrations/analytics/google-tag-manager.mdx+++ b/docs/integrations/analytics/google-tag-manager.mdx@@ -26,10 +26,18 @@ Spree will automatically push ecommerce events to the dataLayer, but it’s up tBefore you can enable Google Tag Manager, it must be installed. To do so, you need to run the following command:-```bash-bundle add spree_google_analytics && bundle exec rails g spree_google_analytics:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_google_analytics && spree generate spree_google_analytics:install+```++```bash Without Spree CLI+bundle add spree_google_analytics && bin/rails g spree_google_analytics:install```+</CodeGroup>+After that, make sure to restart your server if it was running.## Connect Google Tag Managerdiff --git a/docs/integrations/marketing/klaviyo.mdx b/docs/integrations/marketing/klaviyo.mdxindex 7b23f0358d..d793ca7050 100644--- a/docs/integrations/marketing/klaviyo.mdx+++ b/docs/integrations/marketing/klaviyo.mdx@@ -16,10 +16,18 @@ With Spree’s native integration, you can start collecting meaningful data forTo install the Klaviyo integration, you need to run the following command:-```bash-bundle add spree_klaviyo && bundle exec rails g spree_klaviyo:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_klaviyo && spree generate spree_klaviyo:install+```++```bash Without Spree CLI+bundle add spree_klaviyo && bin/rails g spree_klaviyo:install```+</CodeGroup>+After that, you need to make sure to restart the server.## Connect Klaviyodiff --git a/docs/integrations/payments/adyen.mdx b/docs/integrations/payments/adyen.mdxindex 41bc02de96..e38ddf2d46 100644--- a/docs/integrations/payments/adyen.mdx+++ b/docs/integrations/payments/adyen.mdx@@ -10,10 +10,18 @@ Adyen is a global payment platform that enables businesses to accept payments acBefore you can enable Adyen, it must be installed. To do so, you need to run the following command:-```bash-bundle add spree_adyen --github spree/spree_adyen && bundle exec rails g spree_adyen:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_adyen --github spree/spree_adyen && spree generate spree_adyen:install+```++```bash Without Spree CLI+bundle add spree_adyen --github spree/spree_adyen && bin/rails g spree_adyen:install```+</CodeGroup>+After that, you need to make sure to restart the server.## Connect Adyendiff --git a/docs/integrations/payments/paypal.mdx b/docs/integrations/payments/paypal.mdxindex 065856009d..0383f4a1a1 100644--- a/docs/integrations/payments/paypal.mdx+++ b/docs/integrations/payments/paypal.mdx@@ -10,10 +10,18 @@ PayPal is a global online payment system that allows your customers to pay usingBefore you can enable PayPal, it must be installed. To do so, you need to run the following command:-```bash-bundle add spree_paypal_checkout && bundle exec rails g spree_paypal_checkout:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_paypal_checkout && spree generate spree_paypal_checkout:install+```++```bash Without Spree CLI+bundle add spree_paypal_checkout && bin/rails g spree_paypal_checkout:install```+</CodeGroup>+After that, you need to make sure to restart the server.## Connect PayPaldiff --git a/docs/integrations/payments/razorpay.mdx b/docs/integrations/payments/razorpay.mdxindex 3de0ba3b9a..ebada3b052 100644--- a/docs/integrations/payments/razorpay.mdx+++ b/docs/integrations/payments/razorpay.mdx@@ -14,12 +14,20 @@ Razorpay is a secure payment gateway that enables businesses to accept online pa## Installation-Before you can enable Razorpay, it must be installed. To do so, you need to add this line in Gemfile:+Before you can enable Razorpay, it must be installed. To do so, you need to run the following command:-```bash-bundle add spree_razorpay_checkout && bundle exec rails g spree_razorpay_checkout:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_razorpay_checkout && spree generate spree_razorpay_checkout:install+```++```bash Without Spree CLI+bundle add spree_razorpay_checkout && bin/rails g spree_razorpay_checkout:install```+</CodeGroup>+After that, you need to make sure to restart the server.## Connect Razorpaydiff --git a/docs/integrations/payments/stripe.mdx b/docs/integrations/payments/stripe.mdxindex 2f9bf8a791..4e02a3dedd 100644--- a/docs/integrations/payments/stripe.mdx+++ b/docs/integrations/payments/stripe.mdx@@ -14,10 +14,18 @@ Stripe is a widely used payment processor that enables secure and seamless transBefore you can enable Stripe, it must be installed. To do so, you need to run the following command:-```bash-bundle add spree_stripe && bundle exec rails g spree_stripe:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_stripe && spree generate spree_stripe:install+```++```bash Without Spree CLI+bundle add spree_stripe && bin/rails g spree_stripe:install```+</CodeGroup>+After that, you need to make sure to restart the server.## Connect Stripediff --git a/docs/integrations/search/meilisearch.mdx b/docs/integrations/search/meilisearch.mdxindex 93cb6f0632..d204a61d01 100644--- a/docs/integrations/search/meilisearch.mdx+++ b/docs/integrations/search/meilisearch.mdx@@ -55,10 +55,18 @@ For local development, Meilisearch runs without authentication by default — nogem 'meilisearch', '>= 0.28'```-```bash+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle install+```++```bash Without Spree CLIbundle install```+</CodeGroup>+### 3. Configure environment variables```bash@@ -80,10 +88,18 @@ Spree.search_provider = 'Spree::SearchProvider::Meilisearch'### 5. Index your products-```bash-rake spree:search:reindex+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:search:reindex```+```bash Without Spree CLI+bundle exec rake spree:search:reindex+```++</CodeGroup>+That's it. Your Store API now uses Meilisearch for all product search, filtering, and faceted navigation.## How It Works@@ -142,10 +158,18 @@ Each store gets its own Meilisearch index: `{store_code}_products`. For a store### Reindex all products-```bash-rake spree:search:reindex+<CodeGroup>++```bash Spree CLI (Docker)+spree rake spree:search:reindex+```++```bash Without Spree CLI+bundle exec rake spree:search:reindex```+</CodeGroup>+### Index a single product```rubydiff --git a/docs/integrations/tax/avalara.mdx b/docs/integrations/tax/avalara.mdxindex 287fe5879c..211fccfbd8 100644--- a/docs/integrations/tax/avalara.mdx+++ b/docs/integrations/tax/avalara.mdx@@ -12,10 +12,18 @@ Avalara AvaTax is an automated tax compliance platform that calculates accurateBefore you can enable Avalara AvaTax, it must be installed. To do so, run the following command:-```bash-bundle add spree_avatax_official && bundle exec rails g spree_avatax_official:install+<CodeGroup>++```bash Spree CLI (Docker)+spree bundle add spree_avatax_official && spree generate spree_avatax_official:install+```++```bash Without Spree CLI+bundle add spree_avatax_official && bin/rails g spree_avatax_official:install```+</CodeGroup>+After that, make sure to restart the server.## Connect Avalaradiff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.mdindex a76fb5bf28..dd86438ee6 100644--- a/packages/cli/CHANGELOG.md+++ b/packages/cli/CHANGELOG.md@@ -1,5 +1,11 @@# @spree/cli+## 2.1.2++### Patch Changes++- `spree generate controller` now forwards to the Rails `controller` generator instead of the non-existent `spree:controller`.+## 2.1.1### Patch Changesdiff --git a/packages/cli/package.json b/packages/cli/package.jsonindex 3818119931..6a0436f5de 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -1,6 +1,6 @@{"name": "@spree/cli",- "version": "2.1.1",+ "version": "2.1.2","description": "CLI for managing Spree Commerce projects","type": "module","bin": {diff --git a/packages/cli/src/commands/generate.ts b/packages/cli/src/commands/generate.tsindex 292b30727f..90d607175f 100644--- a/packages/cli/src/commands/generate.ts+++ b/packages/cli/src/commands/generate.ts@@ -7,6 +7,7 @@ import { dockerComposeExec } from '../docker.js'// intentionally absent — Spree provides `spree:model`.const RAILS_BUILTIN_GENERATORS = new Set(['migration',+ 'controller','scaffold','scaffold_controller','mailer',