@spree/docs 0.1.82 → 0.1.84

package/dist/api-reference/store-api/errors.md

@@ -1,6 +1,6 @@
 ---
 title: Errors
-description: Error response format, error codes, and handling strategies
+description: Reference for Spree Store API error responses — JSON format, machine-readable codes, HTTP status codes, validation details, and retry strategies.
 ---
 
 The Store API uses a consistent, Stripe-style error format across all endpoints. Every error response includes a machine-readable `code` and a human-readable `message`.

package/dist/api-reference/store-api/idempotency.md

@@ -1,7 +1,7 @@
 ---
 title: "Idempotency"
 sidebarTitle: "Idempotency"
-description: "Prevent duplicate operations with idempotency keys"
+description: "Use Idempotency-Key headers on Spree Store API mutations to safely retry carts, checkouts, and payments without creating duplicate side effects."
 ---
 
 The Store API supports idempotency keys on mutating endpoints. This lets you safely retry requests without risking duplicate side effects — for example, adding an item to cart twice or creating duplicate payments due to network timeouts.

package/dist/developer/cli/quickstart.md

@@ -1,7 +1,7 @@
 ---
 title: Spree CLI
 sidebarTitle: Overview
-description: Manage your Spree Commerce project from the command line.
+description: Install and use the @spree/cli to scaffold, run, build, migrate, and upgrade Docker-based Spree Commerce projects from the command line.
 ---
 
 The Spree CLI (`@spree/cli`) manages Docker-based Spree projects created with [create-spree-app](../create-spree-app/quickstart.md).

package/dist/developer/contributing/creating-an-extension.md

@@ -1,6 +1,6 @@
 ---
 title: Creating an Extension
-description: Learn how to create a Spree extension.
+description: Step-by-step guide to building a Spree extension gem — scaffolding, decorators, migrations, assets, and packaging for distribution.
 ---
 
 ## Overview

package/dist/developer/contributing/developing-spree.md

@@ -1,8 +1,6 @@
 ---
 title: Developing Spree
