npm - @mercurjs/docs - Versions diffs - 2.2.1 → 2.3.0-canary.1 - Mend

@mercurjs/docs 2.2.1 → 2.3.0-canary.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (316) hide show

package/llms.txt CHANGED Viewed

@@ -7,14 +7,12 @@ package (`node_modules/@mercurjs/docs/`).
 ## Learn — concepts and getting started
-- [Overview](content/learn/architecture.mdx) — How Mercur is built — architecture, technology stack, and how the pieces fit together.
+- [Architecture](content/learn/architecture.mdx) — How the Mercur enterprise marketplace platform is built: its layers, building blocks, and how the pieces fit together.
 - [Product Attributes](content/learn/attributes.mdx) — Typed, filterable product attributes on top of Medusa's native product options — including variant axes shared across the catalog.
 - [Blocks](content/learn/blocks.mdx) — Self-contained pieces of marketplace functionality that get copied into your project as source code.
 - [Commission](content/learn/commissions.mdx) — How marketplace commissions work in Mercur — rates, rules, the matching algorithm, and commission lines.
-- [Concepts](content/learn/concepts.mdx) — Core concepts behind Mercur — from the Medusa foundation to blocks, panels, and the registry.
-- [Installation](content/learn/installation.mdx) — Install Mercur and set up your marketplace project.
-- [Introduction](content/learn/introduction.mdx) — Mercur is an open-source marketplace platform built on MedusaJS with a block-based architecture.
-- [Mercur - an open-source Mirakl alternative](content/learn/mirakl-alternative.mdx) — How Mercur compares to Mirakl and other marketplace platforms: open-source, self-hosted, no GMV fees, full code ownership.
+- [Overview](content/learn/introduction.mdx) — Set up Mercur, tour the operator and seller panels, and see how a multi-vendor order flows.
+- [Migration to 2.0](content/learn/migration-to-2-0.mdx) — Port an existing Mercur 1.x project to 2.x, the latest release.
 - [Offers](content/learn/offers.mdx) — An offer is a seller's sellable listing against a master product — their own SKU, price, inventory, and shipping.
 - [Order Groups](content/learn/order-groups.mdx) — How multi-seller checkout creates order groups — the container that ties a single cart to multiple seller orders.
 - [Payout](content/learn/payouts.mdx) — How seller payouts work in Mercur — accounts, onboarding, payment capture, and the transfer pipeline.
@@ -23,55 +21,44 @@ package (`node_modules/@mercurjs/docs/`).
 - [Registry](content/learn/registry.mdx) — Create, build, and host your own block registry.
 - [Seller Members](content/learn/seller-members.mdx) — Multi-user seller accounts — member data, team management, store switching, and access rules.
 - [Seller](content/learn/sellers.mdx) — The central marketplace actor — seller profile, lifecycle, registration flows, and business rules.
+- [Why Mercur](content/learn/why-mercur.mdx) — Why teams choose Mercur to run an enterprise marketplace: governance, ownership, and composability without a closed platform.
 ## Resources — tutorials, integrations, deployment
-- [LLMs](content/resources/ai/llms.mdx) — Feed Mercur documentation directly to LLMs for accurate, context-aware assistance.
 - [MCP Server](content/resources/ai/mcp.mdx) — Connect your AI environment to Mercur documentation via Model Context Protocol.
 - [Building with AI](content/resources/ai/overview.mdx) — Mercur ships version-matched docs inside your project so AI coding agents build from accurate APIs instead of stale training data.
-- [API routes](content/resources/best-practices/api-routes.mdx) — Thin HTTP adapters — typed request/response generics, Zod validation with createFindParams, filterable fields, middlewares as filters, and queryConfig.
-- [Custom fields](content/resources/best-practices/custom-fields.mdx) — The full loop — add a custom field in core, render it in the panels with defineCustomFieldsConfig, pull linked data with the link property, and type it end-to-end.
-- [Frontend](content/resources/best-practices/frontend.mdx) — Build panel UI the right way — @medusajs/ui usage, custom-field extensions (forms, tables, read-only section fields), and new pages, with the correct imports.
-- [Module links](content/resources/best-practices/module-links.mdx) — Relate modules without coupling them — defineLink, the link-direction rule, built-in link steps, and filtering by links.
-- [Modules](content/resources/best-practices/modules.mdx) — Keep modules thin — data access and CRUD only. Naming, decorators, and what must never live in a module service.
-- [Best Practices Overview](content/resources/best-practices/overview.mdx) — How to build with Mercur — the layered architecture, the non-negotiable rules, and where each piece of logic belongs.
-- [Subscribers & jobs](content/resources/best-practices/subscribers-and-jobs.mdx) — React to events and run periodic work safely — fetch from { id }, mutate via workflows, log-don't-throw, idempotency and loop guards, cron jobs.
-- [Types & augmentation](content/resources/best-practices/types.mdx) — Type the panels against your own backend extensions — augment framework DTOs with declaration merging so every SDK endpoint carries your custom data.
-- [Workflows](content/resources/best-practices/workflows.mdx) — Where all business logic and mutations live — composition-function constraints, one-mutation-per-step with compensation, reusing built-in steps, and the query engine.
+- [Skills](content/resources/ai/skills.mdx) — Agent skills for building on Mercur: the bundled-docs contract plus the official Medusa agent skills.
+- [How to Create an API Route](content/resources/best-practices/api-routes.mdx) — Write API routes as thin HTTP adapters that type both sides, validate with Zod, and scope reads through middlewares and queryConfig.
+- [How to Add a Custom Field](content/resources/best-practices/custom-fields.mdx) — Attach extra data to a built-in entity across the full stack: declare it in core, render it in the panels, pull in linked data, and type it end-to-end.
+- [Frontend Patterns](content/resources/best-practices/frontend.mdx) — Build Admin and Vendor panel UI with the shared design system: @medusajs/ui, custom-field extensions, and new pages, with the correct imports.
+- [How to Link Two Modules](content/resources/best-practices/module-links.mdx) — Relate modules without coupling them using defineLink, the link-direction rule, built-in link steps, and cross-link filtering.
+- [How to Create a Custom Module](content/resources/best-practices/modules.mdx) — Keep a module thin: it owns one domain's data and its CRUD, with no orchestration, events, or cross-module calls.
+- [How-to Guides](content/resources/best-practices/overview.mdx) — How to build with Mercur: the layered architecture, the non-negotiable rules, and where each piece of logic belongs.
+- [How to React to Events and Schedule Jobs](content/resources/best-practices/subscribers-and-jobs.mdx) — Run work outside the request cycle: react to events with subscribers, run periodic work with scheduled jobs, and always mutate through workflows.
+- [How to Use Shared Types](content/resources/best-practices/types.mdx) — Type the panels against your own backend extensions by augmenting framework DTOs with declaration merging.
+- [How to Create a Workflow](content/resources/best-practices/workflows.mdx) — Coordinate a business operation across modules as workflow steps, each with automatic rollback, reusing built-in steps and reading through the query engine.
 - [Custom Fields](content/resources/customization/custom-fields.mdx) — Extend any Medusa entity with additional fields without modifying core code.
