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.

Release of all new beta versions of TS packages to sync with Spree 6 beta

Damian Legawiec8d07bce0a45a
diff --git a/.changeset/address-form-store-default-country.md b/.changeset/address-form-store-default-country.md
deleted file mode 100644
index b1c105de01..0000000000
--- a/.changeset/address-form-store-default-country.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-"@spree/dashboard-core": patch
-"@spree/admin-sdk": patch
----
-
-New address forms pre-select the store's default country.
-
-The Admin store payload now includes `default_country_code` (the same country the default market already answers). The shared address dialog uses it for new records and leaves an existing address's country alone.
diff --git a/.changeset/admin-api-geography-codes.md b/.changeset/admin-api-geography-codes.md
deleted file mode 100644
index 7e4de6f19c..0000000000
--- a/.changeset/admin-api-geography-codes.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-'@spree/admin-sdk': major
-'@spree/sdk': major
----
-
-Rename the geography fields to `country_code` and `state_code` across the v3 API, replacing `country_iso` and `state_abbr`. Addresses, stock locations, delivery zone members, markets, tax rates and tax exemption certificates all use the new names, on read and on write. Markets rename their list of countries from `country_isos` to `country_codes`.
-
-Addresses keep `country_iso` and `state_abbr` as deprecated read fields and accepted write names for one release, so existing storefronts keep working; both are removed in 6.1. Every other resource moves outright.
diff --git a/.changeset/admin-sdk-setup-country.md b/.changeset/admin-sdk-setup-country.md
deleted file mode 100644
index ffeb3cadd4..0000000000
--- a/.changeset/admin-sdk-setup-country.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-'@spree/admin-sdk': major
----
-
-First-run setup asks which country the store sells from.
-
-`completeSetup` now requires `country_code` and accepts optional `locale` and `currency`. Both default to the country's own — its first official language and its currency — so a store's money and geography agree unless you say otherwise. An unrecognised currency is now rejected rather than quietly ignored.
-
-`login`, `acceptInvitation`, `resetPassword` and `completeSetup` on the dashboard auth context now resolve with the session they establish, so callers can read the signed-in user without waiting for provider state.
-
-A new `auth.setupCountries()` lists the countries a store can be set up in, each with the currency and official languages derived from it. Like the rest of the setup flow it needs no credentials, and stops answering once an admin account exists.
diff --git a/.changeset/cache-countries-list.md b/.changeset/cache-countries-list.md
deleted file mode 100644
index f7ac51fc6b..0000000000
--- a/.changeset/cache-countries-list.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@spree/dashboard-core": patch
----
-
-Country pickers load the country list once per page and reuse it.
-
-The list is reference data and does not change at runtime, so later address fields and country selects no longer call the API again.
diff --git a/.changeset/cli-drop-admin-stylesheets.md b/.changeset/cli-drop-admin-stylesheets.md
deleted file mode 100644
index a8e432f2ed..0000000000
--- a/.changeset/cli-drop-admin-stylesheets.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@spree/cli': major
----
-
-Dropped the legacy Rails admin from the CLI.
-
-`spree_admin` is removed in Spree 6.0, so the CLI no longer references it:
-
-- `spree dev` and `spree eject` no longer compile the admin Tailwind stylesheet or start its watcher — the `spree:admin:tailwindcss:build` and `spree:admin:tailwindcss:watch` rake tasks went with the gem.
-- `spree dev`, `spree init` and `spree open` no longer point at `http://localhost:<port>/admin`, which now 404s. With a dashboard app present they open its Vite dev server; without one they open the store, and the summary card says to run `spree add dashboard`.
-
-Admin UI now ships as the React dashboard. Run it with `spree dev` (co-runs the dashboard dev server) or add it with `spree add dashboard`. Projects ejected before this release can delete the orphaned `backend/app/assets/builds/spree/admin/` directory.
diff --git a/.changeset/cli-first-run-setup.md b/.changeset/cli-first-run-setup.md
deleted file mode 100644
index a8c483199f..0000000000
--- a/.changeset/cli-first-run-setup.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-'@spree/cli': major
----
-
-`spree init` asks who the admin is instead of seeding a known account.
-
-Spree 6.0 stops seeding `[email protected]` / `spree123`, so the CLI no longer prints or assumes those credentials:
-
-- `spree init` prompts for an admin email and password, or takes `--admin-email` / `--admin-password`. Both are validated before Docker starts, rather than failing minutes into the run, and passing only one is rejected.
-- A non-interactive run without those flags (CI, a piped invocation) creates **no admin**. The seed prints a one-time setup link instead, and the summary card shows it — open it to create the first account in the dashboard. `--open` goes straight there.
-- Sample data is skipped on that path, since its import needs an admin to own it. Load it after setup with `spree sample-data`.
-- `spree dev` names the admin email `spree init` seeded; when no account was seeded it points at the setup link rather than guessing an address.
-- The exported `DEFAULT_ADMIN_EMAIL` and `DEFAULT_ADMIN_PASSWORD` constants are gone.
-
-Scripted installs that relied on the old credentials must now pass `--admin-email` and `--admin-password`.
diff --git a/.changeset/collections-sdk.md b/.changeset/collections-sdk.md
deleted file mode 100644
index 0c6eb424c3..0000000000
--- a/.changeset/collections-sdk.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-'@spree/admin-sdk': patch
-'@spree/sdk': minor
----
-
-Collections reach both SDKs.
-
-`@spree/sdk` (storefront):
-
-- `collections.list()` / `collections.get(idOrPermalink)` — the flat, merchandising-driven groupings ("Summer Sale", "New Arrivals"), whether membership is curated by hand or maintained from rules.
-- `collections.products.list(idOrPermalink, params)` — a collection's product listing page. Takes the same filters and sorts as `products.list`, and when `sort` is omitted the collection's own `sort_order` applies, so a shopper sees the ordering the merchant chose (including their manual arrangement).
-- `in_collection` on `ProductListParams`, for composing a collection filter into a wider product query.
-
-`@spree/admin-sdk` (back office):
-
-- `collections` CRUD, with reordering as a plain 1-based `position` on update rather than a separate action — collections are a flat list. Nested `collections.products` covers membership, ordering and `reposition`, plus custom fields and translations.
-- `collectionRules.types()` enumerates the registered rule kinds, so a rule a plugin registers shows up without an SDK release.
-- `products.bulkAddToCollections` / `bulkRemoveFromCollections`, and `collection_ids` on product create/update.
-- `rules` on a collection is expand-gated (`?expand=rules`), matching `custom_fields` — a listing no longer ships every collection's full rule set.
-- `hide_from_nav` is gone from the category params. Nothing read it.
diff --git a/.changeset/create-spree-app-first-run-setup.md b/.changeset/create-spree-app-first-run-setup.md
deleted file mode 100644
index 189846df05..0000000000
--- a/.changeset/create-spree-app-first-run-setup.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-'create-spree-app': major
----
-
-Scaffolded apps no longer ship with a known admin password.
-
-Spree 6.0 replaces the seeded `[email protected]` / `spree123` account with a first-run setup screen, so a new project no longer starts life with credentials that are public knowledge:
-
-- The scaffold summary and the generated README point at first-run setup instead of printing an email and password.
-- The first run opens the setup link, where you create the admin account and name the store.
-- The exported `DEFAULT_ADMIN_EMAIL` and `DEFAULT_ADMIN_PASSWORD` constants are gone.
diff --git a/.changeset/dashboard-companies-and-tax-rates.md b/.changeset/dashboard-companies-and-tax-rates.md
deleted file mode 100644
index 82dc0e1056..0000000000
--- a/.changeset/dashboard-companies-and-tax-rates.md
+++ /dev/null
@@ -1,18 +0,0 @@
----
-"@spree/dashboard": minor
-"@spree/dashboard-core": minor
-"@spree/dashboard-ui": minor
-"@spree/admin-sdk": minor
----
-
-Add dashboard pages for business customers and tax configuration.
-
-Companies get a list and a detail page with their branches, tax registration
-and exemption certificates; a branch has its own page listing the buyers
-authorised to purchase for it. Customers gain the same tax registration panel
-on their profile. Tax rates get a settings page, and a market can now name the
-tax engine that prices it — showing what that engine cannot handle, so a
-merchant learns about a gap while configuring rather than from a tax bill.
-
-The admin SDK gains the customer tax-identifier endpoints and `tax_provider`
-on market params.
diff --git a/.changeset/dashboard-date-range-preset.md b/.changeset/dashboard-date-range-preset.md
deleted file mode 100644
index e71f18f643..0000000000
--- a/.changeset/dashboard-date-range-preset.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-'@spree/dashboard': patch
-'@spree/dashboard-ui': patch
----
-
-Fix the dashboard date range picker remembering "Last 30 days" after another preset is chosen.
-
-The trigger label lived in local state that reset whenever analytics refetch replaced the page. It now follows the selected dates, so Last 90 days stays selected after the figures update.
diff --git a/.changeset/dashboard-edit-profile-dialog.md b/.changeset/dashboard-edit-profile-dialog.md
deleted file mode 100644
index 37eec4421e..0000000000
--- a/.changeset/dashboard-edit-profile-dialog.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@spree/dashboard": patch
-"@spree/dashboard-core": patch
----
-
-Edit the admin profile in a dialog opened from the user menu instead of a settings page. The `/settings/profile` route is removed; `TopBar` takes an `onEditProfile` handler and hides the menu item when none is supplied.
diff --git a/.changeset/dashboard-locale-reload-loop.md b/.changeset/dashboard-locale-reload-loop.md
deleted file mode 100644
index 56ca327539..0000000000
--- a/.changeset/dashboard-locale-reload-loop.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-'@spree/dashboard-core': patch
----
-
-Fix an endless reload when a store sets a non-English admin language.
-
-i18next was initialized with the stored language but only the English bundle, so it resolved the language to the fallback and reported English no matter what was stored. The store-default reconciler compares those two values to decide whether the page needs reloading, saw a permanent mismatch, and reloaded on every boot — each reload rotating a refresh token until the API's rate limit stopped it.
-
-Every bundle is now registered when i18next starts, so the stored language resolves to itself and the reconciler reloads only when the language genuinely changes.
diff --git a/.changeset/dashboard-preferences-theme-language.md b/.changeset/dashboard-preferences-theme-language.md
deleted file mode 100644
index b540dd5e45..0000000000
--- a/.changeset/dashboard-preferences-theme-language.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@spree/dashboard-core": patch
-"@spree/dashboard-ui": patch
----
-
-Redesign the user dropdown's theme and language controls into a compact "Preferences" section: theme is now a segmented control (System / Light / Dark) and language is a select-style pill.
diff --git a/.changeset/dashboard-status-badge-colors.md b/.changeset/dashboard-status-badge-colors.md
deleted file mode 100644
index 3f8f4a5e88..0000000000
--- a/.changeset/dashboard-status-badge-colors.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@spree/dashboard-ui": patch
-"@spree/dashboard": patch
----
-
-Align status badge colours with the Geist colour system: each of the success, warning, destructive and info variants now pairs a tint with a matching reading colour from the same hue, in both light and dark themes, and every variant meets WCAG AA against its own fill. Fixes a `warning` badge that changed colour entirely on hover, and an outline badge whose border never rendered.
diff --git a/.changeset/dashboard-ui-declare-css-deps.md b/.changeset/dashboard-ui-declare-css-deps.md
deleted file mode 100644
index 52898f098d..0000000000
--- a/.changeset/dashboard-ui-declare-css-deps.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@spree/dashboard-ui": patch
----
-
-Declare the dependencies behind `styles.css` imports: `tailwindcss` as a peer (plus dev) dependency and `shadcn` as a regular dependency. Previously both were undeclared for consumers, so `@import "tailwindcss"` and `@import "shadcn/tailwind.css"` only resolved when pnpm's on-disk layout happened to allow it, failing with `Cannot apply unknown utility class` otherwise.
diff --git a/.changeset/document-number-customization.md b/.changeset/document-number-customization.md
deleted file mode 100644
index f5db2c6aa0..0000000000
--- a/.changeset/document-number-customization.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@spree/admin-sdk': minor
-'@spree/dashboard': minor
----
-
-Order numbers are now configurable from the dashboard.
-
-**Settings → Store → Order numbers** controls how document numbers are shaped: the numbering format (sequential or random), the order number prefix and suffix, and the value the sequence starts at. A live preview shows what the next number will look like.
-
-Sequential numbering is the new default — orders count up from 1001 (`R1001`, `R1002`) instead of carrying nine random digits. Merchants who would rather not disclose their order volume can switch the format back to random. Either way, changes apply to future orders only; numbers already issued never change.
-
-`StoreUpdateParams` and the `Store` type gain `preferred_document_number_format`, `preferred_order_number_prefix`, `preferred_order_number_suffix` and `preferred_order_number_sequence_start`.
diff --git a/.changeset/hide-empty-pagination.md b/.changeset/hide-empty-pagination.md
deleted file mode 100644
index 6ea900abd9..0000000000
--- a/.changeset/hide-empty-pagination.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@spree/dashboard-ui": patch
----
-
-Hide the pagination footer when a list has no rows, so empty tables no longer show "0–0 of 0" or a rows-per-page control.
diff --git a/.changeset/media-library.md b/.changeset/media-library.md
deleted file mode 100644
index 95e7fb6f62..0000000000
--- a/.changeset/media-library.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@spree/admin-sdk': minor
-'@spree/dashboard': minor
----
-
-Media library. Every image and video in a store now lives in one place under Products → Media: browse it, search by file name, filter by type or by whether a file is in use, and upload files before deciding where they go. Picking a file from the library reuses it rather than copying it, so the same photo on three products is one file in storage.
-
-The library is reachable from everywhere media is set. The product gallery gains "Add from library", category, collection and seller image fields gain "Choose from library", and the rich text editor can embed an image in a description for the first time. Category and collection images now appear in the library too, so a file uploaded there can be reused anywhere else.
-
-Every file shows where it is used before it is deleted, and deleting one that is still in use removes it from those places once the merchant confirms.
-
-New in `@spree/admin-sdk`: the `media` resource (`list`, `get`, `create`, `update`, `delete`, `usage`), `source_media_id` on product media creation for reuse, and `signed_id`, `embed_url`, `filename`, `content_type`, `byte_size` and `attached` on the admin media payload.
diff --git a/.changeset/price-list-csv-and-volume-pricing.md b/.changeset/price-list-csv-and-volume-pricing.md
deleted file mode 100644
index 7ab2c13a80..0000000000
--- a/.changeset/price-list-csv-and-volume-pricing.md
+++ /dev/null
@@ -1,21 +0,0 @@
----
-"@spree/dashboard": minor
-"@spree/dashboard-core": minor
-"@spree/dashboard-ui": minor
-"@spree/admin-sdk": minor
----
-
-Volume pricing: quantity breaks, percentage tiers and a price-list CSV.
-
-A price list can now carry a ladder per variant — a unit price from each
-quantity up — edited as tier rows in the price spreadsheet, and a catalog's
-percentage adjustment can step by quantity too. The catalog's price column
-shows how many tiers a variant carries, with the ladder on hover and a note
-that fixed tiers set the price regardless of the percentage.
-
-A price list's prices can be exported and imported as CSV, one rung per row
-keyed by SKU, from the list's own page and from the catalog that owns it.
-The import merges: rows in the file are written, a blank price removes that
-rung, and rungs the file does not mention are left alone. The admin SDK's
-price, price list and import types carry the new fields, and the import
-create call accepts the price list to merge into.
diff --git a/.changeset/product-media-video.md b/.changeset/product-media-video.md
deleted file mode 100644
index 50555ed7ae..0000000000
--- a/.changeset/product-media-video.md
+++ /dev/null
@@ -1,18 +0,0 @@
----
-'@spree/admin-sdk': minor
-'@spree/dashboard': minor
----
-
-Product galleries can hold video.
-
-A media item now says what it is through `media_type`. `video` is a file you upload and serve yourself; `external_video` is a YouTube or Vimeo link. Both sit in the same gallery as images and reorder alongside them.
-
-Spree reads the link when it is saved and rejects anything it cannot embed, so the media object comes back carrying `video_provider`, `video_embed_url`, `video_url` and `poster_url` — a storefront embeds a video without parsing links itself. A video's sized URLs resolve to its poster, so a gallery written for images still renders the right still.
-
-`MediaCreateParams` and `MediaUpdateParams` accept `media_type`, `external_video_url`, `poster_signed_id` and the focal point. The `type` parameter, which named an internal Ruby class, is gone — `media_type` replaces it.
-
-A video carries a **poster** — the still shown before it plays. Upload one with `poster_signed_id`, or leave it off and a YouTube link falls back to the provider's own image. Spree does not extract a frame from an uploaded file, so hosted video and Vimeo links want a poster.
-
-In the dashboard, video files upload through the same drop zone as images, an "Add video link" button takes a YouTube or Vimeo URL, and the media editor plays the video back and takes a poster the merchant uploads. The editor also gains a focal-point picker: click the spot on an image that must stay in frame when a storefront crops it.
-
-Choosing which variants a media item represents happens in one place — the media editor on the product. The unmounted variant-side gallery picker has been removed; it was a second way to edit the same thing.
diff --git a/.changeset/rich-text-editor-enter-and-toolbar.md b/.changeset/rich-text-editor-enter-and-toolbar.md
deleted file mode 100644
index 4d31e0f585..0000000000
--- a/.changeset/rich-text-editor-enter-and-toolbar.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@spree/dashboard-ui": patch
-"@spree/dashboard": patch
-"@spree/dashboard-core": patch
----
-
-Keep list and quote toolbar buttons working after the TipTap 3.31 pin. Two copies of prosemirror-model made wrap throw; pinning one version (and deduping it in the Vite plugin) restores the stock TipTap commands. Enter still persists as its own paragraph.
diff --git a/.changeset/rich-text-editor-toolbar-and-shortcuts.md b/.changeset/rich-text-editor-toolbar-and-shortcuts.md
deleted file mode 100644
index 24e052adce..0000000000
--- a/.changeset/rich-text-editor-toolbar-and-shortcuts.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@spree/dashboard-ui": patch
-"@spree/dashboard": patch
----
-
-Stop the admin sidebar's Cmd/Ctrl+B shortcut from firing while typing, and restore list, quote and link styling plus live toolbar states in the rich-text editor.
diff --git a/.changeset/rich-text-html-write-contract.md b/.changeset/rich-text-html-write-contract.md
deleted file mode 100644
index 1602583e99..0000000000
--- a/.changeset/rich-text-html-write-contract.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-'@spree/admin-sdk': patch
-'@spree/cli': patch
----
-
-Rich-text fields read as plain text plus HTML.
-
-Spree 6.0 stores rich text as sanitized HTML in plain text columns instead of Action Text. The write params are unchanged — `description` and `internal_note` still take the value, and that value is HTML.
-
-What changed is the read side:
-
-- `internal_note_html` is now readable on `Order`, and `internal_note` (plain text) on `Customer`. Previously the order serializer returned only plain text and the customer serializer only HTML; both now return the pair.
-- `description` returns tag-stripped plain text, with the markup under `description_html`. Hydrate an editor from `description_html`, not `description`.
-
-The field stores HTML, so send markup — a plain-text value with newlines in it renders as one run-on line.
diff --git a/.changeset/seller-settings-overview.md b/.changeset/seller-settings-overview.md
deleted file mode 100644
index aa9d47ac0b..0000000000
--- a/.changeset/seller-settings-overview.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@spree/dashboard-core": patch
-"@spree/seller-dashboard": patch
----
-
-Added a settings overview page to the seller panel, matching the operator dashboard's card grid of reachable settings areas.
diff --git a/.changeset/six-zero-admin-sdk.md b/.changeset/six-zero-admin-sdk.md
deleted file mode 100644
index 737fea5609..0000000000
--- a/.changeset/six-zero-admin-sdk.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@spree/admin-sdk': patch
-'@spree/cli': patch
----
-
-Admin API additions from the 6.0 core rewrite:
-
-- `deliveryMethods.rules` CRUD and `deliveryMethods.ruleTypes()` — delivery method eligibility rules (item total, weight).
-- `orders.discountCodes.create/delete` — apply and remove coupon codes on draft orders with the storefront's pending semantics.
-- `expand=cart` on orders returns the originating cart (new admin `Cart` type); the embedded promotion summaries moved from the `discounts` key to `applied_promotions` (the `discounts` name stays reserved for the typed money rows at `/orders/:id/discounts`).
-- Delivery methods accept `stock_location_ids` for pickup; delivery zones, delivery methods and stock locations are store-scoped.
-- `Order` gains `cart_id` and `coupon_code`; `DeliveryZone.members` requires `expand=members`.
diff --git a/.changeset/six-zero-dashboard.md b/.changeset/six-zero-dashboard.md
deleted file mode 100644
index 107e24959a..0000000000
--- a/.changeset/six-zero-dashboard.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-'@spree/dashboard': patch
----
-
-Dashboard features from the 6.0 core rewrite:
-
-- Delivery method editor: Conditions section (eligibility rules), pickup stock-location picker, calculator preferences through the shared preferences form.
-- Order page: discount code card (apply a typed code or pick a coupon promotion; pending codes show when they'll take effect) and a live computed-amount preview for percent manual discounts.
-- Webhook endpoint event catalog lists `order.placed`; delivery zones request members via `expand`.
diff --git a/.changeset/six-zero-store-api-line.md b/.changeset/six-zero-store-api-line.md
deleted file mode 100644
index 36713016c0..0000000000
--- a/.changeset/six-zero-store-api-line.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-'@spree/sdk': major
----
-
-Spree 6.0 Store API line. Breaking changes for storefront integrations:
-
-- Completed carts are no longer served by the cart endpoints — fetching one returns 404, the signal to drop stale cart state. The checkout outcome stays reachable through `orders.get(cartId)` authorized by the cart token (the order inherits it).
-- `DeliveryZone.members` is only embedded when requested with `expand=members` (the type is now optional).
-- The placement webhook event is `order.placed`; `order.completed` is still dual-emitted through 6.0 with `deprecated_alias_of` metadata and drops in 6.1.
-
-Additions: `coupon_code` on Cart and Order (with pending-code semantics — a real but not-yet-eligible code is kept and applies once the cart qualifies), `cart_id` on Order for matching cart activity to its conversion, and `cart.created` / `cart.updated` / `cart.deleted` webhook events for abandonment tooling.
diff --git a/.changeset/steady-http-error-recovery.md b/.changeset/steady-http-error-recovery.md
deleted file mode 100644
index 3cab1ab725..0000000000
--- a/.changeset/steady-http-error-recovery.md
+++ /dev/null
@@ -1,7 +0,0 @@
----
-"@spree/sdk": patch
-"@spree/admin-sdk": patch
-"@spree/seller-sdk": patch
----
-
-Preserve HTTP error statuses when a server returns an empty, non-JSON, or malformed error body. Avoid treating these responses as network failures, and allow admin and seller session recovery to handle unauthorized responses.
diff --git a/.changeset/stock-item-renamed-to-stock-level.md b/.changeset/stock-item-renamed-to-stock-level.md
deleted file mode 100644
index da70f3de24..0000000000
--- a/.changeset/stock-item-renamed-to-stock-level.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-'@spree/admin-sdk': major
-'@spree/dashboard': major
-'@spree/dashboard-core': major
----
-
-Renamed stock items to stock levels.
-
-Spree 6.0 renames `Spree::StockItem` to `Spree::StockLevel`, and the admin API and SDK follow. There is no compatibility shim on the client side, so update your code before upgrading:
-
-- `client.stockItems` is now `client.stockLevels`, and it calls `/stock_levels` instead of `/stock_items`.
-- The `StockItem` type is now `StockLevel`, and `StockItemUpdateParams` is now `StockLevelUpdateParams`.
-- `StockLevelUpdateParams` also gains `reason`, which labels a count correction in the stock history.
-- `client.stockMovements` is new, and reads the typed stock history behind those levels.
-- A variant's `stock_items` array is now `stock_levels`, on both reads and writes.
-- `Subject.StockItem` is now `Subject.StockLevel` in `@spree/dashboard-core`. The old name stays as a deprecated alias for one release.
-- Prefixed ids change from `si_…` to `sl_…`. Ids you stored earlier no longer resolve.
-
-Webhook endpoints keep working: Spree publishes both `stock_level.*` and the older `stock_item.*` events for one release, so existing subscriptions keep firing. The dashboard's event picker now offers the `stock_level` names, and shows any `stock_item` subscription you already have under its Custom section. Move your subscriptions over before Spree 6.1, when the old names stop being published.
diff --git a/.changeset/store-credit-categories-removed.md b/.changeset/store-credit-categories-removed.md
deleted file mode 100644
index 0af4085a71..0000000000
--- a/.changeset/store-credit-categories-removed.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-"@spree/admin-sdk": major
-"@spree/dashboard": patch
----
-
-Store credits no longer carry a category. `client.storeCreditCategories` and the `StoreCreditCategory` type are removed, `category_id` is no longer accepted or returned on customer store credits, and the dashboard's issue/edit store credit dialogs drop the category picker — the memo is the place to record why a credit was issued.
diff --git a/.changeset/store-tax-address-preference.md b/.changeset/store-tax-address-preference.md
deleted file mode 100644
index d339037e04..0000000000
--- a/.changeset/store-tax-address-preference.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-'@spree/admin-sdk': minor
-'@spree/dashboard': minor
----
-
-Which address a sale's tax is computed from is now a store setting rather than a global one. `preferred_tax_using_ship_address` can be read and written through the Admin API, and merchants can change it under Settings → Store in the Payments card. The default is unchanged: tax follows the shipping address.
diff --git a/.changeset/table-toolbar-tenant-scoped.md b/.changeset/table-toolbar-tenant-scoped.md
deleted file mode 100644
index 9f1e90f4ff..0000000000
--- a/.changeset/table-toolbar-tenant-scoped.md
+++ /dev/null
@@ -1,5 +0,0 @@
----
-"@spree/dashboard-core": patch
----
-
-Fix the filter panel crashing in the seller panel. `TableToolbar`, `ResourceCombobox` and `MediaPickerSheet` required a `StoreProvider` to scope their query keys, so opening a filter panel in a panel that has no store — the seller panel, whose tenant is a seller — threw "useStore must be used within a StoreProvider". They now scope by tenant, which is the store in the operator's dashboard and the seller in the seller panel, so cached results can no longer be shared between two sellers of the same store either.
diff --git a/.changeset/tax-line-exemption-reason.md b/.changeset/tax-line-exemption-reason.md
deleted file mode 100644
index 2d211346ed..0000000000
--- a/.changeset/tax-line-exemption-reason.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-"@spree/dashboard": patch
----
-
-Show why an order tax line is zero.
-
-The Taxes card now names the treatment (buyer exempt, zero-rated, and the
-other recorded reasons) and, when the buyer is exempt, the certificate that
-made it so. A completed order with no matching rate says so instead of
-looking like a draft that has not been taxed yet, and the Summary card keeps
-its tax row at zero so an exempt sale is still visible there.
diff --git a/.changeset/translations-dialog-dirty-and-cache.md b/.changeset/translations-dialog-dirty-and-cache.md
deleted file mode 100644
index d92f32493e..0000000000
--- a/.changeset/translations-dialog-dirty-and-cache.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-'@spree/dashboard': patch
-'@spree/dashboard-ui': patch
-'@spree/dashboard-core': patch
----
-
-Stop the translations editor marking itself dirty on open, and refresh the translations page after a save or a catalog edit.
-
-The rich-text cell was treating TipTap's mount-time paragraph wrap as an unsaved change against descriptions stored as plain text. Translation queries now share one cache prefix so saving a translation, editing the source record, or importing a translations CSV invalidates the coverage grid instead of leaving it stale.
diff --git a/.github/workflows/packages.yml b/.github/workflows/packages.yml
index 6aae39b9ce..97ff19ae8c 100644
--- a/.github/workflows/packages.yml
+++ b/.github/workflows/packages.yml
@@ -262,9 +262,26 @@ jobs:
echo "published=false" >> $GITHUB_OUTPUT
fi
+ # @spree/sdk is the one package with a stable `latest` that real
+ # storefronts already depend on (`^1.2.1` = the 5.x Store API). A 6.0
+ # prerelease published without a tag would land on `latest` and be
+ # resolved by every one of them on their next install, so the tag is
+ # load-bearing here rather than a nicety.
+ - name: Determine npm tag
+ id: tag
+ run: |
+ PACKAGE_VERSION=$(node -p "require('./package.json').version")
+ if echo "$PACKAGE_VERSION" | grep -qE '^0\.'; then
+ echo "tag=next" >> $GITHUB_OUTPUT
+ elif echo "$PACKAGE_VERSION" | grep -qE '[-]'; then
+ echo "tag=beta" >> $GITHUB_OUTPUT
+ else
+ echo "tag=latest" >> $GITHUB_OUTPUT
+ fi
+
- name: Build and Publish
if: steps.check.outputs.published == 'false'
- run: pnpm turbo build --filter=@spree/sdk && npm publish --provenance --access public
+ run: pnpm turbo build --filter=@spree/sdk && npm publish --provenance --access public --tag ${{ steps.tag.outputs.tag }}
release-admin-sdk:
name: "Admin SDK - Release"
@@ -333,12 +350,12 @@ jobs:
release-cli:
name: "CLI - Release"
- # Gated on release-dashboard: the CLI tarball embeds the dashboard-starter
- # template with floating ranges floored at the @spree/dashboard{,-ui,-core}
+ # Gated on release-dashboard and release-seller: the CLI tarball embeds the
+ # dashboard-starter AND seller-dashboard-starter templates with floating
+ # ranges floored at the @spree/dashboard{,-ui,-core} and @spree/seller-*
# versions being released — publishing it before those versions exist on
- # npm would ship a scaffold whose install fails until the dashboard
- # release lands.
- needs: [check, release-dashboard]
+ # npm would ship a scaffold whose install fails until they land.
+ needs: [check, release-dashboard, release-seller]
if: github.ref == 'refs/heads/main' && github.event_name == 'push'
runs-on: ubuntu-latest
permissions:
@@ -475,9 +492,66 @@ jobs:
cd ../..
done
+ # The seller packages mirror the admin pair above: @spree/seller-sdk is the
+ # Seller API client, @spree/seller-dashboard the panel built on it. They
+ # publish on the same pre-1.0 `next` scheme, in dependency order, and must
+ # land before release-cli — the CLI tarball embeds the seller-dashboard
+ # starter with ranges floored at these versions.
+ release-seller:
+ name: "Seller packages - Release"
+ needs: check
+ if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+ runs-on: ubuntu-latest
+ permissions:
+ contents: write
+ pull-requests: write
+ id-token: write
+ steps:
+ - uses: actions/checkout@v7
+
+ - uses: pnpm/action-setup@v6
+
+ - uses: actions/setup-node@v7
+ with:
+ node-version: 22
+ cache: pnpm
+ registry-url: https://registry.npmjs.org
+
+ - run: pnpm install --frozen-lockfile
+
+ # Trusted Publishing requires npm >= 11.5.1, but the bundled npm
+ # on Node 22 is 10.9.7. A plain `npm install -g npm@latest` swaps
+ # npm's own files in place and the in-flight install can't find
+ # its own dependencies (MODULE_NOT_FOUND: promise-retry). Install
+ # to a separate prefix and prepend to PATH instead.
+ - name: Upgrade npm for Trusted Publishing support
+ run: |
+ npm install -g npm@latest --prefix="$HOME/.npm-global"
+ echo "$HOME/.npm-global/bin" >> "$GITHUB_PATH"
+
+ - name: Publish unpublished versions (dependency order)
+ run: |
+ set -euo pipefail
+ for pkg in seller-sdk seller-dashboard; do
+ cd "packages/$pkg"
+ NAME=$(node -p "require('./package.json').name")
+ VERSION=$(node -p "require('./package.json').version")
+ if npm view "$NAME@$VERSION" version 2>/dev/null; then
+ echo "$NAME@$VERSION already published — skipping."
+ else
+ if echo "$VERSION" | grep -qE '^0\.'; then TAG=next
+ elif echo "$VERSION" | grep -qE '[-]'; then TAG=beta
+ else TAG=latest
+ fi
+ echo "Publishing $NAME@$VERSION with tag $TAG..."
+ pnpm publish --provenance --access public --tag "$TAG" --no-git-checks
+ fi
+ cd ../..
+ done
+
# The dashboard-starter template is NOT distributed via a template repo:
# `@spree/cli` and `create-spree-app` embed it at build time
- # (scripts/sync-dashboard-starter.mjs renders packages/dashboard-starter
+ # (scripts/sync-starter.mjs renders packages/dashboard-starter
# with floating ranges floored at the released versions into their
# templates/ dir), so scaffolds install the newest dashboard release even
# from an older CLI, and never anything older than the template was built
@@ -535,6 +609,18 @@ jobs:
echo "published=false" >> $GITHUB_OUTPUT
fi
+ # Stable today, but a prerelease must never become the default for
+ # `npx create-spree-app` — the entry point every new project runs.
+ - name: Determine npm tag
+ id: tag
+ run: |
+ PACKAGE_VERSION=$(node -p "require('./package.json').version")
+ if echo "$PACKAGE_VERSION" | grep -qE '[-]'; then
+ echo "tag=beta" >> $GITHUB_OUTPUT
+ else
+ echo "tag=latest" >> $GITHUB_OUTPUT
+ fi
+
- name: Build and Publish
if: steps.check.outputs.published == 'false'
- run: pnpm build && npm publish --provenance --access public
+ run: pnpm build && npm publish --provenance --access public --tag ${{ steps.tag.outputs.tag }}
diff --git a/.gitignore b/.gitignore
index 78d85cc18b..1c32a8a776 100644
--- a/.gitignore
+++ b/.gitignore
@@ -70,9 +70,9 @@ packages/*/package-lock.json
.turbo
.tanstack
packages/*/dist
-# Build-time-generated dashboard-starter template embed (see
-# scripts/sync-dashboard-starter.mjs)
+# Build-time-generated starter template embeds (see scripts/sync-starter.mjs)
packages/cli/templates/dashboard-starter
+packages/cli/templates/seller-dashboard-starter
.claude/worktrees
*.tsbuildinfo
.claude/scheduled_tasks.lock
diff --git a/docs/plans/5.6-project-layout-and-dashboard.md b/docs/plans/5.6-project-layout-and-dashboard.md
index f75a266a99..5c81ae656c 100644
--- a/docs/plans/5.6-project-layout-and-dashboard.md
+++ b/docs/plans/5.6-project-layout-and-dashboard.md
@@ -128,7 +128,7 @@ export function detectProject(cwd: string = process.cwd()): ProjectContext {
### Dashboard starter (`packages/dashboard-starter`, embedded at build time)
-Canonical source in the monorepo at `packages/dashboard-starter` (doubles as the plugin pipeline's CI consumer test). Distribution is **Vendure-style npm embedding, not a template repo**: at build time, `@spree/cli` runs `scripts/sync-dashboard-starter.mjs` to render a standalone copy into its `templates/dashboard-starter/` (gitignored, shipped in the tarball via the dist copy) — rewriting `workspace:^` deps to the published versions, stripping monorepo-only devDependencies, inlining the workspace `biome.json`, and shipping `.gitignore` as `gitignore.template` (npm never packs `.gitignore`; the scaffolder renames it back). `prepublishOnly` rebuilds on publish, so the template's version pins are in lockstep with every CLI release by construction — no repo to drift, no sync token, no 404 window. The CLI is the **single template source**: `create-spree-app` doesn't embed a copy — its dashboard phase delegates to the project-local `npx spree add dashboard` (the generated project already depends on `@spree/cli`, installed with root deps before the phase runs, and the command reads the API port from the project `.env`). Decision informed by a Medusa/Vendure comparison: Vendure embeds templates in `@vendure/create` and gets alignment for free; Medusa's separate starter repo needs a scheduled bot to stay current. A public `spree/dashboard-starter` template repo (for browsability / "Use this template") can be added at 6.0 GA — the sync script takes any target directory, so it would reuse this machinery verbatim. The scaffolded app:
+Canonical source in the monorepo at `packages/dashboard-starter` (doubles as the plugin pipeline's CI consumer test). Distribution is **Vendure-style npm embedding, not a template repo**: at build time, `@spree/cli` runs `scripts/sync-starter.mjs` to render a standalone copy into its `templates/dashboard-starter/` (gitignored, shipped in the tarball via the dist copy) — rewriting `workspace:^` deps to the published versions, stripping monorepo-only devDependencies, inlining the workspace `biome.json`, and shipping `.gitignore` as `gitignore.template` (npm never packs `.gitignore`; the scaffolder renames it back). `prepublishOnly` rebuilds on publish, so the template's version pins are in lockstep with every CLI release by construction — no repo to drift, no sync token, no 404 window. The CLI is the **single template source**: `create-spree-app` doesn't embed a copy — its dashboard phase delegates to the project-local `npx spree add dashboard` (the generated project already depends on `@spree/cli`, installed with root deps before the phase runs, and the command reads the API port from the project `.env`). Decision informed by a Medusa/Vendure comparison: Vendure embeds templates in `@vendure/create` and gets alignment for free; Medusa's separate starter repo needs a scheduled bot to stay current. A public `spree/dashboard-starter` template repo (for browsability / "Use this template") can be added at 6.0 GA — the sync script takes any target directory, so it would reuse this machinery verbatim. The scaffolded app:
```
dashboard-starter/
@@ -486,7 +486,7 @@ All phases ship in **5.6**. The dashboard ships as Developer Preview alongside `
1. Scaffold the thin host in the monorepo per the shape above, with `workspace:^` deps. It compiles `<Dashboard />` from source and (dev-only) activates `@spree/dashboard-plugin-example` through auto-discovery — the standing consumer test for the plugin pipeline.
2. Write minimal Vite config that proxies to `localhost:3000` in dev. The proxy path is irrelevant to the Rails directory name — it's an HTTP URL.
3. Write README covering: dev workflow, installing plugins, `plugins.ts` customizations, deploying.
-4. Embed the rendered template in the `@spree/cli` tarball at build time *(implemented — `scripts/sync-dashboard-starter.mjs` runs in the CLI's build script; `prepublishOnly` guarantees fresh pins at publish; `.gitignore` ships as `gitignore.template` because npm never packs `.gitignore` files, and the scaffolder renames it back)*. `create-spree-app` carries no copy — its dashboard phase runs the project-local `npx spree add dashboard`, keeping the CLI the single template source. This superseded the earlier template-repo + CI-sync-job design after comparing Medusa (separate starter repo kept current by a scheduled bot) and Vendure (templates embedded in `@vendure/create`, lockstep for free). Remaining manual step for the preview: the first npm publish of `@spree/dashboard{,-ui,-core}` (Trusted Publishing can only be configured once a package exists).
+4. Embed the rendered template in the `@spree/cli` tarball at build time *(implemented — `scripts/sync-starter.mjs` runs in the CLI's build script; `prepublishOnly` guarantees fresh pins at publish; `.gitignore` ships as `gitignore.template` because npm never packs `.gitignore` files, and the scaffolder renames it back)*. `create-spree-app` carries no copy — its dashboard phase runs the project-local `npx spree add dashboard`, keeping the CLI the single template source. This superseded the earlier template-repo + CI-sync-job design after comparing Medusa (separate starter repo kept current by a scheduled bot) and Vendure (templates embedded in `@vendure/create`, lockstep for free). Remaining manual step for the preview: the first npm publish of `@spree/dashboard{,-ui,-core}` (Trusted Publishing can only be configured once a package exists).
5. *(Deferred to 6.0 GA, optional)* Public `spree/dashboard-starter` template repo for browsability — reuse the same script with the repo as a second target, plus CI on that repo.
### Phase 4: Rename `backend/` → `api/` in create-spree-app (new projects only)
diff --git a/docs/plans/6.0-beta-release.md b/docs/plans/6.0-beta-release.md
index d056532514..ad25fa98f0 100644
--- a/docs/plans/6.0-beta-release.md
+++ b/docs/plans/6.0-beta-release.md
@@ -38,12 +38,40 @@ explicit range, and `latest` keeps meaning 5.x until 6.0 is final.**
would push the beta straight to `latest` and break every 5.x storefront.
This is the single highest-risk item in the release.
-3. **Admin-side packages keep their existing 0.x / `next` scheme.**
- `@spree/admin-sdk` (0.8.1) and the dashboard trio (0.13.1) are already
- published under `next` and have no `latest` 6.0 consumers to protect. Bump
- them normally through Changesets — no beta tag, no major. `latest` on those
- packages still points at the ancient 0.1.0/0.2.1, which is the intended
- Developer Preview posture. Revisit at 6.0 GA, not now.
+3. **Every Developer-Preview package goes to `1.0.0-beta.1`: Spree 6 = 1.0.0
+ for all of them.** `@spree/admin-sdk` (0.8.1), the dashboard trio (0.13.1)
+ and the two seller packages (0.1.0) leave 0.x together and are promoted to
+ stable `1.0.0` at 6.0 GA. One version line across the npm surface, matching
+ the gems' own 6.0 line, instead of five unrelated 0.x counters nobody can
+ map to a Spree release.
+
+ The form is `1.0.0-beta.1`, **not** `1.0.0.pre` — npm requires a hyphen and
+ rejects `1.0.0.pre` outright (that spelling is RubyGems'). They publish
+ under the existing `next` tag, which the release jobs already select for any
+ version containing `-`.
+
+ This changes what the embedded starter templates pin. `publishedRange()` in
+ `scripts/sync-starter.mjs` emits `>=x.y.z <2.0.0` only for `0.x`; at
+ `1.0.0-beta.1` it emits `^1.0.0-beta.1`, which accepts the beta now and
+ floats to stable `1.0.0` when it lands — the intended behaviour, no change
+ needed. Verified with semver.
+
+ `@spree/sdk` is the exception and stays on its own line (Decision 2): it has
+ a published 1.x that means the 5.x Store API, so it goes to `2.0.0-beta.1`.
+
+ Use `beta.1`, never `beta1`: semver compares dot-separated prerelease
+ identifiers numerically but bare strings alphabetically, so `1.0.0-beta9`
+ sorts ABOVE `1.0.0-beta10` and a release would ship backwards. This is the
+ one place the npm and RubyGems spellings must differ — `6.0.0.beta1` is
+ correct for the gems, where the trailing digits parse as their own numeric
+ segment. `@spree/cli` already shipped `2.0.0-beta` → `-beta.7`, so the
+ dotted form is this repo's existing precedent, not a new convention.
+
+ **Accepted break:** the dashboard trio currently publishes to `next` at
+ `0.13.1`. At `1.0.0-beta.1` the release jobs route it to `beta` instead
+ (any version containing `-`), so anyone installing `@spree/dashboard@next`
+ stops receiving updates and must move to `@beta`. Call this out in the
+ release notes — the Developer Preview audience is small and reachable.
4. **`6-0-dev` merges into `main` on both scaffolding repos before the
release.** `create-spree-app` clones `spree/spree-starter` and
@@ -178,26 +206,51 @@ must land before any version bump, because both change what a publish *does*.
`Release` workflow push all nine gems. Confirm each appears on RubyGems
before proceeding — the starter's pin depends on every one of them.
-4. **Version and publish the npm packages.** Add a changeset giving
- `@spree/sdk` a major, then `pnpm changeset version` (plain — *not*
- `version:preview`, which carries `--ignore @spree/sdk`). Hand-edit the
- resulting `@spree/sdk` version to `2.0.0-beta.1`; Changesets has no
- first-class prerelease-major path that plays well with a one-package
- exception. Merge to main and let the release chain publish.
-
-5. **Merge `6-0-dev` into `main`** on `spree/spree-starter` and
+4. **Refresh the Developer-Preview notes in the package READMEs.**
+ `@spree/dashboard` and `@spree/dashboard-ui` both say APIs "may change
+ between 0.x releases", which stops being true at `1.0.0-beta.1`; the seller
+ packages' notes already name the `beta` tag. Reword them to the beta line
+ (published under `beta`, promoted to `latest` at GA) in the same change as
+ the version bump, so npm never shows install instructions that contradict
+ the published tag.
+
+5. **Version and publish the npm packages.** Clear the changeset backlog with
+ `pnpm changeset version` (plain — *not* `version:preview`, which carries
+ `--ignore @spree/sdk`), then set the versions by hand: `1.0.0-beta.1` for
+ `@spree/admin-sdk`, the dashboard trio, `@spree/seller-sdk` and
+ `@spree/seller-dashboard`; `2.0.0-beta.1` for `@spree/sdk`. Changesets has
+ no first-class prerelease-major path that plays well with these exceptions,
+ so the edit is deliberate and reviewed. Merge to main and let the release
+ chain publish — `admin-sdk` and `seller` run in parallel, both gating
+ `release-cli`, which gates `create-spree-app`.
+
+6. **Merge `6-0-dev` into `main`** on `spree/spree-starter` and
`spree/storefront`. With steps 2-4 done, `main` on both repos resolves
released gems and a published SDK the moment it becomes the default, so
`create-spree-app` — which clones without `--branch` — scaffolds 6.0 with no
change to this repo. Point the storefront's `@spree/sdk` dependency at the
published `2.0.0-beta.1` in the same merge.
-6. **Smoke test the real path** — `npx create-spree-app@<candidate>` into a
+7. **Seller panel distribution** (done): `sync-dashboard-starter.mjs` is
+ generalized to `sync-starter.mjs <target> [starter-package]` and the CLI
+ build renders both templates; `spree add` gained a `seller-dashboard`
+ component (`addDashboard` → app-parameterized `addApp`, with the unit
+ battery now running against both apps); `create-spree-app` scaffolds
+ `apps/dashboard` **and** `apps/seller-dashboard`; the starter's Dockerfile
+ gained a mirrored `seller-dashboard` build stage (custom
+ `apps/seller-dashboard/` when present, stock template otherwise) that builds
+ with `VITE_BASE_PATH=/sellers/` and sets `SPREE_SELLER_PANEL_DIST_PATH`; and
+ `packages.yml` gained a `release-seller` job publishing `@spree/seller-sdk`
+ then `@spree/seller-dashboard`, with `release-cli` gated on it. The
+ Dockerfile change lives in the starter repo and rides the same merge as
+ step 2.
+
+8. **Smoke test the real path** — `npx create-spree-app@<candidate>` into a
temp dir, boot it, confirm the dashboard loads and the storefront talks to
the API. The scaffold is the only test that exercises gem pins, npm ranges
and branch defaults together, and it is the first thing a beta user runs.
-7. **Announce as beta**, naming the install commands explicitly: gems need
+9. **Announce as beta**, naming the install commands explicitly: gems need
`--pre` or an exact pin, `@spree/sdk` needs `@beta`.
## Constraints on Current Work
@@ -227,13 +280,10 @@ must land before any version bump, because both change what a publish *does*.
- CLI and create-spree-app: `latest` (option a, 6.0 becomes the default) or
`beta`-tagged (option b, opt-in)? Recommend (a); it's the stated goal.
-- Should `@spree/seller-sdk` and `@spree/seller-dashboard` (both unpublished,
- 0.1.0, with no release jobs) ship in this train or wait? They currently have
- no publish jobs in `packages.yml` at all.
## References
- `.github/workflows/packages.yml` — npm release chain
- `.github/workflows/release.yml` — gem release on `v*` tags
-- `scripts/sync-dashboard-starter.mjs` — embedded template version flooring
+- `scripts/sync-starter.mjs` — embedded template version flooring
- `docs/plans/5.6-project-layout-and-dashboard.md` — dashboard packaging
diff --git a/packages/admin-sdk/CHANGELOG.md b/packages/admin-sdk/CHANGELOG.md
index 1cd19e1e16..dfdabdae20 100644
--- a/packages/admin-sdk/CHANGELOG.md
+++ b/packages/admin-sdk/CHANGELOG.md
@@ -1,5 +1,141 @@
# @spree/admin-sdk
+## 1.0.0
+
+### Major Changes
+
+- [#14442](https://github.com/spree/spree/pull/14442) [`4df88ac`](https://github.com/spree/spree/commit/4df88ac684688e65623703544686c6043a8ed816) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Rename the geography fields to `country_code` and `state_code` across the v3 API, replacing `country_iso` and `state_abbr`. Addresses, stock locations, delivery zone members, markets, tax rates and tax exemption certificates all use the new names, on read and on write. Markets rename their list of countries from `country_isos` to `country_codes`.
+
+ Addresses keep `country_iso` and `state_abbr` as deprecated read fields and accepted write names for one release, so existing storefronts keep working; both are removed in 6.1. Every other resource moves outright.
+
+- [#14445](https://github.com/spree/spree/pull/14445) [`6d4fe64`](https://github.com/spree/spree/commit/6d4fe64a1444bc42338942025a4ed1d5788cb9d7) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - First-run setup asks which country the store sells from.
+
+ `completeSetup` now requires `country_code` and accepts optional `locale` and `currency`. Both default to the country's own — its first official language and its currency — so a store's money and geography agree unless you say otherwise. An unrecognised currency is now rejected rather than quietly ignored.
+
+ `login`, `acceptInvitation`, `resetPassword` and `completeSetup` on the dashboard auth context now resolve with the session they establish, so callers can read the signed-in user without waiting for provider state.
+
+ A new `auth.setupCountries()` lists the countries a store can be set up in, each with the currency and official languages derived from it. Like the rest of the setup flow it needs no credentials, and stops answering once an admin account exists.
+
+- [#14458](https://github.com/spree/spree/pull/14458) [`da49f27`](https://github.com/spree/spree/commit/da49f27a5da1e40dbd4ce0901f8d4b21573d98df) Thanks [@mad-eel](https://github.com/mad-eel)! - Renamed stock items to stock levels.
+
+ Spree 6.0 renames `Spree::StockItem` to `Spree::StockLevel`, and the admin API and SDK follow. There is no compatibility shim on the client side, so update your code before upgrading:
+
+ - `client.stockItems` is now `client.stockLevels`, and it calls `/stock_levels` instead of `/stock_items`.
+ - The `StockItem` type is now `StockLevel`, and `StockItemUpdateParams` is now `StockLevelUpdateParams`.
+ - `StockLevelUpdateParams` also gains `reason`, which labels a count correction in the stock history.
+ - `client.stockMovements` is new, and reads the typed stock history behind those levels.
+ - A variant's `stock_items` array is now `stock_levels`, on both reads and writes.
+ - `Subject.StockItem` is now `Subject.StockLevel` in `@spree/dashboard-core`. The old name stays as a deprecated alias for one release.
+ - Prefixed ids change from `si_…` to `sl_…`. Ids you stored earlier no longer resolve.
+
+ Webhook endpoints keep working: Spree publishes both `stock_level.*` and the older `stock_item.*` events for one release, so existing subscriptions keep firing. The dashboard's event picker now offers the `stock_level` names, and shows any `stock_item` subscription you already have under its Custom section. Move your subscriptions over before Spree 6.1, when the old names stop being published.
+
+- [#14461](https://github.com/spree/spree/pull/14461) [`32d4db9`](https://github.com/spree/spree/commit/32d4db9cdb027d9fb59e18807b26c0aa6ceb48ad) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Store credits no longer carry a category. `client.storeCreditCategories` and the `StoreCreditCategory` type are removed, `category_id` is no longer accepted or returned on customer store credits, and the dashboard's issue/edit store credit dialogs drop the category picker — the memo is the place to record why a credit was issued.
+
+### Minor Changes
+
+- [#14410](https://github.com/spree/spree/pull/14410) [`fdd88eb`](https://github.com/spree/spree/commit/fdd88eb3d2d7ac36a710a2af38593a8f4c83f2bf) Thanks [@mad-eel](https://github.com/mad-eel)! - Add dashboard pages for business customers and tax configuration.
+
+ Companies get a list and a detail page with their branches, tax registration
+ and exemption certificates; a branch has its own page listing the buyers
+ authorised to purchase for it. Customers gain the same tax registration panel
+ on their profile. Tax rates get a settings page, and a market can now name the
+ tax engine that prices it — showing what that engine cannot handle, so a
+ merchant learns about a gap while configuring rather than from a tax bill.
+
+ The admin SDK gains the customer tax-identifier endpoints and `tax_provider`
+ on market params.
+
+- [#14430](https://github.com/spree/spree/pull/14430) [`9a4eb46`](https://github.com/spree/spree/commit/9a4eb466c2698d15d735c06e4b5faf984bb63dd2) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Order numbers are now configurable from the dashboard.
+
+ **Settings → Store → Order numbers** controls how document numbers are shaped: the numbering format (sequential or random), the order number prefix and suffix, and the value the sequence starts at. A live preview shows what the next number will look like.
+
+ Sequential numbering is the new default — orders count up from 1001 (`R1001`, `R1002`) instead of carrying nine random digits. Merchants who would rather not disclose their order volume can switch the format back to random. Either way, changes apply to future orders only; numbers already issued never change.
+
+ `StoreUpdateParams` and the `Store` type gain `preferred_document_number_format`, `preferred_order_number_prefix`, `preferred_order_number_suffix` and `preferred_order_number_sequence_start`.
+
+- [#14489](https://github.com/spree/spree/pull/14489) [`889a8cf`](https://github.com/spree/spree/commit/889a8cfd24443710cfff5a7d30fbe83d65148cac) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Media library. Every image and video in a store now lives in one place under Products → Media: browse it, search by file name, filter by type or by whether a file is in use, and upload files before deciding where they go. Picking a file from the library reuses it rather than copying it, so the same photo on three products is one file in storage.
+
+ The library is reachable from everywhere media is set. The product gallery gains "Add from library", category, collection and seller image fields gain "Choose from library", and the rich text editor can embed an image in a description for the first time. Category and collection images now appear in the library too, so a file uploaded there can be reused anywhere else.
+
+ Every file shows where it is used before it is deleted, and deleting one that is still in use removes it from those places once the merchant confirms.
+
+ New in `@spree/admin-sdk`: the `media` resource (`list`, `get`, `create`, `update`, `delete`, `usage`), `source_media_id` on product media creation for reuse, and `signed_id`, `embed_url`, `filename`, `content_type`, `byte_size` and `attached` on the admin media payload.
+
+- [#14591](https://github.com/spree/spree/pull/14591) [`8e5dc20`](https://github.com/spree/spree/commit/8e5dc20147ff24f53dd73b506c3f06a074d3d302) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Volume pricing: quantity breaks, percentage tiers and a price-list CSV.
+
+ A price list can now carry a ladder per variant — a unit price from each
+ quantity up — edited as tier rows in the price spreadsheet, and a catalog's
+ percentage adjustment can step by quantity too. The catalog's price column
+ shows how many tiers a variant carries, with the ladder on hover and a note
+ that fixed tiers set the price regardless of the percentage.
+
+ A price list's prices can be exported and imported as CSV, one rung per row
+ keyed by SKU, from the list's own page and from the catalog that owns it.
+ The import merges: rows in the file are written, a blank price removes that
+ rung, and rungs the file does not mention are left alone. The admin SDK's
+ price, price list and import types carry the new fields, and the import
+ create call accepts the price list to merge into.
+
+- [#14457](https://github.com/spree/spree/pull/14457) [`676aa0d`](https://github.com/spree/spree/commit/676aa0dee62a26944cb0a2c83273b149ba922b8a) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Product galleries can hold video.
+
+ A media item now says what it is through `media_type`. `video` is a file you upload and serve yourself; `external_video` is a YouTube or Vimeo link. Both sit in the same gallery as images and reorder alongside them.
+
+ Spree reads the link when it is saved and rejects anything it cannot embed, so the media object comes back carrying `video_provider`, `video_embed_url`, `video_url` and `poster_url` — a storefront embeds a video without parsing links itself. A video's sized URLs resolve to its poster, so a gallery written for images still renders the right still.
+
+ `MediaCreateParams` and `MediaUpdateParams` accept `media_type`, `external_video_url`, `poster_signed_id` and the focal point. The `type` parameter, which named an internal Ruby class, is gone — `media_type` replaces it.
+
+ A video carries a **poster** — the still shown before it plays. Upload one with `poster_signed_id`, or leave it off and a YouTube link falls back to the provider's own image. Spree does not extract a frame from an uploaded file, so hosted video and Vimeo links want a poster.
+
+ In the dashboard, video files upload through the same drop zone as images, an "Add video link" button takes a YouTube or Vimeo URL, and the media editor plays the video back and takes a poster the merchant uploads. The editor also gains a focal-point picker: click the spot on an image that must stay in frame when a storefront crops it.
+
+ Choosing which variants a media item represents happens in one place — the media editor on the product. The unmounted variant-side gallery picker has been removed; it was a second way to edit the same thing.
+
+- [#14462](https://github.com/spree/spree/pull/14462) [`abc6e22`](https://github.com/spree/spree/commit/abc6e22cb60ea305a83583ded0b999458b2c9cbd) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Which address a sale's tax is computed from is now a store setting rather than a global one. `preferred_tax_using_ship_address` can be read and written through the Admin API, and merchants can change it under Settings → Store in the Payments card. The default is unchanged: tax follows the shipping address.
+
+### Patch Changes
+
+- [#14521](https://github.com/spree/spree/pull/14521) [`9cee487`](https://github.com/spree/spree/commit/9cee487fdce34c5f2ec873fc1d965196bd716663) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - New address forms pre-select the store's default country.
+
+ The Admin store payload now includes `default_country_code` (the same country the default market already answers). The shared address dialog uses it for new records and leaves an existing address's country alone.
+
+- [#14394](https://github.com/spree/spree/pull/14394) [`a8b11ec`](https://github.com/spree/spree/commit/a8b11ecb409a04c8d48ec6d64892ffa3bd6dacf7) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Collections reach both SDKs.
+
+ `@spree/sdk` (storefront):
+
+ - `collections.list()` / `collections.get(idOrPermalink)` — the flat, merchandising-driven groupings ("Summer Sale", "New Arrivals"), whether membership is curated by hand or maintained from rules.
+ - `collections.products.list(idOrPermalink, params)` — a collection's product listing page. Takes the same filters and sorts as `products.list`, and when `sort` is omitted the collection's own `sort_order` applies, so a shopper sees the ordering the merchant chose (including their manual arrangement).
+ - `in_collection` on `ProductListParams`, for composing a collection filter into a wider product query.
+
+ `@spree/admin-sdk` (back office):
+
+ - `collections` CRUD, with reordering as a plain 1-based `position` on update rather than a separate action — collections are a flat list. Nested `collections.products` covers membership, ordering and `reposition`, plus custom fields and translations.
+ - `collectionRules.types()` enumerates the registered rule kinds, so a rule a plugin registers shows up without an SDK release.
+ - `products.bulkAddToCollections` / `bulkRemoveFromCollections`, and `collection_ids` on product create/update.
+ - `rules` on a collection is expand-gated (`?expand=rules`), matching `custom_fields` — a listing no longer ships every collection's full rule set.
+ - `hide_from_nav` is gone from the category params. Nothing read it.
+
+- [#14417](https://github.com/spree/spree/pull/14417) [`7e35951`](https://github.com/spree/spree/commit/7e35951361a6cee7b735640b0228710928719fee) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Rich-text fields read as plain text plus HTML.
+
+ Spree 6.0 stores rich text as sanitized HTML in plain text columns instead of Action Text. The write params are unchanged — `description` and `internal_note` still take the value, and that value is HTML.
+
+ What changed is the read side:
+
+ - `internal_note_html` is now readable on `Order`, and `internal_note` (plain text) on `Customer`. Previously the order serializer returned only plain text and the customer serializer only HTML; both now return the pair.
+ - `description` returns tag-stripped plain text, with the markup under `description_html`. Hydrate an editor from `description_html`, not `description`.
+
+ The field stores HTML, so send markup — a plain-text value with newlines in it renders as one run-on line.
+
+- [#14376](https://github.com/spree/spree/pull/14376) [`a52a6da`](https://github.com/spree/spree/commit/a52a6da42f5c456e889f8bba12ee7194934289b1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Admin API additions from the 6.0 core rewrite:
+
+ - `deliveryMethods.rules` CRUD and `deliveryMethods.ruleTypes()` — delivery method eligibility rules (item total, weight).
+ - `orders.discountCodes.create/delete` — apply and remove coupon codes on draft orders with the storefront's pending semantics.
+ - `expand=cart` on orders returns the originating cart (new admin `Cart` type); the embedded promotion summaries moved from the `discounts` key to `applied_promotions` (the `discounts` name stays reserved for the typed money rows at `/orders/:id/discounts`).
+ - Delivery methods accept `stock_location_ids` for pickup; delivery zones, delivery methods and stock locations are store-scoped.
+ - `Order` gains `cart_id` and `coupon_code`; `DeliveryZone.members` requires `expand=members`.
+
+- [#14593](https://github.com/spree/spree/pull/14593) [`0f22450`](https://github.com/spree/spree/commit/0f224508b3d270aaa9899a508966a27c37f873ed) Thanks [@Hemang-ai](https://github.com/Hemang-ai)! - Preserve HTTP error statuses when a server returns an empty, non-JSON, or malformed error body. Avoid treating these responses as network failures, and allow admin and seller session recovery to handle unauthorized responses.
+
## 0.8.1
### Patch Changes
diff --git a/packages/admin-sdk/package.json b/packages/admin-sdk/package.json
index 9e9161380f..97b99acabd 100644
--- a/packages/admin-sdk/package.json
+++ b/packages/admin-sdk/package.json
@@ -1,6 +1,6 @@
{
"name": "@spree/admin-sdk",
- "version": "0.8.1",
+ "version": "1.0.0-beta.1",
"description": "Official TypeScript SDK for Spree Commerce Admin API",
"type": "module",
"main": "./dist/index.cjs",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index d32a93dece..c7878ed881 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -1,5 +1,57 @@
# @spree/cli
+## 3.0.0
+
+### Major Changes
+
+- [#14385](https://github.com/spree/spree/pull/14385) [`464df81`](https://github.com/spree/spree/commit/464df815f2b305b21c47ecaa722d35f52ae6a1f1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Dropped the legacy Rails admin from the CLI.
+
+ `spree_admin` is removed in Spree 6.0, so the CLI no longer references it:
+
+ - `spree dev` and `spree eject` no longer compile the admin Tailwind stylesheet or start its watcher — the `spree:admin:tailwindcss:build` and `spree:admin:tailwindcss:watch` rake tasks went with the gem.
+ - `spree dev`, `spree init` and `spree open` no longer point at `http://localhost:<port>/admin`, which now 404s. With a dashboard app present they open its Vite dev server; without one they open the store, and the summary card says to run `spree add dashboard`.
+
+ Admin UI now ships as the React dashboard. Run it with `spree dev` (co-runs the dashboard dev server) or add it with `spree add dashboard`. Projects ejected before this release can delete the orphaned `backend/app/assets/builds/spree/admin/` directory.
+
+- [#14431](https://github.com/spree/spree/pull/14431) [`aab4b5c`](https://github.com/spree/spree/commit/aab4b5ca517d2ef559a5ba292965d66bd2d6f38d) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - `spree init` asks who the admin is instead of seeding a known account.
+
+ Spree 6.0 stops seeding `[email protected]` / `spree123`, so the CLI no longer prints or assumes those credentials:
+
+ - `spree init` prompts for an admin email and password, or takes `--admin-email` / `--admin-password`. Both are validated before Docker starts, rather than failing minutes into the run, and passing only one is rejected.
+ - A non-interactive run without those flags (CI, a piped invocation) creates **no admin**. The seed prints a one-time setup link instead, and the summary card shows it — open it to create the first account in the dashboard. `--open` goes straight there.
+ - Sample data is skipped on that path, since its import needs an admin to own it. Load it after setup with `spree sample-data`.
+ - `spree dev` names the admin email `spree init` seeded; when no account was seeded it points at the setup link rather than guessing an address.
+ - The exported `DEFAULT_ADMIN_EMAIL` and `DEFAULT_ADMIN_PASSWORD` constants are gone.
+
+ Scripted installs that relied on the old credentials must now pass `--admin-email` and `--admin-password`.
+
+### Minor Changes
+
+- Added the marketplace Seller Panel to project scaffolding and deployment.
+
+ `spree add seller-dashboard` scaffolds the panel into `apps/seller-dashboard/`, and `create-spree-app` now creates both admin apps. The CLI bundles the seller-panel starter template alongside the dashboard one, so the Spree starter's Docker image can bake both and serve the panel at `/sellers`.
+
+### Patch Changes
+
+- [#14417](https://github.com/spree/spree/pull/14417) [`7e35951`](https://github.com/spree/spree/commit/7e35951361a6cee7b735640b0228710928719fee) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Rich-text fields read as plain text plus HTML.
+
+ Spree 6.0 stores rich text as sanitized HTML in plain text columns instead of Action Text. The write params are unchanged — `description` and `internal_note` still take the value, and that value is HTML.
+
+ What changed is the read side:
+
+ - `internal_note_html` is now readable on `Order`, and `internal_note` (plain text) on `Customer`. Previously the order serializer returned only plain text and the customer serializer only HTML; both now return the pair.
+ - `description` returns tag-stripped plain text, with the markup under `description_html`. Hydrate an editor from `description_html`, not `description`.
+
+ The field stores HTML, so send markup — a plain-text value with newlines in it renders as one run-on line.
+
+- [#14376](https://github.com/spree/spree/pull/14376) [`a52a6da`](https://github.com/spree/spree/commit/a52a6da42f5c456e889f8bba12ee7194934289b1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Admin API additions from the 6.0 core rewrite:
+
+ - `deliveryMethods.rules` CRUD and `deliveryMethods.ruleTypes()` — delivery method eligibility rules (item total, weight).
+ - `orders.discountCodes.create/delete` — apply and remove coupon codes on draft orders with the storefront's pending semantics.
+ - `expand=cart` on orders returns the originating cart (new admin `Cart` type); the embedded promotion summaries moved from the `discounts` key to `applied_promotions` (the `discounts` name stays reserved for the typed money rows at `/orders/:id/discounts`).
+ - Delivery methods accept `stock_location_ids` for pickup; delivery zones, delivery methods and stock locations are store-scoped.
+ - `Order` gains `cart_id` and `coupon_code`; `DeliveryZone.members` requires `expand=members`.
+
## 2.4.9
### Patch Changes
diff --git a/packages/cli/package.json b/packages/cli/package.json
index d111676241..37d43b6ceb 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@spree/cli",
- "version": "2.4.9",
+ "version": "3.0.0",
"description": "CLI for managing Spree Commerce projects",
"type": "module",
"bin": {
@@ -12,7 +12,7 @@
"LICENSE"
],
"scripts": {
- "build": "node scripts/bundle-spec.mjs && node ../../scripts/sync-dashboard-starter.mjs templates/dashboard-starter && tsup",
+ "build": "node scripts/bundle-spec.mjs && node ../../scripts/sync-starter.mjs templates/dashboard-starter && node ../../scripts/sync-starter.mjs templates/seller-dashboard-starter seller-dashboard-starter && tsup",
"dev": "tsup --watch",
"test": "vitest run",
"typecheck": "tsc --noEmit",
diff --git a/packages/cli/src/commands/add.ts b/packages/cli/src/commands/add.ts
index 918696db5b..a167079037 100644
--- a/packages/cli/src/commands/add.ts
+++ b/packages/cli/src/commands/add.ts
@@ -6,10 +6,46 @@ import type { Command } from 'commander'
import { execa } from 'execa'
import pc from 'picocolors'
import { isNotFound } from '../config.js'
-import { DASHBOARD_PORT } from '../constants.js'
+import { DASHBOARD_PORT, SELLER_DASHBOARD_PORT } from '../constants.js'
import { detectProject } from '../context.js'
import type { ProjectContext } from '../types.js'
+/**
+ * The two admin SPAs `spree add` can scaffold. They differ only in where they
+ * live, which bundled template they come from, and which port they serve on —
+ * everything else (env file, install, recovery) is identical, so they share
+ * one implementation rather than two that drift.
+ */
+interface AppSpec {
+ /** Directory under `apps/`. */
+ dir: string
+ /** Template directory name inside the CLI's bundled `templates/`. */
+ template: string
+ /** Env var overriding the bundled template. */
+ templateEnvVar: string
+ /** Dev-server port, for the closing summary. */
+ port: number
+ /** Human name used in prompts and messages. */
+ label: string
+}
+
+const APPS: Record<string, AppSpec> = {
+ dashboard: {
+ dir: 'dashboard',
+ template: 'dashboard-starter',
+ templateEnvVar: 'SPREE_DASHBOARD_TEMPLATE',
+ port: DASHBOARD_PORT,
+ label: 'Dashboard',
+ },
+ 'seller-dashboard': {
+ dir: 'seller-dashboard',
+ template: 'seller-dashboard-starter',
+ templateEnvVar: 'SPREE_SELLER_DASHBOARD_TEMPLATE',
+ port: SELLER_DASHBOARD_PORT,
+ label: 'Seller Panel',
+ },
+}
+
interface AddDashboardOptions {
/** Git URL or local directory to copy the starter from. */
template: string
@@ -20,31 +56,34 @@ interface AddDashboardOptions {
}
// `spree add <thing>` — bolt an optional component onto an existing project.
-// Dashboard only for now; storefront parity is planned (see
+// Dashboard and seller panel for now; storefront parity is planned (see
// docs/plans/5.6-project-layout-and-dashboard.md).
export function registerAddCommand(program: Command) {
program
.command('add')
.description('Add an optional component to your project')
- .argument('<thing>', 'Component to add (currently: dashboard)')
+ .argument('<thing>', 'Component to add: dashboard or seller-dashboard')
.option(
'--template <src>',
- 'Starter template: git URL or local path (default: the template bundled with the CLI; env SPREE_DASHBOARD_TEMPLATE overrides)',
+ 'Starter template: git URL or local path (default: the template bundled with the CLI; env SPREE_DASHBOARD_TEMPLATE / SPREE_SELLER_DASHBOARD_TEMPLATE overrides)',
)
.option('--no-install', 'Skip dependency install')
.option('--quiet', 'Skip the final summary note (for wrapping tools that print their own)')
.action(
async (thing: string, flags: { template?: string; install: boolean; quiet?: boolean }) => {
- if (thing !== 'dashboard') {
- console.error(`\n${pc.red('Error:')} Unknown component: ${thing}. Try: dashboard\n`)
+ const app = APPS[thing]
+ if (!app) {
+ console.error(
+ `\n${pc.red('Error:')} Unknown component: ${thing}. Try: ${Object.keys(APPS).join(', ')}\n`,
+ )
process.exit(2)
}
- p.intro(pc.bgCyan(pc.black(' Spree Dashboard ')))
+ p.intro(pc.bgCyan(pc.black(` Spree ${app.label} `)))
const ctx = detectProject()
- await addDashboard(ctx, {
+ await addApp(ctx, app, {
template:
- flags.template ?? process.env.SPREE_DASHBOARD_TEMPLATE ?? resolveBundledTemplate(),
+ flags.template ?? process.env[app.templateEnvVar] ?? resolveBundledTemplate(app),
install: flags.install,
quiet: flags.quiet,
})
@@ -60,50 +99,54 @@ export function registerAddCommand(program: Command) {
* env values are compiled into the client bundle, so a key here would ship
* to every browser.
*
- * Idempotent: an existing `apps/dashboard/` is left untouched (recovery mode
+ * Idempotent: an existing `apps/<dir>/` is left untouched (recovery mode
* rewrites a missing `.env.local` only).
*/
-export async function addDashboard(ctx: ProjectContext, opts: AddDashboardOptions): Promise<void> {
- const dashboardDir = path.join(ctx.projectDir, 'apps', 'dashboard')
- const envPath = path.join(dashboardDir, '.env.local')
+export async function addApp(
+ ctx: ProjectContext,
+ app: AppSpec,
+ opts: AddDashboardOptions,
+): Promise<void> {
+ const appDir = path.join(ctx.projectDir, 'apps', app.dir)
+ const envPath = path.join(appDir, '.env.local')
- if (fs.existsSync(dashboardDir)) {
+ if (fs.existsSync(appDir)) {
// Recovery: write a missing .env.local (interrupted earlier run) or
// repair a broken one (old scaffold output) — one gatekeeper for both.
- const env = ensureDashboardDevEnv(ctx.projectDir, ctx.port)
+ const env = ensureAppDevEnv(ctx.projectDir, app.dir, ctx.port)
if (env === 'untouched') {
- p.log.warn(`${pc.bold('apps/dashboard/')} already exists. Nothing to do.`)
+ p.log.warn(`${pc.bold(`apps/${app.dir}/`)} already exists. Nothing to do.`)
return
}
p.log.info(
- `${env === 'written' ? 'Wrote missing' : 'Repaired'} ${pc.bold('apps/dashboard/.env.local')}. Nothing else to do.`,
+ `${env === 'written' ? 'Wrote missing' : 'Repaired'} ${pc.bold(`apps/${app.dir}/.env.local`)}. Nothing else to do.`,
)
return
}
const s = p.spinner()
- s.start('Fetching dashboard starter...')
+ s.start(`Fetching ${app.label.toLowerCase()} starter...`)
try {
- await fetchTemplate(opts.template, dashboardDir)
- restoreGitignore(dashboardDir)
+ await fetchTemplate(opts.template, appDir)
+ restoreGitignore(appDir)
} catch (err) {
s.stop('Fetch failed.')
p.log.error(err instanceof Error ? err.message : String(err))
process.exit(1)
}
- s.stop(`Created ${pc.cyan('apps/dashboard/')}`)
+ s.stop(`Created ${pc.cyan(`apps/${app.dir}/`)}`)
writeDashboardEnv(envPath, ctx.port)
- const pm = detectPackageManager(ctx.projectDir, dashboardDir)
+ const pm = detectPackageManager(ctx.projectDir, appDir)
if (opts.install) {
s.start(`Installing dependencies with ${pm}...`)
try {
- await execa(pm, ['install'], { cwd: dashboardDir })
+ await execa(pm, ['install'], { cwd: appDir })
s.stop('Dependencies installed.')
} catch (err) {
- s.stop(pc.yellow(`${pm} install failed — run it manually in apps/dashboard/.`))
+ s.stop(pc.yellow(`${pm} install failed — run it manually in apps/${app.dir}/.`))
p.log.warn(err instanceof Error ? err.message : String(err))
}
}
@@ -116,38 +159,36 @@ export async function addDashboard(ctx: ProjectContext, opts: AddDashboardOption
` ${pc.dim('# runs the API and the dashboard together')}`,
...(opts.install
? []
- : [` ${pc.dim(`# install dependencies first: cd apps/dashboard && ${pm} install`)}`]),
+ : [` ${pc.dim(`# install dependencies first: cd apps/${app.dir} && ${pm} install`)}`]),
'',
- `Then open ${pc.bold(`http://localhost:${DASHBOARD_PORT}`)} and sign in`,
- `with your admin email and password.`,
+ `Then open ${pc.bold(`http://localhost:${app.port}`)} and sign in.`,
].join('\n'),
- 'Dashboard added!',
+ `${app.label} added!`,
)
}
/**
- * The dashboard-starter template bundled inside this package. Generated at
- * build time from the monorepo's `packages/dashboard-starter` (workspace
- * deps rewritten to the published versions — see
- * `scripts/sync-dashboard-starter.mjs`) and shipped in `dist/templates/`.
- * Bundling it with the CLI keeps the template and the `@spree/dashboard*`
- * versions it pins in lockstep with every release — there is no separate
- * template repo to drift.
+ * A starter template bundled inside this package. Generated at build time
+ * from the monorepo's `packages/<name>` (workspace deps rewritten to the
+ * published versions — see `scripts/sync-starter.mjs`) and shipped in
+ * `dist/templates/`. Bundling them with the CLI keeps each template and the
+ * `@spree/*` versions it pins in lockstep with every release — there is no
+ * separate template repo to drift.
*/
-function resolveBundledTemplate(): string {
+function resolveBundledTemplate(app: AppSpec): string {
const here = path.dirname(fileURLToPath(import.meta.url))
- // dev: src/commands/add.ts → ../../templates/dashboard-starter
- // built: dist/index.js → dist/templates/dashboard-starter
+ // dev: src/commands/add.ts → ../../templates/<name>
+ // built: dist/index.js → dist/templates/<name>
const candidates = [
- path.resolve(here, '../../templates/dashboard-starter'),
- path.resolve(here, 'templates/dashboard-starter'),
+ path.resolve(here, '../../templates', app.template),
+ path.resolve(here, 'templates', app.template),
]
for (const candidate of candidates) {
if (fs.existsSync(path.join(candidate, 'package.json'))) return candidate
}
console.error(
- `\n${pc.red('Error:')} Bundled dashboard template not found. In the monorepo, ` +
- `run ${pc.cyan('pnpm build')} in packages/cli first (it generates the template), ` +
+ `\n${pc.red('Error:')} Bundled ${app.label.toLowerCase()} template not found. In the monorepo, ` +
+ `run ${pc.cyan('pnpm build')} in packages/cli first (it generates the templates), ` +
'or pass --template <path|git-url>.\n',
)
process.exit(1)
@@ -193,14 +234,15 @@ const BROKEN_SCAFFOLD_ENV = /^VITE_SPREE_API_URL=(https?:\/\/localhost\S*)$/m
* only that line is rewritten — everything else in the file is user-managed
* and preserved).
*/
-export function ensureDashboardDevEnv(
+export function ensureAppDevEnv(
projectDir: string,
+ appDirName: string,
port: number,
): 'written' | 'repaired' | 'untouched' {
- const dashboardDir = path.join(projectDir, 'apps', 'dashboard')
- if (!fs.existsSync(path.join(dashboardDir, 'package.json'))) return 'untouched'
+ const appDir = path.join(projectDir, 'apps', appDirName)
+ if (!fs.existsSync(path.join(appDir, 'package.json'))) return 'untouched'
- const envPath = path.join(dashboardDir, '.env.local')
+ const envPath = path.join(appDir, '.env.local')
let existing: string
try {
existing = fs.readFileSync(envPath, 'utf-8')
@@ -218,6 +260,25 @@ export function ensureDashboardDevEnv(
return 'repaired'
}
+/** Every SPA under `apps/` that `spree dev` and first-run setup keep in sync. */
+export const APP_DIRS = Object.values(APPS).map((app) => app.dir)
+
+/**
+ * Refresh the dev env file for every scaffolded SPA. Apps that aren't present
+ * report 'untouched', so this is safe to call unconditionally.
+ */
+export function ensureDashboardDevEnv(
+ projectDir: string,
+ port: number,
+): 'written' | 'repaired' | 'untouched' {
+ let result: 'written' | 'repaired' | 'untouched' = 'untouched'
+ for (const dir of APP_DIRS) {
+ const outcome = ensureAppDevEnv(projectDir, dir, port)
+ if (outcome !== 'untouched') result = outcome
+ }
+ return result
+}
+
function writeDashboardEnv(envPath: string, port: number): void {
fs.writeFileSync(
envPath,
@@ -240,8 +301,8 @@ function writeDashboardEnv(envPath: string, port: number): void {
}
/** Prefer the project's own package manager (by lockfile); default to pnpm. */
-export function detectPackageManager(projectDir: string, dashboardDir: string): string {
- for (const dir of [dashboardDir, projectDir]) {
+export function detectPackageManager(projectDir: string, appDir: string): string {
+ for (const dir of [appDir, projectDir]) {
if (fs.existsSync(path.join(dir, 'pnpm-lock.yaml'))) return 'pnpm'
if (fs.existsSync(path.join(dir, 'yarn.lock'))) return 'yarn'
if (fs.existsSync(path.join(dir, 'package-lock.json'))) return 'npm'
diff --git a/packages/cli/src/constants.ts b/packages/cli/src/constants.ts
index c82abcd39e..c996f85a27 100644
--- a/packages/cli/src/constants.ts
+++ b/packages/cli/src/constants.ts
@@ -1,3 +1,5 @@
export const DEFAULT_SPREE_PORT = 3000
export const DASHBOARD_PORT = 5173
export const STOREFRONT_PORT = 3001
+// Seller panel dev server. 5174 matches the monorepo's own `pnpm wt:seller`.
+export const SELLER_DASHBOARD_PORT = 5174
diff --git a/packages/cli/tests/add-dashboard.test.ts b/packages/cli/tests/add-dashboard.test.ts
index c71c0e9097..a8a3e5594e 100644
--- a/packages/cli/tests/add-dashboard.test.ts
+++ b/packages/cli/tests/add-dashboard.test.ts
@@ -2,15 +2,34 @@ import fs from 'node:fs'
import os from 'node:os'
import path from 'node:path'
import { afterEach, beforeEach, describe, expect, it } from 'vitest'
-import { addDashboard, ensureDashboardDevEnv } from '../src/commands/add.js'
+import { addApp, ensureDashboardDevEnv } from '../src/commands/add.js'
import type { ProjectContext } from '../src/types.js'
+// The two apps `spree add` scaffolds. Both go through addApp, so the same
+// battery runs against each — the seller panel is not a second-class path.
+const APPS = [
+ {
+ dir: 'dashboard',
+ template: 'dashboard-starter',
+ templateEnvVar: 'SPREE_DASHBOARD_TEMPLATE',
+ port: 5173,
+ label: 'Dashboard',
+ },
+ {
+ dir: 'seller-dashboard',
+ template: 'seller-dashboard-starter',
+ templateEnvVar: 'SPREE_SELLER_DASHBOARD_TEMPLATE',
+ port: 5174,
+ label: 'Seller Panel',
+ },
+] as const
+
/**
* Exercises the local-directory template path (the same code `--template
- * <path>` and SPREE_DASHBOARD_TEMPLATE hit). The git-clone path is the same
+ * <path>` and the template env vars hit). The git-clone path is the same
* function with a URL — covered by the smoke flow, not unit-testable offline.
*/
-describe('addDashboard', () => {
+describe.each(APPS)('addApp — $dir', (app) => {
let projectDir: string
let templateDir: string
@@ -40,10 +59,10 @@ describe('addDashboard', () => {
fs.rmSync(templateDir, { recursive: true, force: true })
})
- it('copies the template into apps/dashboard and writes .env.local with the project port', async () => {
- await addDashboard(ctx(), { template: templateDir, install: false })
+ it('copies the template into the app directory and writes .env.local with the project port', async () => {
+ await addApp(ctx(), app, { template: templateDir, install: false })
- const dashboardDir = path.join(projectDir, 'apps', 'dashboard')
+ const dashboardDir = path.join(projectDir, 'apps', app.dir)
expect(fs.existsSync(path.join(dashboardDir, 'package.json'))).toBe(true)
expect(fs.existsSync(path.join(dashboardDir, 'src', 'main.tsx'))).toBe(true)
expect(fs.existsSync(path.join(dashboardDir, 'node_modules'))).toBe(false)
@@ -59,21 +78,21 @@ describe('addDashboard', () => {
expect(fs.existsSync(path.join(dashboardDir, 'gitignore.template'))).toBe(false)
})
- it('is a no-op when apps/dashboard already exists', async () => {
- await addDashboard(ctx(), { template: templateDir, install: false })
- const marker = path.join(projectDir, 'apps', 'dashboard', 'src', 'custom.ts')
+ it('is a no-op when the app directory already exists', async () => {
+ await addApp(ctx(), app, { template: templateDir, install: false })
+ const marker = path.join(projectDir, 'apps', app.dir, 'src', 'custom.ts')
fs.writeFileSync(marker, '// user file\n')
- await addDashboard(ctx(), { template: templateDir, install: false })
+ await addApp(ctx(), app, { template: templateDir, install: false })
expect(fs.existsSync(marker)).toBe(true)
})
it('recovers a missing .env.local without touching anything else', async () => {
- await addDashboard(ctx(), { template: templateDir, install: false })
- const envPath = path.join(projectDir, 'apps', 'dashboard', '.env.local')
+ await addApp(ctx(), app, { template: templateDir, install: false })
+ const envPath = path.join(projectDir, 'apps', app.dir, '.env.local')
fs.rmSync(envPath)
- await addDashboard(ctx(), { template: templateDir, install: false })
+ await addApp(ctx(), app, { template: templateDir, install: false })
expect(fs.readFileSync(envPath, 'utf-8')).toContain('http://localhost:3999')
})
})
diff --git a/packages/create-spree-app/CHANGELOG.md b/packages/create-spree-app/CHANGELOG.md
index d2a1d0b97d..b6298976a2 100644
--- a/packages/create-spree-app/CHANGELOG.md
+++ b/packages/create-spree-app/CHANGELOG.md
@@ -1,5 +1,23 @@
# create-spree-app
+## 2.0.0
+
+### Major Changes
+
+- [#14431](https://github.com/spree/spree/pull/14431) [`aab4b5c`](https://github.com/spree/spree/commit/aab4b5ca517d2ef559a5ba292965d66bd2d6f38d) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Scaffolded apps no longer ship with a known admin password.
+
+ Spree 6.0 replaces the seeded `[email protected]` / `spree123` account with a first-run setup screen, so a new project no longer starts life with credentials that are public knowledge:
+
+ - The scaffold summary and the generated README point at first-run setup instead of printing an email and password.
+ - The first run opens the setup link, where you create the admin account and name the store.
+ - The exported `DEFAULT_ADMIN_EMAIL` and `DEFAULT_ADMIN_PASSWORD` constants are gone.
+
+### Minor Changes
+
+- Added the marketplace Seller Panel to project scaffolding and deployment.
+
+ `spree add seller-dashboard` scaffolds the panel into `apps/seller-dashboard/`, and `create-spree-app` now creates both admin apps. The CLI bundles the seller-panel starter template alongside the dashboard one, so the Spree starter's Docker image can bake both and serve the panel at `/sellers`.
+
## 1.2.1
### Patch Changes
diff --git a/packages/create-spree-app/package.json b/packages/create-spree-app/package.json
index c4e49dae53..925ccf0107 100644
--- a/packages/create-spree-app/package.json
+++ b/packages/create-spree-app/package.json
@@ -1,6 +1,6 @@
{
"name": "create-spree-app",
- "version": "1.2.1",
+ "version": "2.0.0",
"description": "Create a new Spree Commerce project with a single command",
"type": "module",
"bin": "./dist/index.js",
diff --git a/packages/create-spree-app/src/dashboard.ts b/packages/create-spree-app/src/dashboard.ts
index f097aa6c1d..7180ab89f6 100644
--- a/packages/create-spree-app/src/dashboard.ts
+++ b/packages/create-spree-app/src/dashboard.ts
@@ -3,21 +3,37 @@ import type { PackageManager } from './types.js'
import { runCommand } from './utils.js'
/**
- * Scaffold the React Dashboard into `apps/dashboard/` by delegating to the
- * project-local CLI: `spree add dashboard`. The generated project already
+ * Scaffold an admin SPA into `apps/<component>/` by delegating to the
+ * project-local CLI: `spree add <component>`. The generated project already
* depends on `@spree/cli` (installed with the root deps, before this phase),
- * and the CLI bundles the dashboard-starter template with version pins
- * matching its release — one template source, no copy in this package. The
- * command reads the API port from the project's `.env` and writes
- * `apps/dashboard/.env.local` itself (API URL only — never credentials).
+ * and the CLI bundles each starter template with version pins matching its
+ * release — one template source, no copy in this package. The command reads
+ * the API port from the project's `.env` and writes the app's `.env.local`
+ * itself (API URL only — never credentials).
*/
-export async function scaffoldDashboard(
+async function scaffoldApp(
projectDir: string,
+ component: 'dashboard' | 'seller-dashboard',
opts: { install: boolean; packageManager: PackageManager },
): Promise<void> {
- // --quiet: the scaffold's own summary cards cover the dashboard — the
- // command's "Dashboard added!" note would just duplicate them.
- const args = ['spree', 'add', 'dashboard', '--quiet']
+ // --quiet: the scaffold's own summary cards cover these — the command's
+ // own "… added!" note would just duplicate them.
+ const args = ['spree', 'add', component, '--quiet']
if (!opts.install) args.push('--no-install')
await execa(runCommand(opts.packageManager), args, { cwd: projectDir, stdio: 'inherit' })
}
+
+/**
+ * Scaffold both admin SPAs: the Dashboard at `apps/dashboard/` and the
+ * marketplace Seller Panel at `apps/seller-dashboard/`. Both ship in every
+ * project so the starter's Dockerfile finds them and bakes both into the
+ * image — a marketplace that never invites a seller simply leaves /sellers
+ * unvisited.
+ */
+export async function scaffoldDashboard(
+ projectDir: string,
+ opts: { install: boolean; packageManager: PackageManager },
+): Promise<void> {
+ await scaffoldApp(projectDir, 'dashboard', opts)
+ await scaffoldApp(projectDir, 'seller-dashboard', opts)
+}
diff --git a/packages/create-spree-app/src/scaffold.ts b/packages/create-spree-app/src/scaffold.ts
index 60f8c961f3..3ccf7a0668 100644
--- a/packages/create-spree-app/src/scaffold.ts
+++ b/packages/create-spree-app/src/scaffold.ts
@@ -137,10 +137,11 @@ export async function scaffold(options: ScaffoldOptions): Promise<void> {
}
}
- // Phase 3b: React Dashboard (optional, Developer Preview). Delegates to the
- // project-local `npx spree add dashboard` — @spree/cli is already installed
- // (root deps, above) and bundles the dashboard-starter template. It reads
- // the port from the project's .env and prints its own progress.
+ // Phase 3b: the admin SPAs (optional, Developer Preview) — the Dashboard
+ // and the marketplace Seller Panel. Delegates to the project-local
+ // `npx spree add <component>` — @spree/cli is already installed (root deps,
+ // above) and bundles both starter templates. It reads the port from the
+ // project's .env and prints its own progress.
let dashboardReady = dashboard
if (dashboard) {
try {
@@ -149,7 +150,11 @@ export async function scaffold(options: ScaffoldOptions): Promise<void> {
dashboardReady = false
// Remove the partial scaffold so the recovery command (`spree add
// dashboard`, which expects the directory to be absent) actually works.
- fs.rmSync(path.join(projectDir, 'apps', 'dashboard'), { recursive: true, force: true })
+ // Both apps go: the second can fail after the first succeeded, and a
+ // half-scaffolded pair is worse than none.
+ for (const app of ['dashboard', 'seller-dashboard']) {
+ fs.rmSync(path.join(projectDir, 'apps', app), { recursive: true, force: true })
+ }
p.log.warn(
`Continuing without the React Dashboard — add it later with ${pc.bold(`${runCommand(options.packageManager)} spree add dashboard`)}.\n${errorMessage(err)}`,
)
diff --git a/packages/dashboard-core/CHANGELOG.md b/packages/dashboard-core/CHANGELOG.md
index 4449cb792a..28ad2b82e6 100644
--- a/packages/dashboard-core/CHANGELOG.md
+++ b/packages/dashboard-core/CHANGELOG.md
@@ -1,5 +1,82 @@
# @spree/dashboard-core
+## 1.0.0
+
+### Major Changes
+
+- [#14458](https://github.com/spree/spree/pull/14458) [`da49f27`](https://github.com/spree/spree/commit/da49f27a5da1e40dbd4ce0901f8d4b21573d98df) Thanks [@mad-eel](https://github.com/mad-eel)! - Renamed stock items to stock levels.
+
+ Spree 6.0 renames `Spree::StockItem` to `Spree::StockLevel`, and the admin API and SDK follow. There is no compatibility shim on the client side, so update your code before upgrading:
+
+ - `client.stockItems` is now `client.stockLevels`, and it calls `/stock_levels` instead of `/stock_items`.
+ - The `StockItem` type is now `StockLevel`, and `StockItemUpdateParams` is now `StockLevelUpdateParams`.
+ - `StockLevelUpdateParams` also gains `reason`, which labels a count correction in the stock history.
+ - `client.stockMovements` is new, and reads the typed stock history behind those levels.
+ - A variant's `stock_items` array is now `stock_levels`, on both reads and writes.
+ - `Subject.StockItem` is now `Subject.StockLevel` in `@spree/dashboard-core`. The old name stays as a deprecated alias for one release.
+ - Prefixed ids change from `si_…` to `sl_…`. Ids you stored earlier no longer resolve.
+
+ Webhook endpoints keep working: Spree publishes both `stock_level.*` and the older `stock_item.*` events for one release, so existing subscriptions keep firing. The dashboard's event picker now offers the `stock_level` names, and shows any `stock_item` subscription you already have under its Custom section. Move your subscriptions over before Spree 6.1, when the old names stop being published.
+
+### Minor Changes
+
+- [#14410](https://github.com/spree/spree/pull/14410) [`fdd88eb`](https://github.com/spree/spree/commit/fdd88eb3d2d7ac36a710a2af38593a8f4c83f2bf) Thanks [@mad-eel](https://github.com/mad-eel)! - Add dashboard pages for business customers and tax configuration.
+
+ Companies get a list and a detail page with their branches, tax registration
+ and exemption certificates; a branch has its own page listing the buyers
+ authorised to purchase for it. Customers gain the same tax registration panel
+ on their profile. Tax rates get a settings page, and a market can now name the
+ tax engine that prices it — showing what that engine cannot handle, so a
+ merchant learns about a gap while configuring rather than from a tax bill.
+
+ The admin SDK gains the customer tax-identifier endpoints and `tax_provider`
+ on market params.
+
+- [#14591](https://github.com/spree/spree/pull/14591) [`8e5dc20`](https://github.com/spree/spree/commit/8e5dc20147ff24f53dd73b506c3f06a074d3d302) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Volume pricing: quantity breaks, percentage tiers and a price-list CSV.
+
+ A price list can now carry a ladder per variant — a unit price from each
+ quantity up — edited as tier rows in the price spreadsheet, and a catalog's
+ percentage adjustment can step by quantity too. The catalog's price column
+ shows how many tiers a variant carries, with the ladder on hover and a note
+ that fixed tiers set the price regardless of the percentage.
+
+ A price list's prices can be exported and imported as CSV, one rung per row
+ keyed by SKU, from the list's own page and from the catalog that owns it.
+ The import merges: rows in the file are written, a blank price removes that
+ rung, and rungs the file does not mention are left alone. The admin SDK's
+ price, price list and import types carry the new fields, and the import
+ create call accepts the price list to merge into.
+
+### Patch Changes
+
+- [#14521](https://github.com/spree/spree/pull/14521) [`9cee487`](https://github.com/spree/spree/commit/9cee487fdce34c5f2ec873fc1d965196bd716663) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - New address forms pre-select the store's default country.
+
+ The Admin store payload now includes `default_country_code` (the same country the default market already answers). The shared address dialog uses it for new records and leaves an existing address's country alone.
+
+- [#14632](https://github.com/spree/spree/pull/14632) [`67594a5`](https://github.com/spree/spree/commit/67594a56921fbc5d584b371ede94b0b83f2035ea) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Country pickers load the country list once per page and reuse it.
+
+ The list is reference data and does not change at runtime, so later address fields and country selects no longer call the API again.
+
+- [#14413](https://github.com/spree/spree/pull/14413) [`99573b0`](https://github.com/spree/spree/commit/99573b0c717225e652e6d449b4b85f1e10f3600b) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Edit the admin profile in a dialog opened from the user menu instead of a settings page. The `/settings/profile` route is removed; `TopBar` takes an `onEditProfile` handler and hides the menu item when none is supplied.
+
+- [#14456](https://github.com/spree/spree/pull/14456) [`3a1ac28`](https://github.com/spree/spree/commit/3a1ac2851a59cf0e498af27a60e70caac3a5788e) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Fix an endless reload when a store sets a non-English admin language.
+
+ i18next was initialized with the stored language but only the English bundle, so it resolved the language to the fallback and reported English no matter what was stored. The store-default reconciler compares those two values to decide whether the page needs reloading, saw a permanent mismatch, and reloaded on every boot — each reload rotating a refresh token until the API's rate limit stopped it.
+
+ Every bundle is now registered when i18next starts, so the stored language resolves to itself and the reconciler reloads only when the language genuinely changes.
+
+- [#14378](https://github.com/spree/spree/pull/14378) [`027ed08`](https://github.com/spree/spree/commit/027ed08056df9608554c80e343cdf24d6699d9f5) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Redesign the user dropdown's theme and language controls into a compact "Preferences" section: theme is now a segmented control (System / Light / Dark) and language is a select-style pill.
+
+- [#14637](https://github.com/spree/spree/pull/14637) [`9b8a7d5`](https://github.com/spree/spree/commit/9b8a7d57967ec31659959547555dde6780e8ef10) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Keep list and quote toolbar buttons working after the TipTap 3.31 pin. Two copies of prosemirror-model made wrap throw; pinning one version (and deduping it in the Vite plugin) restores the stock TipTap commands. Enter still persists as its own paragraph.
+
+- [#14635](https://github.com/spree/spree/pull/14635) [`496431d`](https://github.com/spree/spree/commit/496431d8e902269b8a5b05c9f2393eafc7e6b78b) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Added a settings overview page to the seller panel, matching the operator dashboard's card grid of reachable settings areas.
+
+- [#14514](https://github.com/spree/spree/pull/14514) [`3473696`](https://github.com/spree/spree/commit/3473696bb08408addca8ef4665748c694b64b6d1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Fix the filter panel crashing in the seller panel. `TableToolbar`, `ResourceCombobox` and `MediaPickerSheet` required a `StoreProvider` to scope their query keys, so opening a filter panel in a panel that has no store — the seller panel, whose tenant is a seller — threw "useStore must be used within a StoreProvider". They now scope by tenant, which is the store in the operator's dashboard and the seller in the seller panel, so cached results can no longer be shared between two sellers of the same store either.
+
+- [#14594](https://github.com/spree/spree/pull/14594) [`4156d50`](https://github.com/spree/spree/commit/4156d50a142497858377e3159a1c2c28182cb978) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Stop the translations editor marking itself dirty on open, and refresh the translations page after a save or a catalog edit.
+
+ The rich-text cell was treating TipTap's mount-time paragraph wrap as an unsaved change against descriptions stored as plain text. Translation queries now share one cache prefix so saving a translation, editing the source record, or importing a translations CSV invalidates the coverage grid instead of leaving it stale.
+
## 0.13.1
### Patch Changes
diff --git a/packages/dashboard-core/package.json b/packages/dashboard-core/package.json
index b891ba6943..59654f440e 100644
--- a/packages/dashboard-core/package.json
+++ b/packages/dashboard-core/package.json
@@ -1,8 +1,8 @@
{
"name": "@spree/dashboard-core",
"license": "MIT",
- "version": "0.13.1",
- "description": "Spree Dashboard framework \u2014 registries (table, nav, slot, settings-nav), providers (auth, permission, store), admin SDK client, generic infra hooks, and the defineDashboardPlugin extension API. Developer Preview.",
+ "version": "1.0.0-beta.1",
+ "description": "Spree Dashboard framework — registries (table, nav, slot, settings-nav), providers (auth, permission, store), admin SDK client, generic infra hooks, and the defineDashboardPlugin extension API. Developer Preview.",
"author": "Vendo Connect Inc.",
"homepage": "https://spreecommerce.org",
"repository": {
@@ -57,8 +57,8 @@
},
"peerDependencies": {
"@hookform/resolvers": "^5.2.2",
- "@spree/admin-sdk": ">=0.7.0 <2",
- "@spree/dashboard-ui": ">=0.10.0 <2",
+ "@spree/admin-sdk": ">=0.7.0 <1.0.0-0 || >=1.0.0-0 <2.0.0-0",
+ "@spree/dashboard-ui": ">=0.10.0 <1.0.0-0 || >=1.0.0-0 <2.0.0-0",
"@tanstack/react-hotkeys": "^0.10.0",
"@tanstack/react-query": "^5.100.9",
"@tanstack/react-router": "^1.169.2",
diff --git a/packages/dashboard-starter/README.md b/packages/dashboard-starter/README.md
index 7c0e69ed9a..c1741a2964 100644
--- a/packages/dashboard-starter/README.md
+++ b/packages/dashboard-starter/README.md
@@ -2,7 +2,7 @@
The host app for the [Spree React Dashboard](https://spreecommerce.org/docs/developer/dashboard/overview) — the admin for your Spree store. `@spree/dashboard` is the actual app shell (routes, chrome, resource pages); this project is your customization point: plugins, your own pages, theming, and deployment config.
-> **Monorepo note.** The canonical source of this template lives at `packages/dashboard-starter` in [spree/spree](https://github.com/spree/spree), where its Spree dependencies resolve via the pnpm workspace and `@spree/dashboard-plugin-example` is installed as a devDependency — booting it here doubles as the end-to-end test for the plugin pipeline. At build time, `@spree/cli` and `create-spree-app` embed a standalone rendering of it (workspace deps rewritten to the published versions — see `scripts/sync-dashboard-starter.mjs`), which is what `spree add dashboard` and the create-spree-app dashboard prompt scaffold from.
+> **Monorepo note.** The canonical source of this template lives at `packages/dashboard-starter` in [spree/spree](https://github.com/spree/spree), where its Spree dependencies resolve via the pnpm workspace and `@spree/dashboard-plugin-example` is installed as a devDependency — booting it here doubles as the end-to-end test for the plugin pipeline. At build time, `@spree/cli` and `create-spree-app` embed a standalone rendering of it (workspace deps rewritten to the published versions — see `scripts/sync-starter.mjs`), which is what `spree add dashboard` and the create-spree-app dashboard prompt scaffold from.
## Develop
diff --git a/packages/dashboard-ui/CHANGELOG.md b/packages/dashboard-ui/CHANGELOG.md
index fbdfc4635c..8d6d5260ac 100644
--- a/packages/dashboard-ui/CHANGELOG.md
+++ b/packages/dashboard-ui/CHANGELOG.md
@@ -1,5 +1,58 @@
# @spree/dashboard-ui
+## 1.0.0
+
+### Minor Changes
+
+- [#14410](https://github.com/spree/spree/pull/14410) [`fdd88eb`](https://github.com/spree/spree/commit/fdd88eb3d2d7ac36a710a2af38593a8f4c83f2bf) Thanks [@mad-eel](https://github.com/mad-eel)! - Add dashboard pages for business customers and tax configuration.
+
+ Companies get a list and a detail page with their branches, tax registration
+ and exemption certificates; a branch has its own page listing the buyers
+ authorised to purchase for it. Customers gain the same tax registration panel
+ on their profile. Tax rates get a settings page, and a market can now name the
+ tax engine that prices it — showing what that engine cannot handle, so a
+ merchant learns about a gap while configuring rather than from a tax bill.
+
+ The admin SDK gains the customer tax-identifier endpoints and `tax_provider`
+ on market params.
+
+- [#14591](https://github.com/spree/spree/pull/14591) [`8e5dc20`](https://github.com/spree/spree/commit/8e5dc20147ff24f53dd73b506c3f06a074d3d302) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Volume pricing: quantity breaks, percentage tiers and a price-list CSV.
+
+ A price list can now carry a ladder per variant — a unit price from each
+ quantity up — edited as tier rows in the price spreadsheet, and a catalog's
+ percentage adjustment can step by quantity too. The catalog's price column
+ shows how many tiers a variant carries, with the ladder on hover and a note
+ that fixed tiers set the price regardless of the percentage.
+
+ A price list's prices can be exported and imported as CSV, one rung per row
+ keyed by SKU, from the list's own page and from the catalog that owns it.
+ The import merges: rows in the file are written, a blank price removes that
+ rung, and rungs the file does not mention are left alone. The admin SDK's
+ price, price list and import types carry the new fields, and the import
+ create call accepts the price list to merge into.
+
+### Patch Changes
+
+- [#14633](https://github.com/spree/spree/pull/14633) [`c0f6ccd`](https://github.com/spree/spree/commit/c0f6ccd1c5e9df5d1dbb93d1aff9e4180d3979ea) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Fix the dashboard date range picker remembering "Last 30 days" after another preset is chosen.
+
+ The trigger label lived in local state that reset whenever analytics refetch replaced the page. It now follows the selected dates, so Last 90 days stays selected after the figures update.
+
+- [#14378](https://github.com/spree/spree/pull/14378) [`027ed08`](https://github.com/spree/spree/commit/027ed08056df9608554c80e343cdf24d6699d9f5) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Redesign the user dropdown's theme and language controls into a compact "Preferences" section: theme is now a segmented control (System / Light / Dark) and language is a select-style pill.
+
+- [#14429](https://github.com/spree/spree/pull/14429) [`226557b`](https://github.com/spree/spree/commit/226557b21cc0870ee3803cdc617a2735311d9d9f) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Align status badge colours with the Geist colour system: each of the success, warning, destructive and info variants now pairs a tint with a matching reading colour from the same hue, in both light and dark themes, and every variant meets WCAG AA against its own fill. Fixes a `warning` badge that changed colour entirely on hover, and an outline badge whose border never rendered.
+
+- [#14502](https://github.com/spree/spree/pull/14502) [`eb59f05`](https://github.com/spree/spree/commit/eb59f05f18dc98b62413ca80cc0061dfafd08ef7) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Declare the dependencies behind `styles.css` imports: `tailwindcss` as a peer (plus dev) dependency and `shadcn` as a regular dependency. Previously both were undeclared for consumers, so `@import "tailwindcss"` and `@import "shadcn/tailwind.css"` only resolved when pnpm's on-disk layout happened to allow it, failing with `Cannot apply unknown utility class` otherwise.
+
+- [#14631](https://github.com/spree/spree/pull/14631) [`38207ce`](https://github.com/spree/spree/commit/38207ceca55aaa1ac7606a2aca3098c441c77758) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Hide the pagination footer when a list has no rows, so empty tables no longer show "0–0 of 0" or a rows-per-page control.
+
+- [#14637](https://github.com/spree/spree/pull/14637) [`9b8a7d5`](https://github.com/spree/spree/commit/9b8a7d57967ec31659959547555dde6780e8ef10) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Keep list and quote toolbar buttons working after the TipTap 3.31 pin. Two copies of prosemirror-model made wrap throw; pinning one version (and deduping it in the Vite plugin) restores the stock TipTap commands. Enter still persists as its own paragraph.
+
+- [#14532](https://github.com/spree/spree/pull/14532) [`be76364`](https://github.com/spree/spree/commit/be76364d999fcffeeedd8f980da1a581db62f4a1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Stop the admin sidebar's Cmd/Ctrl+B shortcut from firing while typing, and restore list, quote and link styling plus live toolbar states in the rich-text editor.
+
+- [#14594](https://github.com/spree/spree/pull/14594) [`4156d50`](https://github.com/spree/spree/commit/4156d50a142497858377e3159a1c2c28182cb978) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Stop the translations editor marking itself dirty on open, and refresh the translations page after a save or a catalog edit.
+
+ The rich-text cell was treating TipTap's mount-time paragraph wrap as an unsaved change against descriptions stored as plain text. Translation queries now share one cache prefix so saving a translation, editing the source record, or importing a translations CSV invalidates the coverage grid instead of leaving it stale.
+
## 0.13.1
## 0.13.0
diff --git a/packages/dashboard-ui/package.json b/packages/dashboard-ui/package.json
index f08e9c87d9..9e60972efa 100644
--- a/packages/dashboard-ui/package.json
+++ b/packages/dashboard-ui/package.json
@@ -1,8 +1,8 @@
{
"name": "@spree/dashboard-ui",
"license": "MIT",
- "version": "0.13.1",
- "description": "Spree Dashboard design system \u2014 shadcn primitives, headless composed components, and design tokens. Source-only package; consumers compile via their own Vite/Tailwind setup. Developer Preview.",
+ "version": "1.0.0-beta.1",
+ "description": "Spree Dashboard design system — shadcn primitives, headless composed components, and design tokens. Source-only package; consumers compile via their own Vite/Tailwind setup. Developer Preview.",
"author": "Vendo Connect Inc.",
"homepage": "https://spreecommerce.org",
"repository": {
diff --git a/packages/dashboard/CHANGELOG.md b/packages/dashboard/CHANGELOG.md
index 1fa60ea87d..5c284cf46e 100644
--- a/packages/dashboard/CHANGELOG.md
+++ b/packages/dashboard/CHANGELOG.md
@@ -1,5 +1,123 @@
# @spree/dashboard
+## 1.0.0
+
+### Major Changes
+
+- [#14458](https://github.com/spree/spree/pull/14458) [`da49f27`](https://github.com/spree/spree/commit/da49f27a5da1e40dbd4ce0901f8d4b21573d98df) Thanks [@mad-eel](https://github.com/mad-eel)! - Renamed stock items to stock levels.
+
+ Spree 6.0 renames `Spree::StockItem` to `Spree::StockLevel`, and the admin API and SDK follow. There is no compatibility shim on the client side, so update your code before upgrading:
+
+ - `client.stockItems` is now `client.stockLevels`, and it calls `/stock_levels` instead of `/stock_items`.
+ - The `StockItem` type is now `StockLevel`, and `StockItemUpdateParams` is now `StockLevelUpdateParams`.
+ - `StockLevelUpdateParams` also gains `reason`, which labels a count correction in the stock history.
+ - `client.stockMovements` is new, and reads the typed stock history behind those levels.
+ - A variant's `stock_items` array is now `stock_levels`, on both reads and writes.
+ - `Subject.StockItem` is now `Subject.StockLevel` in `@spree/dashboard-core`. The old name stays as a deprecated alias for one release.
+ - Prefixed ids change from `si_…` to `sl_…`. Ids you stored earlier no longer resolve.
+
+ Webhook endpoints keep working: Spree publishes both `stock_level.*` and the older `stock_item.*` events for one release, so existing subscriptions keep firing. The dashboard's event picker now offers the `stock_level` names, and shows any `stock_item` subscription you already have under its Custom section. Move your subscriptions over before Spree 6.1, when the old names stop being published.
+
+### Minor Changes
+
+- [#14410](https://github.com/spree/spree/pull/14410) [`fdd88eb`](https://github.com/spree/spree/commit/fdd88eb3d2d7ac36a710a2af38593a8f4c83f2bf) Thanks [@mad-eel](https://github.com/mad-eel)! - Add dashboard pages for business customers and tax configuration.
+
+ Companies get a list and a detail page with their branches, tax registration
+ and exemption certificates; a branch has its own page listing the buyers
+ authorised to purchase for it. Customers gain the same tax registration panel
+ on their profile. Tax rates get a settings page, and a market can now name the
+ tax engine that prices it — showing what that engine cannot handle, so a
+ merchant learns about a gap while configuring rather than from a tax bill.
+
+ The admin SDK gains the customer tax-identifier endpoints and `tax_provider`
+ on market params.
+
+- [#14430](https://github.com/spree/spree/pull/14430) [`9a4eb46`](https://github.com/spree/spree/commit/9a4eb466c2698d15d735c06e4b5faf984bb63dd2) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Order numbers are now configurable from the dashboard.
+
+ **Settings → Store → Order numbers** controls how document numbers are shaped: the numbering format (sequential or random), the order number prefix and suffix, and the value the sequence starts at. A live preview shows what the next number will look like.
+
+ Sequential numbering is the new default — orders count up from 1001 (`R1001`, `R1002`) instead of carrying nine random digits. Merchants who would rather not disclose their order volume can switch the format back to random. Either way, changes apply to future orders only; numbers already issued never change.
+
+ `StoreUpdateParams` and the `Store` type gain `preferred_document_number_format`, `preferred_order_number_prefix`, `preferred_order_number_suffix` and `preferred_order_number_sequence_start`.
+
+- [#14489](https://github.com/spree/spree/pull/14489) [`889a8cf`](https://github.com/spree/spree/commit/889a8cfd24443710cfff5a7d30fbe83d65148cac) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Media library. Every image and video in a store now lives in one place under Products → Media: browse it, search by file name, filter by type or by whether a file is in use, and upload files before deciding where they go. Picking a file from the library reuses it rather than copying it, so the same photo on three products is one file in storage.
+
+ The library is reachable from everywhere media is set. The product gallery gains "Add from library", category, collection and seller image fields gain "Choose from library", and the rich text editor can embed an image in a description for the first time. Category and collection images now appear in the library too, so a file uploaded there can be reused anywhere else.
+
+ Every file shows where it is used before it is deleted, and deleting one that is still in use removes it from those places once the merchant confirms.
+
+ New in `@spree/admin-sdk`: the `media` resource (`list`, `get`, `create`, `update`, `delete`, `usage`), `source_media_id` on product media creation for reuse, and `signed_id`, `embed_url`, `filename`, `content_type`, `byte_size` and `attached` on the admin media payload.
+
+- [#14591](https://github.com/spree/spree/pull/14591) [`8e5dc20`](https://github.com/spree/spree/commit/8e5dc20147ff24f53dd73b506c3f06a074d3d302) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Volume pricing: quantity breaks, percentage tiers and a price-list CSV.
+
+ A price list can now carry a ladder per variant — a unit price from each
+ quantity up — edited as tier rows in the price spreadsheet, and a catalog's
+ percentage adjustment can step by quantity too. The catalog's price column
+ shows how many tiers a variant carries, with the ladder on hover and a note
+ that fixed tiers set the price regardless of the percentage.
+
+ A price list's prices can be exported and imported as CSV, one rung per row
+ keyed by SKU, from the list's own page and from the catalog that owns it.
+ The import merges: rows in the file are written, a blank price removes that
+ rung, and rungs the file does not mention are left alone. The admin SDK's
+ price, price list and import types carry the new fields, and the import
+ create call accepts the price list to merge into.
+
+- [#14457](https://github.com/spree/spree/pull/14457) [`676aa0d`](https://github.com/spree/spree/commit/676aa0dee62a26944cb0a2c83273b149ba922b8a) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Product galleries can hold video.
+
+ A media item now says what it is through `media_type`. `video` is a file you upload and serve yourself; `external_video` is a YouTube or Vimeo link. Both sit in the same gallery as images and reorder alongside them.
+
+ Spree reads the link when it is saved and rejects anything it cannot embed, so the media object comes back carrying `video_provider`, `video_embed_url`, `video_url` and `poster_url` — a storefront embeds a video without parsing links itself. A video's sized URLs resolve to its poster, so a gallery written for images still renders the right still.
+
+ `MediaCreateParams` and `MediaUpdateParams` accept `media_type`, `external_video_url`, `poster_signed_id` and the focal point. The `type` parameter, which named an internal Ruby class, is gone — `media_type` replaces it.
+
+ A video carries a **poster** — the still shown before it plays. Upload one with `poster_signed_id`, or leave it off and a YouTube link falls back to the provider's own image. Spree does not extract a frame from an uploaded file, so hosted video and Vimeo links want a poster.
+
+ In the dashboard, video files upload through the same drop zone as images, an "Add video link" button takes a YouTube or Vimeo URL, and the media editor plays the video back and takes a poster the merchant uploads. The editor also gains a focal-point picker: click the spot on an image that must stay in frame when a storefront crops it.
+
+ Choosing which variants a media item represents happens in one place — the media editor on the product. The unmounted variant-side gallery picker has been removed; it was a second way to edit the same thing.
+
+- [#14462](https://github.com/spree/spree/pull/14462) [`abc6e22`](https://github.com/spree/spree/commit/abc6e22cb60ea305a83583ded0b999458b2c9cbd) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Which address a sale's tax is computed from is now a store setting rather than a global one. `preferred_tax_using_ship_address` can be read and written through the Admin API, and merchants can change it under Settings → Store in the Payments card. The default is unchanged: tax follows the shipping address.
+
+### Patch Changes
+
+- [#14633](https://github.com/spree/spree/pull/14633) [`c0f6ccd`](https://github.com/spree/spree/commit/c0f6ccd1c5e9df5d1dbb93d1aff9e4180d3979ea) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Fix the dashboard date range picker remembering "Last 30 days" after another preset is chosen.
+
+ The trigger label lived in local state that reset whenever analytics refetch replaced the page. It now follows the selected dates, so Last 90 days stays selected after the figures update.
+
+- [#14413](https://github.com/spree/spree/pull/14413) [`99573b0`](https://github.com/spree/spree/commit/99573b0c717225e652e6d449b4b85f1e10f3600b) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Edit the admin profile in a dialog opened from the user menu instead of a settings page. The `/settings/profile` route is removed; `TopBar` takes an `onEditProfile` handler and hides the menu item when none is supplied.
+
+- [#14429](https://github.com/spree/spree/pull/14429) [`226557b`](https://github.com/spree/spree/commit/226557b21cc0870ee3803cdc617a2735311d9d9f) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Align status badge colours with the Geist colour system: each of the success, warning, destructive and info variants now pairs a tint with a matching reading colour from the same hue, in both light and dark themes, and every variant meets WCAG AA against its own fill. Fixes a `warning` badge that changed colour entirely on hover, and an outline badge whose border never rendered.
+
+- [#14637](https://github.com/spree/spree/pull/14637) [`9b8a7d5`](https://github.com/spree/spree/commit/9b8a7d57967ec31659959547555dde6780e8ef10) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Keep list and quote toolbar buttons working after the TipTap 3.31 pin. Two copies of prosemirror-model made wrap throw; pinning one version (and deduping it in the Vite plugin) restores the stock TipTap commands. Enter still persists as its own paragraph.
+
+- [#14532](https://github.com/spree/spree/pull/14532) [`be76364`](https://github.com/spree/spree/commit/be76364d999fcffeeedd8f980da1a581db62f4a1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Stop the admin sidebar's Cmd/Ctrl+B shortcut from firing while typing, and restore list, quote and link styling plus live toolbar states in the rich-text editor.
+
+- [#14376](https://github.com/spree/spree/pull/14376) [`a52a6da`](https://github.com/spree/spree/commit/a52a6da42f5c456e889f8bba12ee7194934289b1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Dashboard features from the 6.0 core rewrite:
+
+ - Delivery method editor: Conditions section (eligibility rules), pickup stock-location picker, calculator preferences through the shared preferences form.
+ - Order page: discount code card (apply a typed code or pick a coupon promotion; pending codes show when they'll take effect) and a live computed-amount preview for percent manual discounts.
+ - Webhook endpoint event catalog lists `order.placed`; delivery zones request members via `expand`.
+
+- [#14461](https://github.com/spree/spree/pull/14461) [`32d4db9`](https://github.com/spree/spree/commit/32d4db9cdb027d9fb59e18807b26c0aa6ceb48ad) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Store credits no longer carry a category. `client.storeCreditCategories` and the `StoreCreditCategory` type are removed, `category_id` is no longer accepted or returned on customer store credits, and the dashboard's issue/edit store credit dialogs drop the category picker — the memo is the place to record why a credit was issued.
+
+- [#14530](https://github.com/spree/spree/pull/14530) [`5d3520d`](https://github.com/spree/spree/commit/5d3520d800a1dbd6f07bb212eb41247ad375432c) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Show why an order tax line is zero.
+
+ The Taxes card now names the treatment (buyer exempt, zero-rated, and the
+ other recorded reasons) and, when the buyer is exempt, the certificate that
+ made it so. A completed order with no matching rate says so instead of
+ looking like a draft that has not been taxed yet, and the Summary card keeps
+ its tax row at zero so an exempt sale is still visible there.
+
+- [#14594](https://github.com/spree/spree/pull/14594) [`4156d50`](https://github.com/spree/spree/commit/4156d50a142497858377e3159a1c2c28182cb978) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Stop the translations editor marking itself dirty on open, and refresh the translations page after a save or a catalog edit.
+
+ The rich-text cell was treating TipTap's mount-time paragraph wrap as an unsaved change against descriptions stored as plain text. Translation queries now share one cache prefix so saving a translation, editing the source record, or importing a translations CSV invalidates the coverage grid instead of leaving it stale.
+
+- Updated dependencies [[`9cee487`](https://github.com/spree/spree/commit/9cee487fdce34c5f2ec873fc1d965196bd716663), [`4df88ac`](https://github.com/spree/spree/commit/4df88ac684688e65623703544686c6043a8ed816), [`6d4fe64`](https://github.com/spree/spree/commit/6d4fe64a1444bc42338942025a4ed1d5788cb9d7), [`67594a5`](https://github.com/spree/spree/commit/67594a56921fbc5d584b371ede94b0b83f2035ea), [`a8b11ec`](https://github.com/spree/spree/commit/a8b11ecb409a04c8d48ec6d64892ffa3bd6dacf7), [`fdd88eb`](https://github.com/spree/spree/commit/fdd88eb3d2d7ac36a710a2af38593a8f4c83f2bf), [`c0f6ccd`](https://github.com/spree/spree/commit/c0f6ccd1c5e9df5d1dbb93d1aff9e4180d3979ea), [`99573b0`](https://github.com/spree/spree/commit/99573b0c717225e652e6d449b4b85f1e10f3600b), [`3a1ac28`](https://github.com/spree/spree/commit/3a1ac2851a59cf0e498af27a60e70caac3a5788e), [`027ed08`](https://github.com/spree/spree/commit/027ed08056df9608554c80e343cdf24d6699d9f5), [`226557b`](https://github.com/spree/spree/commit/226557b21cc0870ee3803cdc617a2735311d9d9f), [`eb59f05`](https://github.com/spree/spree/commit/eb59f05f18dc98b62413ca80cc0061dfafd08ef7), [`9a4eb46`](https://github.com/spree/spree/commit/9a4eb466c2698d15d735c06e4b5faf984bb63dd2), [`38207ce`](https://github.com/spree/spree/commit/38207ceca55aaa1ac7606a2aca3098c441c77758), [`889a8cf`](https://github.com/spree/spree/commit/889a8cfd24443710cfff5a7d30fbe83d65148cac), [`8e5dc20`](https://github.com/spree/spree/commit/8e5dc20147ff24f53dd73b506c3f06a074d3d302), [`676aa0d`](https://github.com/spree/spree/commit/676aa0dee62a26944cb0a2c83273b149ba922b8a), [`9b8a7d5`](https://github.com/spree/spree/commit/9b8a7d57967ec31659959547555dde6780e8ef10), [`be76364`](https://github.com/spree/spree/commit/be76364d999fcffeeedd8f980da1a581db62f4a1), [`7e35951`](https://github.com/spree/spree/commit/7e35951361a6cee7b735640b0228710928719fee), [`496431d`](https://github.com/spree/spree/commit/496431d8e902269b8a5b05c9f2393eafc7e6b78b), [`a52a6da`](https://github.com/spree/spree/commit/a52a6da42f5c456e889f8bba12ee7194934289b1), [`0f22450`](https://github.com/spree/spree/commit/0f224508b3d270aaa9899a508966a27c37f873ed), [`da49f27`](https://github.com/spree/spree/commit/da49f27a5da1e40dbd4ce0901f8d4b21573d98df), [`32d4db9`](https://github.com/spree/spree/commit/32d4db9cdb027d9fb59e18807b26c0aa6ceb48ad), [`abc6e22`](https://github.com/spree/spree/commit/abc6e22cb60ea305a83583ded0b999458b2c9cbd), [`3473696`](https://github.com/spree/spree/commit/3473696bb08408addca8ef4665748c694b64b6d1), [`4156d50`](https://github.com/spree/spree/commit/4156d50a142497858377e3159a1c2c28182cb978)]:
+
## 0.13.1
### Patch Changes
diff --git a/packages/dashboard/package.json b/packages/dashboard/package.json
index 1a07aa6549..ebfba71113 100644
--- a/packages/dashboard/package.json
+++ b/packages/dashboard/package.json
@@ -1,8 +1,8 @@
{
"name": "@spree/dashboard",
"license": "MIT",
- "version": "0.13.1",
- "description": "Spree Dashboard app shell \u2014 the next-gen React admin for Spree Commerce. Routes, resource hooks, schemas, locales, and the <Dashboard /> component. Source-only package; hosts compile it via @spree/dashboard/vite. Developer Preview.",
+ "version": "1.0.0-beta.1",
+ "description": "Spree Dashboard app shell — the next-gen React admin for Spree Commerce. Routes, resource hooks, schemas, locales, and the <Dashboard /> component. Source-only package; hosts compile it via @spree/dashboard/vite. Developer Preview.",
"author": "Vendo Connect Inc.",
"homepage": "https://spreecommerce.org",
"repository": {
diff --git a/packages/sdk/CHANGELOG.md b/packages/sdk/CHANGELOG.md
index 79591cf323..aebe6fde5b 100644
--- a/packages/sdk/CHANGELOG.md
+++ b/packages/sdk/CHANGELOG.md
@@ -1,5 +1,43 @@
# @spree/sdk
+## 2.0.0
+
+### Major Changes
+
+- [#14442](https://github.com/spree/spree/pull/14442) [`4df88ac`](https://github.com/spree/spree/commit/4df88ac684688e65623703544686c6043a8ed816) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Rename the geography fields to `country_code` and `state_code` across the v3 API, replacing `country_iso` and `state_abbr`. Addresses, stock locations, delivery zone members, markets, tax rates and tax exemption certificates all use the new names, on read and on write. Markets rename their list of countries from `country_isos` to `country_codes`.
+
+ Addresses keep `country_iso` and `state_abbr` as deprecated read fields and accepted write names for one release, so existing storefronts keep working; both are removed in 6.1. Every other resource moves outright.
+
+- [#14376](https://github.com/spree/spree/pull/14376) [`a52a6da`](https://github.com/spree/spree/commit/a52a6da42f5c456e889f8bba12ee7194934289b1) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Spree 6.0 Store API line. Breaking changes for storefront integrations:
+
+ - Completed carts are no longer served by the cart endpoints — fetching one returns 404, the signal to drop stale cart state. The checkout outcome stays reachable through `orders.get(cartId)` authorized by the cart token (the order inherits it).
+ - `DeliveryZone.members` is only embedded when requested with `expand=members` (the type is now optional).
+ - The placement webhook event is `order.placed`; `order.completed` is still dual-emitted through 6.0 with `deprecated_alias_of` metadata and drops in 6.1.
+
+ Additions: `coupon_code` on Cart and Order (with pending-code semantics — a real but not-yet-eligible code is kept and applies once the cart qualifies), `cart_id` on Order for matching cart activity to its conversion, and `cart.created` / `cart.updated` / `cart.deleted` webhook events for abandonment tooling.
+
+### Minor Changes
+
+- [#14394](https://github.com/spree/spree/pull/14394) [`a8b11ec`](https://github.com/spree/spree/commit/a8b11ecb409a04c8d48ec6d64892ffa3bd6dacf7) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Collections reach both SDKs.
+
+ `@spree/sdk` (storefront):
+
+ - `collections.list()` / `collections.get(idOrPermalink)` — the flat, merchandising-driven groupings ("Summer Sale", "New Arrivals"), whether membership is curated by hand or maintained from rules.
+ - `collections.products.list(idOrPermalink, params)` — a collection's product listing page. Takes the same filters and sorts as `products.list`, and when `sort` is omitted the collection's own `sort_order` applies, so a shopper sees the ordering the merchant chose (including their manual arrangement).
+ - `in_collection` on `ProductListParams`, for composing a collection filter into a wider product query.
+
+ `@spree/admin-sdk` (back office):
+
+ - `collections` CRUD, with reordering as a plain 1-based `position` on update rather than a separate action — collections are a flat list. Nested `collections.products` covers membership, ordering and `reposition`, plus custom fields and translations.
+ - `collectionRules.types()` enumerates the registered rule kinds, so a rule a plugin registers shows up without an SDK release.
+ - `products.bulkAddToCollections` / `bulkRemoveFromCollections`, and `collection_ids` on product create/update.
+ - `rules` on a collection is expand-gated (`?expand=rules`), matching `custom_fields` — a listing no longer ships every collection's full rule set.
+ - `hide_from_nav` is gone from the category params. Nothing read it.
+
+### Patch Changes
+
+- [#14593](https://github.com/spree/spree/pull/14593) [`0f22450`](https://github.com/spree/spree/commit/0f224508b3d270aaa9899a508966a27c37f873ed) Thanks [@Hemang-ai](https://github.com/Hemang-ai)! - Preserve HTTP error statuses when a server returns an empty, non-JSON, or malformed error body. Avoid treating these responses as network failures, and allow admin and seller session recovery to handle unauthorized responses.
+
## 1.2.1
### Patch Changes
diff --git a/packages/sdk/package.json b/packages/sdk/package.json
index 2ce65b995c..327e8ae1e5 100644
--- a/packages/sdk/package.json
+++ b/packages/sdk/package.json
@@ -1,6 +1,6 @@
{
"name": "@spree/sdk",
- "version": "1.2.1",
+ "version": "2.0.0-beta.1",
"description": "Official TypeScript SDK for Spree Commerce Store API",
"type": "module",
"main": "./dist/index.cjs",
diff --git a/packages/seller-dashboard/CHANGELOG.md b/packages/seller-dashboard/CHANGELOG.md
new file mode 100644
index 0000000000..bd0397abb3
--- /dev/null
+++ b/packages/seller-dashboard/CHANGELOG.md
@@ -0,0 +1,12 @@
+# @spree/seller-dashboard
+
+## 0.1.1
+
+### Patch Changes
+
+- [#14635](https://github.com/spree/spree/pull/14635) [`496431d`](https://github.com/spree/spree/commit/496431d8e902269b8a5b05c9f2393eafc7e6b78b) Thanks [@damianlegawiec](https://github.com/damianlegawiec)! - Added a settings overview page to the seller panel, matching the operator dashboard's card grid of reachable settings areas.
+
+- Updated dependencies [[`9cee487`](https://github.com/spree/spree/commit/9cee487fdce34c5f2ec873fc1d965196bd716663), [`67594a5`](https://github.com/spree/spree/commit/67594a56921fbc5d584b371ede94b0b83f2035ea), [`fdd88eb`](https://github.com/spree/spree/commit/fdd88eb3d2d7ac36a710a2af38593a8f4c83f2bf), [`c0f6ccd`](https://github.com/spree/spree/commit/c0f6ccd1c5e9df5d1dbb93d1aff9e4180d3979ea), [`99573b0`](https://github.com/spree/spree/commit/99573b0c717225e652e6d449b4b85f1e10f3600b), [`3a1ac28`](https://github.com/spree/spree/commit/3a1ac2851a59cf0e498af27a60e70caac3a5788e), [`027ed08`](https://github.com/spree/spree/commit/027ed08056df9608554c80e343cdf24d6699d9f5), [`226557b`](https://github.com/spree/spree/commit/226557b21cc0870ee3803cdc617a2735311d9d9f), [`eb59f05`](https://github.com/spree/spree/commit/eb59f05f18dc98b62413ca80cc0061dfafd08ef7), [`38207ce`](https://github.com/spree/spree/commit/38207ceca55aaa1ac7606a2aca3098c441c77758), [`8e5dc20`](https://github.com/spree/spree/commit/8e5dc20147ff24f53dd73b506c3f06a074d3d302), [`9b8a7d5`](https://github.com/spree/spree/commit/9b8a7d57967ec31659959547555dde6780e8ef10), [`be76364`](https://github.com/spree/spree/commit/be76364d999fcffeeedd8f980da1a581db62f4a1), [`496431d`](https://github.com/spree/spree/commit/496431d8e902269b8a5b05c9f2393eafc7e6b78b), [`0f22450`](https://github.com/spree/spree/commit/0f224508b3d270aaa9899a508966a27c37f873ed), [`da49f27`](https://github.com/spree/spree/commit/da49f27a5da1e40dbd4ce0901f8d4b21573d98df), [`3473696`](https://github.com/spree/spree/commit/3473696bb08408addca8ef4665748c694b64b6d1), [`4156d50`](https://github.com/spree/spree/commit/4156d50a142497858377e3159a1c2c28182cb978)]:
diff --git a/packages/seller-dashboard/LICENSE b/packages/seller-dashboard/LICENSE
new file mode 100644
index 0000000000..fbaaca776c
--- /dev/null
+++ b/packages/seller-dashboard/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vendo Connect Inc., Vendo Sp. z o.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/packages/seller-dashboard/README.md b/packages/seller-dashboard/README.md
new file mode 100644
index 0000000000..9f1bcda3a7
--- /dev/null
+++ b/packages/seller-dashboard/README.md
@@ -0,0 +1,31 @@
+# @spree/seller-dashboard
+
+The React seller panel for [Spree Commerce](https://spreecommerce.org) marketplaces — the surface a seller signs into to manage their products, orders and fulfillments. Built on the [Seller API](https://spreecommerce.org/docs/api-reference/seller-api/introduction) via `@spree/seller-sdk`.
+
+> **Beta.** Published under the `beta` tag while Spree 6.0 is in beta, and
+> promoted to `latest` at 6.0 GA. Install it explicitly:
+>
+> ```bash
+> npm install @spree/seller-dashboard@beta
+> ```
+
+It shares its primitives with `@spree/dashboard` — components from `@spree/dashboard-ui`, framework pieces from `@spree/dashboard-core` — so the two panels stay visually and behaviourally consistent.
+
+## Usage
+
+Host it from a thin app that renders `<SellerDashboard />`. Scaffold one with:
+
+```bash
+npx spree add seller-dashboard
+```
+
+Rails serves the built bundle at `/sellers` when `SPREE_SELLER_PANEL_DIST_PATH` points at it — the Docker image built from the Spree starter does this for you.
+
+## Documentation
+
+- [Seller API reference](https://spreecommerce.org/docs/api-reference/seller-api/introduction) — the API this panel is built on
+- [Spree developer documentation](https://spreecommerce.org/docs)
+
+## License
+
+MIT
diff --git a/packages/seller-dashboard/package.json b/packages/seller-dashboard/package.json
index 333cce2d7b..7c93aa579c 100644
--- a/packages/seller-dashboard/package.json
+++ b/packages/seller-dashboard/package.json
@@ -1,9 +1,9 @@
{
"name": "@spree/seller-dashboard",
- "version": "0.1.0",
+ "version": "1.0.0-beta.1",
"license": "MIT",
"type": "module",
- "description": "Spree marketplace seller panel \u2014 the seller-facing counterpart to the admin dashboard.",
+ "description": "Spree marketplace seller panel — the seller-facing counterpart to the admin dashboard.",
"exports": {
".": "./src/index.ts",
"./styles.css": "./src/styles.css",
diff --git a/packages/seller-sdk/CHANGELOG.md b/packages/seller-sdk/CHANGELOG.md
new file mode 100644
index 0000000000..acded8a6a3
--- /dev/null
+++ b/packages/seller-sdk/CHANGELOG.md
@@ -0,0 +1,7 @@
+# @spree/seller-sdk
+
+## 0.1.1
+
+### Patch Changes
+
+- [#14593](https://github.com/spree/spree/pull/14593) [`0f22450`](https://github.com/spree/spree/commit/0f224508b3d270aaa9899a508966a27c37f873ed) Thanks [@Hemang-ai](https://github.com/Hemang-ai)! - Preserve HTTP error statuses when a server returns an empty, non-JSON, or malformed error body. Avoid treating these responses as network failures, and allow admin and seller session recovery to handle unauthorized responses.
diff --git a/packages/seller-sdk/LICENSE b/packages/seller-sdk/LICENSE
new file mode 100644
index 0000000000..fbaaca776c
--- /dev/null
+++ b/packages/seller-sdk/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vendo Connect Inc., Vendo Sp. z o.o.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/packages/seller-sdk/README.md b/packages/seller-sdk/README.md
new file mode 100644
index 0000000000..58e7f331bf
--- /dev/null
+++ b/packages/seller-sdk/README.md
@@ -0,0 +1,30 @@
+# @spree/seller-sdk
+
+TypeScript client for the [Spree Commerce](https://spreecommerce.org) Seller API — the marketplace branch used by sellers to manage their own products, orders, fulfillments and payouts.
+
+> **Beta.** Published under the `beta` tag while Spree 6.0 is in beta, and
+> promoted to `latest` at 6.0 GA. Install it explicitly:
+>
+> ```bash
+> npm install @spree/seller-sdk@beta
+> ```
+
+## Usage
+
+```ts
+import { createClient } from '@spree/seller-sdk'
+
+const client = createClient({ baseUrl: 'https://your-store.com' })
+const products = await client.products.list()
+```
+
+Sellers authenticate against the seller branch (`/seller/auth/*`), which issues its own token audience — a seller token is never an admin token.
+
+## Documentation
+
+- [Seller API reference](https://spreecommerce.org/docs/api-reference/seller-api/introduction) — endpoints, authentication, errors
+- [Spree developer documentation](https://spreecommerce.org/docs)
+
+## License
+
+MIT
diff --git a/packages/seller-sdk/package.json b/packages/seller-sdk/package.json
index 3b5d44e6ef..b4bb977571 100644
--- a/packages/seller-sdk/package.json
+++ b/packages/seller-sdk/package.json
@@ -1,6 +1,6 @@
{
"name": "@spree/seller-sdk",
- "version": "0.1.0",
+ "version": "1.0.0-beta.1",
"description": "TypeScript client for the Spree Seller API — the marketplace seller panel.",
"type": "module",
"main": "./dist/index.cjs",
diff --git a/scripts/sync-dashboard-starter.mjs b/scripts/sync-starter.mjs
similarity index 90%
rename from scripts/sync-dashboard-starter.mjs
rename to scripts/sync-starter.mjs
index 9ce4ad7ded..07fa9655cc 100644
--- a/scripts/sync-dashboard-starter.mjs
+++ b/scripts/sync-starter.mjs
@@ -20,17 +20,28 @@
// in sync. (A public template repo can reuse this script as a second target
// later.)
//
-// Usage: node scripts/sync-dashboard-starter.mjs <target-dir>
+// Usage: node scripts/sync-dashboard-starter.mjs <target-dir> [starter-package]
+//
+// `starter-package` names the directory under packages/ to render, defaulting
+// to dashboard-starter. The seller panel ships the same way from
+// seller-dashboard-starter, so the two share this script rather than drifting
+// apart in two near-identical copies.
import fs from 'node:fs'
import path from 'node:path'
import { fileURLToPath } from 'node:url'
const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
-const starterDir = path.join(repoRoot, 'packages', 'dashboard-starter')
const target = process.argv[2]
if (!target) {
- console.error('Usage: node scripts/sync-dashboard-starter.mjs <target-dir>')
+ console.error('Usage: node scripts/sync-dashboard-starter.mjs <target-dir> [starter-package]')
+ process.exit(2)
+}
+
+const starterPackage = process.argv[3] ?? 'dashboard-starter'
+const starterDir = path.join(repoRoot, 'packages', starterPackage)
+if (!fs.existsSync(path.join(starterDir, 'package.json'))) {
+ console.error(`No package.json under packages/${starterPackage} — is the name right?`)
process.exit(2)
}
const targetDir = path.resolve(target)