-description: >-
-  This guide covers all the necessary steps to contributing to Spree source
-  code. We're happy you're here!
+description: Set up a Spree development environment with Docker, run the test suite, and submit pull requests to contribute to the Spree Commerce source code.
 ---
 
 Please read our [Code of Conduct](https://github.com/spree/spree/blob/main/CODE_OF_CONDUCT.md) before contributing.
@@ -80,10 +78,11 @@ Which command after which change:
 | What changed | What to run |
 |---|---|
 | Ruby code in `spree/*` gems | Nothing — gems are bind-mounted; code reloads on the next request |
-| A new migration in a gem | `cd server && pnpm exec spree migrate` |
-| Gem dependencies (gemspec / Gemfile) | `cd server && pnpm exec spree bundle install` (persists in the `bundle_cache` volume) |
+| A new migration in a gem | Nothing — the next `pnpm server:dev` boot applies it (or `cd server && pnpm exec spree migrate` while the stack runs) |
+| Gem dependencies (gemspec / Gemfile / lock drift after `git pull`) | Nothing — the next `pnpm server:dev` boot self-heals via `bundle check || bundle install` (or `cd server && pnpm exec spree bundle install` while the stack runs) |
 | Compose files / `server/.env` | `pnpm server:dev` (force-recreates the containers) |
-| `server/Dockerfile` / `.ruby-version` | `pnpm server:build`, then `pnpm server:dev` |
+| `server/Dockerfile` / `.ruby-version` / starter update that breaks the image build ("lockfile can't be updated because frozen") | `pnpm server:build`, then `pnpm server:dev` — the build script handles the edge-rewritten `Gemfile.lock` automatically |
+| Meilisearch image bump ("database version … is incompatible") | Remove the `server_meilisearch_data` volume, boot, then reindex (`pnpm exec spree rake spree:search:reindex`) — the index is derived data |
 | Broken beyond repair | `pnpm server:setup` (full reset — wipes the database and volumes) |
 
 Re-run `pnpm server:setup` **only** to fully reset — it does `docker compose down -v` + `rm -rf ./server`, wiping all DB data.

package/dist/developer/core-concepts/addresses.md

@@ -1,6 +1,6 @@
 ---
 title: Addresses
-description: Addresses, countries, states, and zones — how geography drives checkout, taxes, and shipping
+description: How Spree models addresses, countries, states, and zones, and how geographic data drives checkout, tax calculation, and shipping rates.
 ---
 
 ## Overview

package/dist/developer/core-concepts/adjustments.md

@@ -1,6 +1,6 @@
 ---
 title: Adjustments
-description: How taxes, promotions, and other price modifications are applied to orders
+description: How Spree adjustments apply taxes, promotions, and other price modifications to orders, line items, and shipments, and how totals are recalculated.
 ---
 
 ## Overview

package/dist/developer/core-concepts/customers.md

@@ -1,6 +1,6 @@
 ---
 title: Customers
-description: Customer accounts — registration, authentication, profiles, and guest checkout
+description: How Spree models customer accounts — registration, authentication, addresses, order history, store credits, and guest checkout behavior.
 ---
 
 import { Since } from '/snippets/since.mdx';

package/dist/developer/core-concepts/events.md

@@ -1,6 +1,6 @@
 ---
 title: Events
-description: Learn how Spree's event system works and how to subscribe to events.
+description: Spree's event system — publish and subscribe to lifecycle events from orders, products, and users to trigger background jobs and integrations.
 ---
 
 import { Since } from '/snippets/since.mdx';

package/dist/developer/core-concepts/markets.md

@@ -1,6 +1,6 @@
 ---
 title: Markets
-description: Multi-region commerce with Markets — bundle geography, currency, and locale into distinct selling regions within a single store.
+description: Configure Spree Markets to bundle geography, currency, and locale into distinct selling regions and run multi-region commerce from a single store.
 ---
 
 import { Since } from '/snippets/since.mdx';

package/dist/developer/core-concepts/media.md

@@ -1,7 +1,7 @@
 ---
 title: Media
 sidebarTitle: "Media"
-description: Product media (images, videos), named variants, focal points, and how media is served via the Store API
+description: Manage product media in Spree — images, videos, named variants, focal points, and how media is uploaded, resized, and served via the Store API.
 ---
 
 import { Since } from '/snippets/since.mdx';

package/dist/developer/core-concepts/orders.md

@@ -1,6 +1,6 @@
 ---
 title: Orders
-description: Order lifecycle, checkout flow, line items, payments, and shipments
+description: How Spree models orders — the cart-to-completion lifecycle, checkout state machine, line items, payments, shipments, and order totals.
 ---
 
 ## Overview

package/dist/developer/core-concepts/promotions.md

@@ -1,6 +1,6 @@
 ---
 title: Promotions
-description: Learn about Spree's flexible promotion system for discounts, free shipping, and gifts.
+description: Build percentage and fixed-amount discounts, free shipping, BOGO offers, and coupon codes with Spree's rule and action-based promotion system.
 ---
 
 ## Overview

package/dist/developer/core-concepts/search-filtering.md

@@ -1,6 +1,6 @@
 ---
 title: Search & Filtering
-description: "Search, filter, and sort products and other resources via the Store API"
+description: "Use Ransack-style query parameters to search, filter, sort, and paginate products, taxons, and other resources through the Spree Store API."
 ---
 
 import { Since } from '/snippets/since.mdx';

package/dist/developer/core-concepts/shipments.md

@@ -1,6 +1,6 @@
 ---
 title: Shipments
-description: Shipping methods, rates, split shipments, and fulfillment
+description: How Spree models shipments, shipping methods, calculators, stock locations, split shipments, and the fulfillment workflow from order to delivery.
 ---
 
 import { Since } from '/snippets/since.mdx';

package/dist/developer/core-concepts/stores.md

@@ -1,6 +1,6 @@
 ---
 title: Stores
-description: The Store is Spree's top-level tenant — products, orders, channels, markets, and stock locations all belong to exactly one store.
+description: The Store is Spree's top-level multi-tenant boundary — learn how products, orders, channels, markets, and stock locations are scoped to a store.
 ---
 
 ## Overview

package/dist/developer/core-concepts/translations.md

@@ -1,6 +1,6 @@
 ---
 title: Translations
-description: Translate product content and other resources into multiple languages
+description: Translate Spree products, taxons, and other store content into multiple languages using Mobility-backed translations and locale-aware APIs.
 ---
 
 ## Overview

package/dist/developer/core-concepts/users.md

@@ -1,6 +1,6 @@
 ---
 title: Users
-description: Customers and admin users — authentication, accounts, and permissions
+description: How Spree models customer and admin users — Devise authentication, account data, roles, abilities, and access permissions across stores.
 ---
 
 ## Overview

package/dist/developer/create-spree-app/quickstart.md

@@ -1,7 +1,7 @@
 ---
 title: "create-spree-app"
 sidebarTitle: Overview
-description: "Scaffold a new Spree Commerce project with a single command. Includes a full Rails backend app for customization."
+description: "Scaffold a new Spree Commerce project with a single command — bootstraps a full Rails backend, Docker dev stack, and the @spree/cli for customization."
 ---
 
 ## Quick Start

package/dist/developer/customization/checkout.md

@@ -1,6 +1,6 @@
 ---
 title: Checkout Flow
-description: Learn how to customize the checkout process in Spree.
+description: Customize the Spree checkout flow with the checkout DSL — add, remove, or conditionally skip address, delivery, payment, and confirmation steps.
 version: v5
 ---
 

package/dist/developer/customization/decorators.md

@@ -1,6 +1,6 @@
 ---
 title: Decorators
-description: Decorators allow you to add or modify behavior of Spree classes in your application.
+description: Use Spree decorators to add or modify behavior on core models, controllers, and helpers without forking the gem — patterns, file layout, and pitfalls.
 ---
 
 > **WARNING:** **Decorators should be a last resort.** They tightly couple your code to Spree internals and can break during upgrades. Before using decorators, consider these modern alternatives that are safer and easier to maintain:

package/dist/developer/customization/quickstart.md

@@ -1,7 +1,7 @@
 ---
 title: Quickstart
 og:title: Spree Customization Quickstart
-description: Learn how to customize every part of the Spree stack
+description: Recommended ways to customize Spree — store settings, configuration, events, webhooks, dependencies, admin extensions, and decorators as a last resort.
 ---
 
 Spree is a flexible platform allowing you to customize every part of it to suit your business needs. This guide presents customization options **in order of recommendation** - start from the top and only move down if simpler options don't meet your needs.

package/dist/developer/deployment/environment_variables.md

@@ -1,5 +1,6 @@
 ---
 title: Environment Variables
+description: Reference for Spree deployment environment variables — database, Redis, SMTP, web server, file storage, and application configuration settings.
 ---
 
 Spree uses environment variables for all deployment configuration. No secrets or credentials are stored in the codebase.

package/dist/developer/sdk/store/markets.md

@@ -1,6 +1,6 @@
 ---
 title: Markets
-description: Fetch markets, resolve by country, and list market countries with the Spree SDK
+description: Use the Spree Storefront SDK to list markets, resolve a market by country, and fetch the countries available within each market for checkout.
 ---
 
 ## List Markets

package/dist/developer/tutorial/extending-models.md

@@ -1,6 +1,6 @@
 ---
 title: Extending Core Models
-description: Learn how to extend Spree's core models to connect Brands with Products
+description: Tutorial — extend Spree's core models with a custom Brand resource, generate a migration, and associate it with Products via a decorator.
 ---
 
 In this tutorial, we'll connect our custom Brand model with Spree's core Product model. This is a common pattern when building features that need to integrate with existing Spree functionality.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spree/docs",
-  "version": "0.1.82",
+  "version": "0.1.84",
   "description": "Spree Commerce developer documentation for AI agents and local reference",
   "type": "module",
   "license": "CC-BY-4.0",