-- [Extend a workflow](content/resources/customization/extend-a-workflow.mdx) — Inject custom logic into an existing Mercur workflow through hooks — without rewriting it.
-- [Extending Panels](content/resources/customization/extending-panels.mdx) — Add pages, inject widgets, customize navigation, and extend forms and tables in the admin and vendor panels.
-- [Medusa Cloud deployment](content/resources/deployment/medusa-cloud.mdx) — Deploy Mercur — backend, admin panel, and vendor panel — on Medusa Cloud.
-- [Notifications](content/resources/integrations/notifications.mdx) — Send transactional emails and marketplace notifications with Resend.
-- [Search](content/resources/integrations/search.mdx) — Mercur's provider-agnostic search module — zero-infrastructure Orama by default, swappable for Algolia, Meilisearch, or your own provider.
-- [Stripe Connect Integration](content/resources/integrations/stripe-connect.mdx) — Set up Stripe Connect for marketplace payments and seller payouts — from Stripe Dashboard configuration to the full end-to-end payment lifecycle.
-- [Add a feature with a block](content/resources/tutorials/add-a-block.mdx) — Install the reviews block end-to-end and see it live across the admin, vendor, and storefront surfaces.
-- [Add a widget](content/resources/tutorials/add-a-widget.mdx) — Inject a React component at a named zone on a built-in panel page with defineWidgetConfig — no forking.
-- [Add a button to order details](content/resources/tutorials/add-order-detail-button.mdx) — Drop a 'Copy link' button onto the vendor order detail page with a widget — no forking, no page override.
-- [Create attributes and variant axes](content/resources/tutorials/attributes-and-variant-axes.mdx) — Build the attribute catalog: a filterable attribute, a variant axis backed by a native product option, and an inline product-scoped axis.
-- [Build your own block](content/resources/tutorials/build-a-block.mdx) — Author a reusable feature as a block — backend, panel UI, and docs — build it into a registry, and install it into any Mercur project.
-- [Configure commissions](content/resources/tutorials/configure-commissions.mdx) — Set the global commission, add scoped rules for categories and sellers, and confirm the right rate lands on an order.
-- [Add a custom API route](content/resources/tutorials/custom-api-route.mdx) — Create a backend endpoint, regenerate the route map, and call it from a panel page with full type safety end to end.
-- [Add a custom panel page](content/resources/tutorials/custom-panel-page.mdx) — Add a page to the vendor portal with file-based routing — the dashboard SDK wires it in automatically.
-- [Customize navigation](content/resources/tutorials/customize-navigation.mdx) — Reorder, hide, relabel, and re-parent built-in sidebar items with a single _navigation.ts file and defineNavigationConfig.
-- [Extend forms and tables](content/resources/tutorials/extend-forms-and-tables.mdx) — Add validated fields to built-in forms, replace fields in detail sections, and add list columns with defineCustomFieldsConfig and createFormHelper.
-- [Extend the onboarding flow](content/resources/tutorials/extend-onboarding.mdx) — Add a field to the vendor store-setup surface, submit it through additional_data, and persist it durably from a workflow hook — end to end, without forking.
-- [Build your first marketplace](content/resources/tutorials/first-marketplace.mdx) — Go end-to-end: create a project, approve a seller, list a product, place a split order, and watch a payout settle.
-- [Handle product requests](content/resources/tutorials/handle-product-requests.mdx) — Walk a vendor's product submission and a follow-up edit through the operator review pipeline — confirm, decline, or send back.
-- [Import and export products via CSV](content/resources/tutorials/import-export-products.mdx) — Install the product-import-export block and give vendors CSV import and export drawers on their product list.
-- [Work with master products and offers](content/resources/tutorials/master-products-and-offers.mdx) — Two sellers compete on one catalog entry: publish a master product, create competing offers, and read per-offer prices from the Store API.
-- [Set up seller payouts](content/resources/tutorials/seller-payouts-stripe.mdx) — Take a seller from zero to paid: Stripe Connect onboarding, an order through fulfillment, capture, and the automated payout.
-- [Build a store-setup checklist](content/resources/tutorials/store-setup-checklist.mdx) — Render an onboarding progress checklist on the vendor store-setup surface with a seller.setup widget — the seller is handed to you as data, no fetching required.
-## Tools — CLI, API client, dashboard SDK
-- [API Client](content/tools/api-client.mdx) — Type-safe client for consuming Mercur APIs.
-- [CLI](content/tools/cli.mdx) — Install blocks, scaffold projects, and generate types from the command line.
-- [Dashboard SDK](content/tools/dashboard-sdk.mdx) — The Vite plugin that powers admin and vendor panel extension — file-based routing, virtual modules, and block resolution.
+- [How to Extend a Workflow](content/resources/customization/extend-a-workflow.mdx) — Inject custom logic into an existing Mercur workflow through hooks, without rewriting it.
+- [How to Extend the Panels](content/resources/customization/extending-panels.mdx) — Add pages, widgets, navigation overrides, and form and table fields to the admin and vendor panels without forking.
+- [Medusa Cloud](content/resources/deployment/medusa-cloud.mdx) — Deploy the Mercur backend, admin panel, and vendor panel on Medusa Cloud.
+- [Self-host Mercur](content/resources/deployment/self-host.mdx) — Deploy a Mercur marketplace to your own infrastructure: the API, the panels, and the databases behind them.
+- [Integrations](content/resources/integrations/overview.mdx) — Extend Mercur with third-party providers and installable blocks.
+- [Stripe Connect](content/resources/integrations/stripe-connect.mdx) — Set up Stripe Connect for marketplace payments and seller payouts, from Stripe Dashboard configuration to the full end-to-end payment lifecycle.
+- [How to Add a Block](content/resources/tutorials/add-a-block.mdx) — Install the reviews block end-to-end and follow it live across the admin, vendor, and storefront surfaces.
+- [How to Add a Widget](content/resources/tutorials/add-a-widget.mdx) — Render your own React component in a named zone on a built-in panel page without forking it.
+- [How to Add an Action Button](content/resources/tutorials/add-order-detail-button.mdx) — Add a Copy link button to the vendor order detail page with a widget, without forking or overriding the page.
+- [How to Create Variant-Axis Attributes](content/resources/tutorials/attributes-and-variant-axes.mdx) — Build an attribute catalog with a filterable attribute, a global variant axis, and an inline product-scoped axis.
+- [How to Build a Block](content/resources/tutorials/build-a-block.mdx) — Author a reusable feature as a block covering backend, panel UI, and docs, then build it into a registry and install it into any Mercur project.
+- [How to Add a Custom API Route](content/resources/tutorials/custom-api-route.mdx) — Add a backend endpoint, regenerate the route map, and call it from a panel page with full type safety.
+- [How to Create a Custom Page](content/resources/tutorials/custom-panel-page.mdx) — Add a page to the vendor portal or admin panel with file-based routing and let the dashboard SDK wire it into the sidebar.
+- [How to Customize Navigation](content/resources/tutorials/customize-navigation.mdx) — Reorder, hide, relabel, and re-parent the panel's built-in sidebar items from a single _navigation.ts file.
+- [How to Extend Forms and Tables](content/resources/tutorials/extend-forms-and-tables.mdx) — Add validated fields, detail-section displays, and list columns to a built-in model from a single file with defineCustomFieldsConfig.
+- [How to Extend Onboarding](content/resources/tutorials/extend-onboarding.mdx) — Add a field to the vendor store-setup surface, carry it through additional_data, and persist it from a workflow hook without forking core.
+- [How to Create Master Products and Offers](content/resources/tutorials/master-products-and-offers.mdx) — Publish one master product, add two competing seller offers, and read per-offer prices from the Store API.
 ## References — modules, HTTP API, configuration
-- [Admin API](content/references/api/admin.mdx) — Operator routes under /admin/* — sellers, commissions, payouts, master catalog, and marketplace-wide orders.
+- [Admin API](content/references/api/admin.mdx) — Operator routes under /admin/* for sellers, commissions, payouts, master catalog, and marketplace-wide orders.
 - [Batch Commission Rules](content/references/api/admin/commission-rates/batch-commission-rules.mdx) — Create, update, and delete a commission rate's rules in one request.
 - [Create Commission Rate](content/references/api/admin/commission-rates/create-commission-rate.mdx) — Create a commission rate.
 - [Delete Commission Rate](content/references/api/admin/commission-rates/delete-commission-rate.mdx) — Delete a commission rate.
@@ -137,8 +124,8 @@ package (`node_modules/@mercurjs/docs/`).
 - [Upsert Payment Details](content/references/api/admin/sellers/upsert-payment-details.mdx) — Create or update a seller's bank payment details.
 - [Upsert Professional Details](content/references/api/admin/sellers/upsert-professional-details.mdx) — Create or update a seller's legal and tax details.
 - [Upsert Seller Address](content/references/api/admin/sellers/upsert-seller-address.mdx) — Create or update a seller's address.
-- [API conventions](content/references/api/conventions.mdx) — Authentication, seller scoping, pagination, field selection, and webhooks — shared by every Mercur API surface.
-- [Store API](content/references/api/store.mdx) — Storefront routes under /store/* — discovery, multi-vendor carts, checkout, and order groups.
+- [API conventions](content/references/api/conventions.mdx) — Authentication, seller scoping, pagination, field selection, and webhooks shared by every Mercur API surface.
+- [Store API](content/references/api/store.mdx) — Storefront routes under /store/* for discovery, multi-vendor carts, checkout, and order groups.
 - [Add Line Item](content/references/api/store/carts/add-line-item.mdx) — Add a seller offer to the cart as a line item.
 - [Add Shipping Method](content/references/api/store/carts/add-shipping-methods.mdx) — Add a seller shipping option to the cart.
 - [Apply Promotions](content/references/api/store/carts/apply-promotions.mdx) — Apply promotion codes to the cart.
@@ -153,11 +140,10 @@ package (`node_modules/@mercurjs/docs/`).
 - [Retrieve Product Category](content/references/api/store/product-categories/retrieve-product-category.mdx) — Retrieve an active, public product category by ID.
 - [List Products](content/references/api/store/products/list-products.mdx) — Retrieve published products from visible sellers.
 - [Retrieve Product](content/references/api/store/products/retrieve-product.mdx) — Retrieve a published product by ID.
-- [Search](content/references/api/store/search/search.mdx) — Query the search index across products and offers.
 - [List Sellers](content/references/api/store/sellers/list-sellers.mdx) — Retrieve open sellers visible on the storefront.
 - [Retrieve Seller](content/references/api/store/sellers/retrieve-seller.mdx) — Retrieve an open seller by ID.
 - [List Shipping Options](content/references/api/store/shipping-options/list-shipping-options.mdx) — Retrieve available shipping options for a cart, grouped by seller.
-- [Vendor API](content/references/api/vendor.mdx) — Seller-scoped routes under /vendor/* — every request operates on the authenticated member's selected seller.
+- [Vendor API](content/references/api/vendor.mdx) — Seller-scoped routes under /vendor/* where every request operates on the authenticated member's selected seller.
 - [Accept Member Invite](content/references/api/vendor/members/accept-member-invite.mdx) — Accept a seller team invite using its token.
 - [Retrieve Current Member](content/references/api/vendor/members/retrieve-current-member.mdx) — Retrieve the authenticated member's profile for the active seller.
 - [Update Current Member](content/references/api/vendor/members/update-current-member.mdx) — Update the authenticated member's profile.
@@ -217,106 +203,154 @@ package (`node_modules/@mercurjs/docs/`).
 - [Upsert Professional Details](content/references/api/vendor/sellers/upsert-professional-details.mdx) — Create or update the seller's business registration details.
 - [Upsert Seller Address](content/references/api/vendor/sellers/upsert-seller-address.mdx) — Create or update the seller's address.
 - [Configuration](content/references/configuration.mdx) — withMercur() options, environment variables, and provider configuration.
-- [Commission module](content/references/modules/commission.mdx) — Data models and service methods for the Commission module.
-- [Custom Fields module](content/references/modules/custom-fields.mdx) — Add extra columns to any entity without writing a custom module.
-- [Media module](content/references/modules/media.mdx) — Image records for categories and collections — galleries, thumbnails, banners, and icons.
-- [Offer module](content/references/modules/offer.mdx) — Data models, links, and service methods for the Offer module.
-- [Payout module](content/references/modules/payout.mdx) — Data models, links, service methods, and the provider interface for the Payout module.
-- [Product Attribute module](content/references/modules/product-attribute.mdx) — Data models, links, and service methods for the Product Attribute module.
-- [Product Edit module](content/references/modules/product-edit.mdx) — Data models and lifecycle for product change requests on master products.
-- [Search module](content/references/modules/search.mdx) — The provider-agnostic search module, its document shapes, and the provider contract.
-- [Seller module](content/references/modules/seller.mdx) — Data models, links, and service methods for the Seller module.
-- [References](content/references/overview.mdx) — Technical references for Mercur's modules, HTTP APIs, workflows, and configuration.
-- [Panel Extension API](content/references/panel-extension-api.mdx) — The file-based helpers for extending the admin and vendor panels — defineWidgetConfig, defineNavigationConfig, defineCustomFieldsConfig, createFormHelper — and the exact props passed to every component you supply.
-- [addSellerShippingMethodToCartWorkflow](content/references/workflows/cart/add-seller-shipping-method-to-cart.mdx) — Add shipping methods to a cart, replacing only the same seller's existing methods.
-- [completeCartWithSplitOrdersWorkflow](content/references/workflows/cart/complete-cart-with-split-orders.mdx) — Complete a multi-seller cart by splitting it into per-seller orders under an order group.
-- [listSellerShippingOptionsForCartWorkflow](content/references/workflows/cart/list-seller-shipping-options-for-cart.mdx) — List available shipping options for a cart, grouped by seller.
-- [updateCartSellerPromotionsWorkflow](content/references/workflows/cart/update-cart-seller-promotions.mdx) — Apply, remove, or replace promotion codes on a cart with seller-scoped adjustments.
-- [batchCommissionRulesWorkflow](content/references/workflows/commission/batch-commission-rules.mdx) — Create, update, and delete a commission rate's rules in one call.
-- [createCommissionRatesWorkflow](content/references/workflows/commission/create-commission-rates.mdx) — Create one or more commission rates.
-- [deleteCommissionRatesWorkflow](content/references/workflows/commission/delete-commission-rates.mdx) — Soft-delete commission rates after validating they can be removed.
-- [refreshOrderCommissionLinesWorkflow](content/references/workflows/commission/refresh-order-commission-lines.mdx) — Recompute the commission lines for one or more orders.
-- [updateCommissionRatesWorkflow](content/references/workflows/commission/update-commission-rates.mdx) — Update one or more commission rates.
-- [setCategoryImagesWorkflow](content/references/workflows/media/set-category-images.mdx) — Replace a category's media gallery and icon, enforcing single thumbnail/banner.
-- [setCollectionImagesWorkflow](content/references/workflows/media/set-collection-images.mdx) — Replace a collection's media gallery and icon, enforcing single thumbnail/banner.
-- [acceptMemberInviteWorkflow](content/references/workflows/member/accept-member-invite.mdx) — Redeem an invite token and join a seller's team.
-- [addSellerMemberWorkflow](content/references/workflows/member/add-seller-member.mdx) — Attach an existing member to a seller with a role.
-- [createMemberInvitesWorkflow](content/references/workflows/member/create-member-invites.mdx) — Create tokenized member invitations for sellers.
-- [deleteMemberInviteWorkflow](content/references/workflows/member/delete-member-invite.mdx) — Delete a pending member invite.
-- [removeSellerMemberWorkflow](content/references/workflows/member/remove-seller-member.mdx) — Remove a member from a seller's team.
-- [resendMemberInviteWorkflow](content/references/workflows/member/resend-member-invite.mdx) — Re-issue a member invite with a fresh token.
-- [updateMemberRoleWorkflow](content/references/workflows/member/update-member-role.mdx) — Change a team member's role.
-- [updateMemberWorkflow](content/references/workflows/member/update-member.mdx) — Update member profile fields matching a selector.
-- [batchOfferInventoryItemsWorkflow](content/references/workflows/offer/batch-offer-inventory-items.mdx) — Create, update, and delete an offer's inventory-item links in one call.
-- [createOffersWorkflow](content/references/workflows/offer/create-offers.mdx) — Create seller offers with inventory items and offer-scoped prices.
-- [deleteOffersWorkflow](content/references/workflows/offer/delete-offers.mdx) — Delete one or more offers.
-- [updateOffersWorkflow](content/references/workflows/offer/update-offers.mdx) — Update offer rows and rewrite their price ladders with replace semantics.
-- [getOrderGroupDetailWorkflow](content/references/workflows/order-group/get-order-group-detail.mdx) — Retrieve one order group with per-order aggregated payment and fulfillment statuses.
-- [getOrderGroupsListWorkflow](content/references/workflows/order-group/get-order-groups-list.mdx) — List order groups with pagination and per-order aggregated statuses.
-- [cancelOrderFulfillmentWorkflow](content/references/workflows/order/cancel-order-fulfillment.mdx) — Cancel an unshipped fulfillment and restore reservations and stock.
-- [confirmClaimRequestWorkflow](content/references/workflows/order/confirm-claim-request.mdx) — Confirm a claim request and fix reservations for offer bundles.
-- [confirmExchangeRequestWorkflow](content/references/workflows/order/confirm-exchange-request.mdx) — Confirm an exchange request and fix reservations for offer bundles.
-- [confirmOrderEditRequestWorkflow](content/references/workflows/order/confirm-order-edit-request.mdx) — Confirm an order edit and reconcile offer-bundle reservations.
-- [confirmReturnReceiveWorkflow](content/references/workflows/order/confirm-return-receive.mdx) — Confirm a return receival, offer-aware restock included.
-- [createOrderFulfillmentWorkflow](content/references/workflows/order/create-order-fulfillment.mdx) — Create a fulfillment for order items, offer-bundle aware.
-- [Workflows](content/references/workflows/overview.mdx) — Every workflow exported by @mercurjs/core, grouped by domain.
-- [createOnboardingWorkflow](content/references/workflows/payout/create-onboarding.mdx) — Start a provider onboarding session for a payout account.
-- [createPayoutAccountWorkflow](content/references/workflows/payout/create-payout-account.mdx) — Create a payout account for a seller through the registered payout provider.
-- [createPayoutWorkflow](content/references/workflows/payout/create-payout.mdx) — Issue a payout to a seller through the registered provider.
-- [processPayoutForWebhookWorkflow](content/references/workflows/payout/process-payout-for-webhook.mdx) — Apply a payout provider webhook event to the matching account or payout.
-- [addProductAttributesToProductWorkflow](content/references/workflows/product-attribute/add-product-attributes-to-product.mdx) — Attach existing or inline attributes (and their values) to a product.
-- [createAndLinkProductAttributesToProductWorkflow](content/references/workflows/product-attribute/create-and-link-product-attributes-to-product.mdx) — Batch attach, detach, and update attribute selections on a product.
-- [createProductAttributeValuesWorkflow](content/references/workflows/product-attribute/create-product-attribute-values.mdx) — Add values to an attribute, mirroring them onto its product option.
-- [createProductAttributesWorkflow](content/references/workflows/product-attribute/create-product-attributes.mdx) — Create catalog attributes with values, mirror options, and category links.
-- [deleteProductAttributeValuesWorkflow](content/references/workflows/product-attribute/delete-product-attribute-values.mdx) — Delete attribute values and shrink the mirror option accordingly.
-- [deleteProductAttributesWorkflow](content/references/workflows/product-attribute/delete-product-attributes.mdx) — Delete attributes and their mirror product options.
-- [removeProductAttributesFromProductWorkflow](content/references/workflows/product-attribute/remove-product-attributes-from-product.mdx) — Detach attributes from a product, deleting product-scoped ones.
-- [updateProductAttributeValuesWorkflow](content/references/workflows/product-attribute/update-product-attribute-values.mdx) — Update attribute values matching a selector and re-sync the mirror option.
-- [updateProductAttributesOnProductWorkflow](content/references/workflows/product-attribute/update-product-attributes-on-product.mdx) — Mutate a product's per-attribute value selections.
-- [updateProductAttributesWorkflow](content/references/workflows/product-attribute/update-product-attributes.mdx) — Update attributes matching a selector and sync mirror option titles.
-- [upsertProductAttributeValuesWorkflow](content/references/workflows/product-attribute/upsert-product-attribute-values.mdx) — Create or update attribute values in one call, keyed by id presence.
-- [autoConfirmProductChangeWorkflow](content/references/workflows/product-edit/auto-confirm-product-change.mdx) — Conditionally confirm a ProductChange based on the product_request feature flag.
-- [cancelProductChangeWorkflow](content/references/workflows/product-edit/cancel-product-change.mdx) — Cancel a pending ProductChange so its staged actions are never applied.
-- [confirmProductChangeWorkflow](content/references/workflows/product-edit/confirm-product-change.mdx) — Confirm pending ProductChanges and apply their staged actions to the master product.
-- [createProductChangeWorkflow](content/references/workflows/product-edit/create-product-change.mdx) — Create ProductChange records after validating no pending change exists per product.
-- [rejectProductChangeWorkflow](content/references/workflows/product-edit/reject-product-change.mdx) — Decline a pending ProductChange with an optional reason for the vendor.
-- [stageProductChangeWorkflow](content/references/workflows/product-edit/stage-product-change.mdx) — Stage a pending ProductChange with its actions and optionally auto-confirm it.
-- [confirmProductsWorkflow](content/references/workflows/product/confirm-products.mdx) — Approve proposed products and publish them to the catalog.
-- [createProductsWorkflow](content/references/workflows/product/create-products.mdx) — Create master catalog products with seller eligibility and creator attribution.
-- [linkSellersToProductCategoryWorkflow](content/references/workflows/product/link-sellers-to-product-category.mdx) — Add or remove seller eligibility links on a product category.
-- [linkSellersToProductWorkflow](content/references/workflows/product/link-sellers-to-product.mdx) — Add or remove seller eligibility links on a master product.
-- [rejectProductWorkflow](content/references/workflows/product/reject-product.mdx) — Reject a proposed product submission with an optional message to the vendor.
-- [requestProductChangeWorkflow](content/references/workflows/product/request-product-change.mdx) — Ask a vendor to revise a proposed product submission without changing its status.
-- [approveSellerWorkflow](content/references/workflows/seller/approve-seller.mdx) — Approve a pending seller and open its store.
-- [createSellerAccountWorkflow](content/references/workflows/seller/create-seller-account.mdx) — Create a seller with its owner member during self-registration.
-- [createSellerDefaultsWorkflow](content/references/workflows/seller/create-seller-defaults.mdx) — Ensure the default seller roles exist.
-- [createSellersWorkflow](content/references/workflows/seller/create-sellers.mdx) — Create one or more sellers and invite their first member.
-- [deleteSellerProfessionalDetailsWorkflow](content/references/workflows/seller/delete-seller-professional-details.mdx) — Remove a seller's professional details.
-- [deleteSellersWorkflow](content/references/workflows/seller/delete-sellers.mdx) — Delete sellers by id.
-- [inviteSellerWorkflow](content/references/workflows/seller/invite-seller.mdx) — Send a marketplace invitation email to a prospective seller.
-- [suspendSellerWorkflow](content/references/workflows/seller/suspend-seller.mdx) — Suspend a seller with an optional reason.
-- [terminateSellerWorkflow](content/references/workflows/seller/terminate-seller.mdx) — Terminate a seller with an optional reason.
-- [unsuspendSellerWorkflow](content/references/workflows/seller/unsuspend-seller.mdx) — Lift a seller suspension.
-- [unterminateSellerWorkflow](content/references/workflows/seller/unterminate-seller.mdx) — Revert a terminated seller back to suspended.
-- [updateSellerAddressWorkflow](content/references/workflows/seller/update-seller-address.mdx) — Upsert a seller's address.
-- [updateSellerPaymentDetailsWorkflow](content/references/workflows/seller/update-seller-payment-details.mdx) — Upsert a seller's bank payment details.
-- [updateSellerProfessionalDetailsWorkflow](content/references/workflows/seller/update-seller-professional-details.mdx) — Upsert a seller's professional (business) details.
-- [updateSellersWorkflow](content/references/workflows/seller/update-sellers.mdx) — Update sellers matching a selector.
+- [Reference](content/references/overview.mdx) — Technical reference for Mercur's HTTP APIs, panel extensions, and configuration.
+- [Create a new page](content/references/panel-extensions/create-page.mdx) — Add a page to the admin or vendor panel with file-based routing, then register it in the sidebar.
+- [Custom Fields](content/references/panel-extensions/custom-fields.mdx) — Add fields, detail rows, section actions, and list columns to a built-in model.
+- [Panel extensions](content/references/panel-extensions/overview.mdx) — Customize the admin and vendor panels with pages, widgets, custom fields, and navigation, without forking them.
+- [Widgets](content/references/panel-extensions/widgets.mdx) — Render a React component in a fixed slot on a built-in admin or vendor page.
 ## User Guide — admin and vendor panels
-- [Admin Panel](content/user-guide/admin/overview.mdx) — What marketplace operators do in the Admin Panel — no technical knowledge required.
+- [Create a Product Attribute](content/user-guide/admin/attributes/how-tos/create-an-attribute.mdx) — Add a new attribute and choose how it stores its value.
+- [Manage an Attribute's Possible Values](content/user-guide/admin/attributes/how-tos/manage-possible-values.mdx) — Add or reorder the values sellers can choose from for a select attribute.
+- [Product Attributes](content/user-guide/admin/attributes/overview.mdx) — Create the typed attributes sellers use to describe products and customers use to filter them.
+- [Create a Commission Rule](content/user-guide/admin/commissions/how-tos/create-a-commission-rule.mdx) — Override the global commission for a specific store, product type, or category.
+- [Edit the Global Commission](content/user-guide/admin/commissions/how-tos/edit-the-global-commission.mdx) — Change the default fee your marketplace takes on every sale.
+- [Manage a Commission Rule](content/user-guide/admin/commissions/how-tos/manage-a-commission-rule.mdx) — Edit, enable, disable, or delete an existing commission rule.
+- [Commissions](content/user-guide/admin/commissions/overview.mdx) — Set the fee your marketplace takes on each seller's sales.
+- [Admin Panel](content/user-guide/admin/overview.mdx) — What marketplace operators do in the Admin Panel, with no technical knowledge required.
+- [Review a New Product Request](content/user-guide/admin/product-requests/how-tos/review-a-new-product.mdx) — Confirm, request changes to, or reject a product a seller submitted.
+- [Review a Product Update Request](content/user-guide/admin/product-requests/how-tos/review-a-product-edit.mdx) — Approve or reject the changes a seller made to a published product.
+- [Product Requests](content/user-guide/admin/product-requests/overview.mdx) — Review, approve, or reject the products and edits sellers submit.
 - [Stores in Mercur Admin Panel](content/user-guide/admin/stores.mdx)
-- [Vendor Panel](content/user-guide/vendor/overview.mdx) — What sellers do in the Vendor Panel — no technical knowledge required.
+- [Create an Offer](content/user-guide/vendor/offers/how-tos/create-an-offer.mdx) — List one or more catalog products for sale with your SKU, price, and stock.
+- [Update Offer Prices and Stock](content/user-guide/vendor/offers/how-tos/update-prices-and-stock.mdx) — Change an existing offer's prices or inventory without recreating it.
+- [Offers](content/user-guide/vendor/offers/overview.mdx) — List a product for sale with your SKU, price, and stock.
+- [Complete Your Onboarding](content/user-guide/vendor/onboarding.mdx) — Set up your store step by step when you first join the marketplace.
+- [Fulfill an Order](content/user-guide/vendor/orders/how-tos/fulfill-an-order.mdx) — Prepare the items in an order to be sent to the customer.
+- [Mark an Order as Delivered](content/user-guide/vendor/orders/how-tos/mark-an-order-as-delivered.mdx) — Record that the customer has received a shipped order.
+- [Process a Return](content/user-guide/vendor/orders/how-tos/process-a-return.mdx) — Create a return for an order and receive the items back into stock.
+- [Refund an Order](content/user-guide/vendor/orders/how-tos/refund-an-order.mdx) — Return money to the customer for a captured payment.
+- [Ship an Order](content/user-guide/vendor/orders/how-tos/ship-an-order.mdx) — Mark fulfilled items as shipped and add tracking for the customer.
+- [Orders](content/user-guide/vendor/orders/overview.mdx) — Fulfill, ship, refund, and handle returns for the orders you receive.
+- [Vendor Panel](content/user-guide/vendor/overview.mdx) — What sellers do in the Vendor Panel, with no technical knowledge required.
+- [Edit a Product](content/user-guide/vendor/products/how-tos/edit-a-product.mdx) — Change a published product and track the update request.
+- [Submit a Product](content/user-guide/vendor/products/how-tos/submit-a-product.mdx) — Create a new product and send it to the marketplace for approval.
+- [Products](content/user-guide/vendor/products/overview.mdx) — Submit products to the shared marketplace catalog and track their approval.
 - [Store in Mercur Vendor Panel](content/user-guide/vendor/stores.mdx)
-## Migration
-- [From 1.x to 2.0](content/migration/from-1-x-to-2-0.mdx) — What changed and how to port your existing Mercur 1.x code to 2.0.
-- [From 2.0 to 2.1](content/migration/from-2-0-to-2-1.mdx) — What changed in Mercur 2.1 and how to upgrade an existing 2.0.x project.
-- [Migration Overview](content/migration/overview.mdx) — Understand what changes between Mercur 1.x and 2.0 and how to migrate your project.
 ## Other
 - [Official Blocks](content/blocks.mdx) — Modular blocks from the official Mercur registry — install only what you need.
+- [Mercur Documentation](content/home.mdx) — The open-source enterprise marketplace platform built on Medusa.
+- [Attribute types](content/platform/attribute/concepts/attribute-types.mdx) — The five attribute types and the values they hold.
+- [Global vs inline & filtering](content/platform/attribute/concepts/global-vs-inline.mdx) — Catalog-wide attributes, product-scoped attributes, and storefront filtering.
+- [Variant axes](content/platform/attribute/concepts/variant-axes.mdx) — How is_variant_axis mirrors a native ProductOption and generates variants.
+- [Attach attributes to a product](content/platform/attribute/guides/attach-attributes-to-a-product.mdx) — Attach, detach, and update a product's attributes in one batch call.
+- [Create a variant axis](content/platform/attribute/guides/create-a-variant-axis.mdx) — Generate product variants from a multi_select axis attribute.
+- [Create an attribute](content/platform/attribute/guides/create-an-attribute.mdx) — Create a typed catalog attribute with createProductAttributesWorkflow.
+- [Attribute](content/platform/attribute/overview.mdx) — An operator-managed, typed attribute catalog for describing and filtering the shared product catalog.
+- [Data models](content/platform/attribute/reference/data-models.mdx) — The data models owned by the Attribute (Product Attribute) domain.
+- [Event reference](content/platform/attribute/reference/events.mdx) — Events emitted by the Attribute domain, for subscribers and side effects.
+- [Links to other modules](content/platform/attribute/reference/links.mdx) — How the Attribute (Product Attribute) domain links to products, categories, and options.
+- [Service reference](content/platform/attribute/reference/service.mdx) — The Product Attribute module service, with methods for working with records directly.
+- [Workflows](content/platform/attribute/reference/workflows.mdx) — Attribute catalog and product-attachment workflows.
+- [Master products](content/platform/catalog/concepts/master-products.mdx) — The shared catalog, why products aren't seller-owned, and submission attribution.
+- [The store allowlist](content/platform/catalog/concepts/product-seller-allowlist.mdx) — The product_seller link that controls which stores may sell a master product.
+- [Status lifecycle](content/platform/catalog/concepts/status-lifecycle.mdx) — How a master product moves from draft to proposed, published, or rejected.
+- [Variants, categories & collections](content/platform/catalog/concepts/variants-categories-collections.mdx) — The native Medusa Product structure the shared catalog is built on.
+- [Allowlist stores](content/platform/catalog/guides/allowlist-stores.mdx) — Grant and revoke a store's right to sell a master product from server code.
+- [Create a master product](content/platform/catalog/guides/create-a-master-product.mdx) — Create a master product programmatically with createProductsWorkflow.
+- [Publish or reject a product](content/platform/catalog/guides/publish-or-reject-a-product.mdx) — Move a proposed master product to published or rejected from server code.
+- [Catalog](content/platform/catalog/overview.mdx) — Master products, variants, categories, and the store allowlist that governs who may sell what.
+- [Data models](content/platform/catalog/reference/data-models.mdx) — The Medusa Product models the catalog is built on, plus Mercur's marketplace layer.
+- [Event reference](content/platform/catalog/reference/events.mdx) — Events emitted by the Catalog domain, for subscribers and side effects.
+- [Links to other modules](content/platform/catalog/reference/links.mdx) — How the catalog links to sellers, offers, attributes, and media.
+- [Service reference](content/platform/catalog/reference/service.mdx) — Medusa's Product module service: methods for working with records directly.
+- [Workflows](content/platform/catalog/reference/workflows.mdx) — Mercur's product create, review, and allowlist workflows.
+- [Order commission lines](content/platform/commission/concepts/order-commission-lines.mdx) — Per-order commission lines, how they're computed, and BigNumber precision.
+- [Rule matching](content/platform/commission/concepts/rule-matching.mdx) — The five dimensions, most-specific-wins resolution, tie-breaks, and shipping.
+- [Rules & rates](content/platform/commission/concepts/rules-and-rates.mdx) — The commission rate, its fixed and percentage forms, and per-currency amounts.
+- [Batch-update commission rules](content/platform/commission/guides/batch-update-rules.mdx) — Create, update, and delete a rate's rules in a single call.
+- [Create a commission rate](content/platform/commission/guides/create-a-rate.mdx) — Create a commission rate programmatically with createCommissionRatesWorkflow.
+- [Refresh order commission lines](content/platform/commission/guides/refresh-order-commission-lines.mdx) — Recompute an order's commission lines after it changes.
+- [Commission](content/platform/commission/overview.mdx) — Configure how the marketplace takes its cut of every seller order.
+- [Data models](content/platform/commission/reference/data-models.mdx) — The data models owned by the Commission domain.
+- [Event reference](content/platform/commission/reference/events.mdx) — How the Commission domain stays in sync with order changes.
+- [Links to other modules](content/platform/commission/reference/links.mdx) — How the Commission domain connects to the catalog, sellers, and orders.
+- [Service reference](content/platform/commission/reference/service.mdx) — The Commission module service and its methods for working with records directly.
+- [Workflows](content/platform/commission/reference/workflows.mdx) — Commission rate, rule, and order-line workflows.
+- [Pricing & inventory](content/platform/offer/concepts/pricing-and-inventory.mdx) — Offer-scoped prices on the shared price set, and inventory linked to the offer.
+- [Shipping](content/platform/offer/concepts/shipping.mdx) — How an offer carries its own shipping profile.
+- [What is an offer](content/platform/offer/concepts/what-is-an-offer.mdx) — The offer record, how it points at a master product variant, and its SKU.
+- [Bulk-create offers](content/platform/offer/guides/bulk-create-offers.mdx) — List many offers against the master catalog in a single workflow run.
+- [Create an offer](content/platform/offer/guides/create-an-offer.mdx) — Create a single offer programmatically with createOffersWorkflow.
+- [Manage offer inventory](content/platform/offer/guides/manage-offer-inventory.mdx) — Attach, update, and detach inventory items on an existing offer.
+- [Offer](content/platform/offer/overview.mdx) — How a store sells against the shared master catalog, with its own SKU, price, inventory, and shipping.
+- [Data models](content/platform/offer/reference/data-models.mdx) — The data models owned by the Offer domain.
+- [Event reference](content/platform/offer/reference/events.mdx) — Events emitted by the Offer domain, for subscribers and side effects.
+- [Links to other modules](content/platform/offer/reference/links.mdx) — How the Offer domain links to other modules across the marketplace.
+- [Service reference](content/platform/offer/reference/service.mdx) — The Offer module service and its methods for working with records directly.
+- [Workflows](content/platform/offer/reference/workflows.mdx) — Offer workflows for creating, updating, deleting, and batching inventory.
+- [Computed totals](content/platform/order-group/concepts/computed-totals.mdx) — Why an order group's seller count and total are derived at query time, not stored.
+- [Order splitting](content/platform/order-group/concepts/order-splitting.mdx) — How a multi-seller cart becomes a group of independent per-seller orders.
+- [The order group](content/platform/order-group/concepts/the-order-group.mdx) — The aggregate record over a multi-seller purchase, its display id, and cart link.
+- [List order groups](content/platform/order-group/guides/list-order-groups.mdx) — Page through order groups and scope them to a seller with getOrderGroupsListWorkflow.
+- [Retrieve an order group](content/platform/order-group/guides/retrieve-an-order-group.mdx) — Load an order group and its aggregated child orders with getOrderGroupDetailWorkflow.
+- [Split a cart into orders](content/platform/order-group/guides/split-a-cart.mdx) — Complete a multi-seller cart into a group of per-seller orders with completeCartWithSplitOrdersWorkflow.
+- [Order Group](content/platform/order-group/overview.mdx) — Wrap a multi-seller cart into one shopper-facing order made of independent per-seller orders.
+- [Data models](content/platform/order-group/reference/data-models.mdx) — The data model owned by the Order Group domain.
+- [Event reference](content/platform/order-group/reference/events.mdx) — Events emitted by the Order Group domain, for subscribers and side effects.
+- [Links to other modules](content/platform/order-group/reference/links.mdx) — How the Order Group domain links to carts, orders, sellers, and offers.
+- [Service reference](content/platform/order-group/reference/service.mdx) — The Seller module service and its methods for working with order group records directly.
+- [Workflows](content/platform/order-group/reference/workflows.mdx) — Order group workflows, service methods, and events.
+- [Account lifecycle](content/platform/payout/concepts/account-lifecycle.mdx) — Payout account statuses and the webhook-driven transitions between them.
+- [Accounts & onboarding](content/platform/payout/concepts/accounts-and-onboarding.mdx) — The payout account, its onboarding record, and provider-specific data.
+- [The payout pipeline](content/platform/payout/concepts/payout-pipeline.mdx) — Capture check, payment capture, daily payout, transfer, and the provider interface.
+- [Create a payout account](content/platform/payout/guides/create-a-payout-account.mdx) — Create a seller's payout account with createPayoutAccountWorkflow.
+- [Process a provider webhook](content/platform/payout/guides/process-a-provider-webhook.mdx) — Turn a provider webhook into account and payout status updates.
+- [Start provider onboarding](content/platform/payout/guides/start-provider-onboarding.mdx) — Kick off provider onboarding with createOnboardingWorkflow.
+- [Payout](content/platform/payout/overview.mdx) — Onboard sellers to a payment provider and settle their earnings automatically.
+- [Data models](content/platform/payout/reference/data-models.mdx) — The data models owned by the Payout domain.
+- [Event reference](content/platform/payout/reference/events.mdx) — Events that drive the payout pipeline, for subscribers and side effects.
+- [Links to other modules](content/platform/payout/reference/links.mdx) — How the Payout domain links to sellers and orders across the marketplace.
+- [Service reference](content/platform/payout/reference/service.mdx) — The Payout module service: methods for working with records directly.
+- [Workflows](content/platform/payout/reference/workflows.mdx) — Payout account, onboarding, payout, and webhook workflows.
+- [Change actions](content/platform/product-edit/concepts/change-actions.mdx) — The typed actions that make up a change and the details they carry.
+- [The change pipeline](content/platform/product-edit/concepts/change-pipeline.mdx) — The ProductChange record, its immutability, and the audit trail.
+- [Status & auto-confirm](content/platform/product-edit/concepts/status-and-auto-confirm.mdx) — The change status lifecycle, revision requests, and auto-confirm.
+- [Confirm or decline a change](content/platform/product-edit/guides/confirm-or-decline-a-change.mdx) — Resolve a pending product change from server code.
+- [Edit a product](content/platform/product-edit/guides/edit-a-product.mdx) — Stage a product change from server code with the edit workflows.
+- [Request a revision](content/platform/product-edit/guides/request-a-revision.mdx) — Send a product submission back to the vendor from server code.
+- [Product Edit](content/platform/product-edit/overview.mdx) — Route every product edit through a reviewable, immutable change pipeline.
+- [Data models](content/platform/product-edit/reference/data-models.mdx) — The data models owned by the Product Edit domain.
+- [Event reference](content/platform/product-edit/reference/events.mdx) — Events emitted by the Product Edit domain, for subscribers and side effects.
+- [Links to other modules](content/platform/product-edit/reference/links.mdx) — How the Product Edit domain links to other modules across the marketplace.
+- [Service reference](content/platform/product-edit/reference/service.mdx) — The Product Edit module service methods for working with records directly.
+- [Workflows](content/platform/product-edit/reference/workflows.mdx) — Product change workflows, service methods, and events.
+- [Product vs seller reviews](content/platform/review/concepts/product-vs-seller-reviews.mdx) — The reference discriminator and the links that anchor each review.
+- [Ratings & moderation](content/platform/review/concepts/ratings-and-moderation.mdx) — The review status lifecycle, store responses, and aggregate ratings.
+- [The review model](content/platform/review/concepts/the-review-model.mdx) — The single review entity, its rating, notes, and moderation status.
+- [Compute aggregate ratings](content/platform/review/guides/compute-aggregate-ratings.mdx) — Compute average ratings for products and sellers from server code.
+- [Create a review](content/platform/review/guides/create-a-review.mdx) — Create a review programmatically with createReviewWorkflow.
+- [Moderate a review](content/platform/review/guides/moderate-a-review.mdx) — Publish, reject, and delete reviews from server code.
+- [Respond to a review](content/platform/review/guides/respond-to-a-review.mdx) — Attach a store's public response with respondReviewWorkflow.
+- [Review](content/platform/review/overview.mdx) — Collect, moderate, and surface customer ratings for products and sellers.
+- [Data models](content/platform/review/reference/data-models.mdx) — The data models owned by the Review domain.
+- [Event reference](content/platform/review/reference/events.mdx) — Running side effects as reviews are created, moderated, and answered.
+- [Links to other modules](content/platform/review/reference/links.mdx) — How the Review domain links to products, sellers, orders, and customers.
+- [Service reference](content/platform/review/reference/service.mdx) — The Review module service: CRUD methods and aggregate-rating helpers.
+- [Workflows](content/platform/review/reference/workflows.mdx) — Review workflows for creating, moderating, responding, and deleting.
+- [Lifecycle](content/platform/store/concepts/lifecycle.mdx) — Store statuses, transitions, scheduled closures, and premium.
+- [The store entity](content/platform/store/concepts/store-entity.mdx) — The seller record, its business identity, and its satellite data.
+- [Team & members](content/platform/store/concepts/team.mdx) — Members, roles, invites, and the many-to-many store relationship.
+- [Create a store](content/platform/store/guides/create-a-store.mdx) — Create a seller programmatically with createSellersWorkflow.
+- [Manage the team](content/platform/store/guides/manage-the-team.mdx) — Invite and add store members from server code.
+- [Moderate stores](content/platform/store/guides/moderate-a-store.mdx) — Approve, suspend, and terminate stores from server code.
+- [Store](content/platform/store/overview.mdx) — Manage sellers, their teams, and their lifecycle on the marketplace.
+- [Data models](content/platform/store/reference/data-models.mdx) — The data models owned by the Store (Seller) domain.
+- [Event reference](content/platform/store/reference/events.mdx) — Events emitted by the Store domain, for subscribers and side effects.
+- [Links to other modules](content/platform/store/reference/links.mdx) — How the Store (Seller) domain links to other modules across the marketplace.
+- [Service reference](content/platform/store/reference/service.mdx) — The Seller module service and its methods for working with records directly.
+- [Workflows](content/platform/store/reference/workflows.mdx) — Seller and member workflows, service methods, and events.
 - [Telemetry](content/telemetry.mdx) — Learn about the anonymous usage data collected by the Mercur CLI

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@mercurjs/docs",
-  "version": "2.2.1",
+  "version": "2.3.0-canary.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/mercurjs/mercur",

package/content/learn/concepts.mdx DELETED Viewed

@@ -1,84 +0,0 @@
----
-title: "Concepts"
-description: "Core concepts behind Mercur — from the Medusa foundation to blocks, panels, and the registry."
----
-Mercur is built on a small set of concepts. Familiarity with these establishes a common language when working with the platform.
-## Medusa
-[MedusaJS](https://medusajs.com) is the open-source commerce framework that powers Mercur's foundation. It handles products, pricing, carts, orders, payments, fulfillment, and promotions. Mercur does not replace any of this — it extends Medusa with marketplace-specific logic using Medusa's own extension model.
-## Admin Panel
-The admin panel is a React application for **marketplace operators**. It provides a dashboard to manage sellers, configure commission rates, moderate product requests, handle disputes, and monitor the overall marketplace. It is built with [Medusa UI](https://docs.medusajs.com/ui) components and can be extended with custom pages and components through the [Dashboard SDK](#dashboard-sdk).
-## Vendor Portal
-The vendor portal is a React application for **sellers**. Sellers use it to manage their products, process orders, configure shipping, track payouts, and handle returns. Like the admin panel, it is built on the Dashboard SDK and can be fully customized.
-## Storefront
-The storefront is the **customer-facing** application. It can be built with any frontend technology that consumes the Store API — Next.js, Remix, or any other framework. Mercur provides a ready-made storefront template to start from.
-## API Routes
-Mercur exposes three sets of HTTP endpoints:
-- **Admin API** (`/admin/*`) — Platform administration
-- **Vendor API** (`/vendor/*`) — Seller operations
-- **Store API** (`/store/*`) — Customer-facing storefront
-Each route is composed of a handler, middleware, query configuration, and validators.
-## Core Plugin
-The core plugin (`@mercurjs/core`) is the main package that contains all of Mercur's marketplace logic — modules, links, workflows, API routes, subscribers, and providers. It is installed as a standard MedusaJS plugin and serves as the foundation that blocks extend.
-## Modules
-Modules encapsulate data models and business logic for a specific domain. Each module is self-contained with its own models, service, and migrations. Mercur's marketplace modules include Seller, Commission, Offer, Payout, Product Attribute, Product Edit, Media, Custom Fields, and Search. They communicate through [Links](#links) and [Workflows](#workflows), never directly. Additional domains — such as Reviews — ship as installable [blocks](#blocks) from the registry rather than inside the core plugin.
-## Master Products
-Products form a single **shared catalog** for the whole marketplace — a product is not owned by the seller who created it. Sellers gain the right to sell a product through eligibility assignments and sell it through [offers](#offers). See [Products](/rc/learn/products).
-## Offers
-An offer is a seller's sellable listing against a master product: their own SKU, price, inventory, and shipping profile. Many sellers can hold competing offers on the same product. See [Offers](/rc/learn/offers).
-## Product Attributes
-A typed, operator-managed attribute catalog (select, text, unit, toggle) that products reference for structured data and storefront filtering. Variant-axis attributes are backed by Medusa's native global product options. See [Product Attributes](/rc/learn/attributes).
-## Product Requests
-Vendor product submissions and edits flow through a reviewable change-request pipeline — the operator confirms, declines, or requests revisions before anything touches the shared catalog. See [Product Requests & Approvals](/rc/learn/product-requests).
-## Links
-Links define relationships between Mercur modules and Medusa core entities without modifying either side. For example, a link connects a Medusa Product to a Mercur Seller — this is how the system knows which sellers are eligible to sell which products.
-## Workflows
-Workflows coordinate multi-step operations across modules. They support compensation (automatic rollback on failure) and hooks (extension points for custom logic). For example, the checkout workflow splits a cart by seller, creates separate orders, allocates payments, and calculates commissions — all as a single atomic operation.
-## Blocks
-Blocks are the unit of distribution in Mercur. Each block is a self-contained piece of functionality — a module, a workflow, an API route, a link, or a UI extension. When you install a block, the CLI copies its source code directly into your project. You own every line and can modify anything.
-## Registry
-A registry is a collection of blocks available for installation. The official Mercur registry (`@mercurjs`) provides all marketplace blocks. You can also create and host [custom registries](/rc/tools/cli#custom-registries) for your own blocks.
-## CLI
-The [Mercur CLI](/rc/tools/cli) (`@mercurjs/cli@latest`) manages your project — scaffolding from templates, installing blocks, searching registries, generating types, and diffing local changes against upstream versions.
-## Dashboard SDK
-The [Dashboard SDK](/rc/tools/dashboard-sdk) (`@mercurjs/dashboard-sdk`) is a Vite plugin shared by the admin panel and vendor portal. It provides file-based routing, automatic navigation generation, widget and custom-field extensions, and i18n support.
-## API Client
-The [API Client](/rc/tools/api-client) (`@mercurjs/client`) provides type-safe access to all Mercur API endpoints. Types are generated from your actual API routes using `bunx @mercurjs/cli@latest codegen`, so requests and responses are always in sync with your backend.