The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you own.
TypeScript b2b-marketplacecomposable-commerceecommerceenterpriseheadless-commercemarketplacemedusamedusajsmulti-vendortypescript
docs: make latest docs the canonical root (#904)
Jakub Sieradzki0ffec123a99c
diff --git a/README.md b/README.mdindex 8654e8f6b..84211ec23 100644--- a/README.md+++ b/README.md@@ -53,7 +53,7 @@ Mercur is built to be AI-agent friendly. Your AI coding assistant can use these- **llms.txt**: `https://docs.mercurjs.com/llms.txt` — machine-readable project summary- **AGENTS.md**: included in every project created with `mercurjs create` — gives agents instant project context- **Skills**: `.claude/skills/` shipped with templates — domain-specific patterns for Claude Code-- **AI Development Guide**: [docs.mercurjs.com/v2/ai-development/mcp](https://docs.mercurjs.com/v2/ai-development/mcp)+- **AI Development Guide**: [docs.mercurjs.com/v2/ai-development/mcp](https://docs.mercurjs.com/ai-development/mcp)## Why Choose Mercur?diff --git a/apps/docs/v2/ai-development/llms.mdx b/apps/docs/ai-development/llms.mdxsimilarity index 89%rename from apps/docs/v2/ai-development/llms.mdxrename to apps/docs/ai-development/llms.mdxindex 5ba87c957..e368582d1 100644--- a/apps/docs/v2/ai-development/llms.mdx+++ b/apps/docs/ai-development/llms.mdx@@ -65,6 +65,6 @@ Use this when you want to give an LLM the complete context in one shot — ideal| Approach | Best for ||----------|----------|| **llms.txt / llms-full.txt** | One-time context loading, tools without MCP support, offline use |-| **[MCP Server](/v2/ai-development/mcp)** | Live search, always up-to-date results, integrated AI environments |+| **[MCP Server](/ai-development/mcp)** | Live search, always up-to-date results, integrated AI environments |-For the best experience, use the [MCP server](/v2/ai-development/mcp) if your tool supports it. Fall back to llms.txt when MCP isn't available.+For the best experience, use the [MCP server](/ai-development/mcp) if your tool supports it. Fall back to llms.txt when MCP isn't available.diff --git a/apps/docs/v2/ai-development/mcp.mdx b/apps/docs/ai-development/mcp.mdxsimilarity index 97%rename from apps/docs/v2/ai-development/mcp.mdxrename to apps/docs/ai-development/mcp.mdxindex 450b25df8..974cb5448 100644--- a/apps/docs/v2/ai-development/mcp.mdx+++ b/apps/docs/ai-development/mcp.mdx@@ -148,4 +148,4 @@ Use it when you need to look up API references, understand how a module works, f| Approach | Best for ||----------|----------|| **MCP Server** | Live search, always up-to-date, integrated environments |-| **[llms.txt](/v2/ai-development/llms)** | Full context dump, tools without MCP, offline use |+| **[llms.txt](/ai-development/llms)** | Full context dump, tools without MCP, offline use |diff --git a/apps/docs/v2/ai-development/skills.mdx b/apps/docs/ai-development/skills.mdxsimilarity index 100%rename from apps/docs/v2/ai-development/skills.mdxrename to apps/docs/ai-development/skills.mdxdiff --git a/apps/docs/v2/blocks.mdx b/apps/docs/blocks.mdxsimilarity index 97%rename from apps/docs/v2/blocks.mdxrename to apps/docs/blocks.mdxindex 83e79901f..31dd638d7 100644--- a/apps/docs/v2/blocks.mdx+++ b/apps/docs/blocks.mdx@@ -144,8 +144,8 @@ mode: "custom"<div className="mt-10 p-5 rounded-xl border border-gray-200 dark:border-gray-800"><p className="text-sm text-gray-500 dark:text-gray-400 m-0">Blocks are copied directly into your project — no runtime dependencies on Mercur.- After installing, follow the setup steps in the <a href="/v2/developer-guide/blocks" className="text-gray-900 dark:text-gray-100 font-medium underline underline-offset-2">Developer Guide</a>.- Want to build your own? See the <a href="/v2/developer-guide/registry" className="text-gray-900 dark:text-gray-100 font-medium underline underline-offset-2">Registry Guide</a>.+ After installing, follow the setup steps in the <a href="/developer-guide/blocks" className="text-gray-900 dark:text-gray-100 font-medium underline underline-offset-2">Developer Guide</a>.+ Want to build your own? See the <a href="/developer-guide/registry" className="text-gray-900 dark:text-gray-100 font-medium underline underline-offset-2">Registry Guide</a>.</p></div>diff --git a/apps/docs/core-concepts/commission.mdx b/apps/docs/core-concepts/commission.mdxindex 4e596ba0d..257c26faf 100644--- a/apps/docs/core-concepts/commission.mdx+++ b/apps/docs/core-concepts/commission.mdx@@ -1,96 +1,158 @@----title: "Marketplace commission"+title: "Commission"+description: "How marketplace commissions work in Mercur — rates, rules, calculation, and the commission pipeline."----Marketplace admin can set commission rates in various combinations, which enables to charge different commission for different product types, categories, sellers etc.+Commissions are how the marketplace earns revenue. Rather than storing a single commission percentage, Mercur uses a **rule-based system** where commission rates are matched to line items and shipping methods based on configurable conditions.-# Commission rule reference types+## Commission rates-Each commission rule has its reference. A reference entity types are listed below. There are simple (one `reference_id` at once), and combined types, that take into account more than one reference at once. Each combination (`reference` and `reference_id`) are required to be unique.+A **CommissionRate** defines how much commission the marketplace takes. Each rate has a type, a target, and an optional set of rules that determine when it applies.-- `site` - default commission applied for all products in the marketplace, can be overriden by other rules,-- `product_type` - applied to products of specified type,-- `product_category` - applied to products from specified category,-- `seller+product_category` - applied to products from specified category, and sold by specified seller,-- `seller+product_type` - applied to products of specified type, and sold by specified seller,-- `seller` - applied to products sold by specified seller.+| Field | Description |+|-------|-------------|+| `name` | Human-readable name (e.g. "Default Product Commission") |+| `code` | Unique system identifier |+| `type` | `FIXED` (flat amount) or `PERCENTAGE` |+| `target` | `ITEM` (applies to line items) or `SHIPPING` (applies to shipping methods) |+| `value` | The rate value — either a fixed amount or a percentage |+| `min_amount` | Optional minimum commission (floor) |+| `include_tax` | Whether to include tax in the base amount for calculation |+| `priority` | Higher priority rates are evaluated first |+| `currency_code` | Optional — restricts the rate to a specific currency |-# Commission rules priority+## Commission rules-Multiple different condition rates can be applied to each of the items in order. That's why some of the rules are more important that others, and during commission calculation process only one is applied. Rule reference types priority is described below.+Rules determine **when** a rate applies. A rate without rules acts as a **default** — it applies to all items or shipping methods of its target type. Rules narrow the scope.-1. `seller+product_type`-2. `seller+product_category`-3. `seller`-4. `product_type`-5. `product_category`-6. `site`+Each rule has a `reference` (the type of condition) and a `reference_id` (the value to match):-# Commission rate+| Reference | Matches against |+|-----------|----------------|+| `product` | A specific product ID |+| `product_type` | Products of a given type |+| `product_collection` | Products in a collection |+| `product_category` | Products in a category |+| `seller` | Products owned by a specific seller |+| `shipping_option_type` | Shipping options of a given type |-Each rule should have applicable rate attached. Commission rate entity describes the details on how the commission should be calculated. Available options:+A single rate can have multiple rules. The rate applies if **any** of its rules match.-- `type` - `flat` or `percentage`-- `percentage_rate` - applicable if `type` is `percentage`-- `include_tax` - indicates if commission should be calculated including tax-- `price_set_id` - applicable if `type` is `flat`-- `max_price_set_id` - maximum commission value-- `min_price_set_id` - minimum commission value+### Priority and matching-# Commission rate types+Rates are evaluated in **descending priority order**. The first matching rate wins — subsequent rates are not applied. This lets you set up specific overrides with high priority and catch-all defaults with low priority.-- `flat` - share for marketplace is a fixed amount,-- `percentage` - share for marketplace is a percent of price.+**Example configuration:**-# Calculation+| Rate | Priority | Rules | Type | Value |+|------|----------|-------|------|-------|+| Electronics Commission | 10 | `product_category: "electronics"` | Percentage | 12% |+| Premium Seller Rate | 5 | `seller: "slr_abc123"` | Percentage | 8% |+| Default Commission | 0 | _(none — matches all)_ | Percentage | 15% |-```mermaid-flowchart LR+An electronics product from the premium seller would match the Electronics Commission rate (priority 10), not the seller-specific rate (priority 5).-id1(Take order line_item)-id2(Select applicable rule)-id3{Select associated rate}-id4a(Select appropiate price from price_set, return as a value)-id4b(Calculate % of the line_item price, return as a value)-id5(Clamp commission value between min_price/max_price)-id6(Save commission_line)+## The calculation pipeline+The `getCommissionLines` method calculates commissions for a given cart or order context:-id1-->id2-id2-->id3-id3--type == flat-->id4a-id3--type == percentage-->id4b-id4a-->id5-id4b-->id5-id5-->id6+**1. Load rates**+- All enabled commission rates are loaded with their rules, ordered by priority (highest first)+- Rates are separated into `ITEM` and `SHIPPING` targets+**2. Match items**+- For each line item, the system iterates through item-target rates in priority order+- It checks each rate's rules against the item's product, type, collection, category, and seller+- Rates with no rules match everything (defaults)+- First match wins++**3. Calculate amount**+- Base amount is the item subtotal (optionally including tax if `include_tax` is true)+- For `PERCENTAGE` rates: `commission = (base_amount × value) / 100`+- For `FIXED` rates: `commission = value`+- If the result is below `min_amount`, the minimum is used instead++**4. Match and calculate shipping**+- Same process repeats for shipping methods using shipping-target rates+- Matches against `shipping_option_type` rules++**5. Output**+- Returns an array of `CommissionLine` records, one per item and shipping method++<Info>+ All commission calculations use `BigNumber` arithmetic for precision. This is critical for financial accuracy — standard floating-point math can introduce rounding errors.+</Info>++## API examples++### Create a commission rate (Admin API)++```bash+curl -X POST http://localhost:9000/admin/commission-rates \+ -H "Authorization: Bearer <admin-token>" \+ -H "Content-Type: application/json" \+ -d '{+ "name": "Default Product Commission",+ "code": "default-product",+ "type": "percentage",+ "target": "item",+ "value": 15,+ "priority": 0+ }'+```++### Create a rate with rules (Admin API)++```bash+curl -X POST http://localhost:9000/admin/commission-rates \+ -H "Authorization: Bearer <admin-token>" \+ -H "Content-Type: application/json" \+ -d '{+ "name": "Electronics Commission",+ "code": "electronics",+ "type": "percentage",+ "target": "item",+ "value": 12,+ "priority": 10,+ "rules": [+ {+ "reference": "product_category",+ "reference_id": "pcat_electronics"+ }+ ]+ }'```-# Database models--```mermaid-erDiagram- commission_rule ||--o| commission_rate : has- commission_rule {- uuid id- string name- string reference- string reference_id- }- commission_rate {- uuid id- string type- float percentage_rate- bool include_tax- string price_set_id- string max_price_set_id- string min_price_set_id- }- commission_line {- uuid id- string item_line_id- string rule_id- string currency_code- float value- }+### List commission rates++```bash+curl http://localhost:9000/admin/commission-rates \+ -H "Authorization: Bearer <admin-token>"```++## Commission lines++A **CommissionLine** is the calculated commission for a single line item or shipping method. It stores:++| Field | Description |+|-------|-------------|+| `item_id` | References the order line item or shipping method |+| `commission_rate_id` | The rate that was applied |+| `code` | Code of the applied rate |+| `rate` | The actual rate value used |+| `amount` | The calculated commission amount |++Commission lines are linked to order line items via a **read-only link**. This means you can query an order's line items and include their commission data in a single request.++## How commission connects to payouts++Commission lines are the bridge between orders and seller earnings:++1. An order is completed → commission lines are calculated for each item+2. When the order is credited to the seller's payout account, the total commission is subtracted:+ ```+ seller_earnings = order.total - sum(commission_line.amount)+ ```+3. The marketplace retains the commission amount++This separation means commission rates can be changed at any time without affecting already-calculated orders — the `CommissionLine` records serve as a permanent audit trail.diff --git a/apps/docs/core-concepts/order-groups.mdx b/apps/docs/core-concepts/order-groups.mdxnew file mode 100644index 000000000..93fc62f15--- /dev/null+++ b/apps/docs/core-concepts/order-groups.mdx@@ -0,0 +1,114 @@+---+title: "Order Groups"+description: "How multi-seller checkout creates order groups — the container that ties a single cart to multiple seller orders."+---++An order group is a container created during checkout when a customer buys from multiple sellers. It groups the individual per-seller orders that originate from a single cart, giving customers and admins a unified view of what was purchased.++## Data model++| Field | Type | Description |+|-------|------|-------------|+| `id` | `text` | Unique identifier (prefix `og_`) |+| `display_id` | `serial` | Auto-incrementing human-readable ID |+| `customer_id` | `text` | The customer who placed the order (nullable) |+| `cart_id` | `text` | The cart this order group originated from |+| `seller_count` | `number` | Number of distinct sellers in the group (computed) |+| `total` | `bigNumber` | Sum of all order totals in the group (computed) |++<Info>+ `seller_count` and `total` are **computed fields** — they are calculated from linked orders at query time, not stored as columns. `seller_count` is the count of distinct sellers across all orders in the group, and `total` is the sum of each order's `current_order_total` from the order summary.+</Info>++## Relationships++Order groups connect to other entities through two links:++### Cart (read-only)++Links the order group back to its originating cart via the `cart_id` field. This is a read-only link — carts are immutable after checkout.++```+order_group.cart_id → cart.id+```++### Orders (one-to-many)++Links the order group to multiple orders through a join table `order_group_order`. Each order in the group belongs to a different seller.++```+order_group ←→ order (via order_group_order)+```++## How order groups are created++Order groups are created automatically during checkout by the `completeCartWithSplitOrdersWorkflow`. This is what happens when a customer completes a cart containing products from multiple sellers:++1. **Lock** — The workflow acquires a lock on the cart to prevent double-processing+2. **Group by seller** — Cart items are grouped by seller (via the product-seller link)+3. **Create orders** — A separate Medusa order is created for each seller, containing only that seller's items and shipping+4. **Create order group** — An order group is created with the customer and cart references+5. **Link everything** — The workflow creates links between:+ - Each order and the order group+ - Each order and its seller+ - Each order and the cart's payment collection+ - Each seller and the customer (if new relationship)+6. **Finalize** — Inventory is reserved, payment is authorized, and the `order_group.created` event is emitted++<Info>+ Payment collections are linked at the **individual order level**, not on the order group. This is a deliberate design decision — each per-seller order gets its own link to the payment collection, which enables per-order capture and refund flows.+</Info>++## Events++| Event | Payload | When |+|-------|---------|------|+| `order_group.created` | `{ id: string }` | After checkout creates a new order group |++## API endpoints++### List order groups (Admin)++```bash+curl http://localhost:9000/admin/order-groups \+ -H "Authorization: Bearer <admin-token>"+```++Supports filtering by `customer_id`, `seller_id`, `status`, `sales_channel_id`, and `created_at`. Paginated with `offset` and `limit` (default 50).++### Get order group detail (Admin)++```bash+curl http://localhost:9000/admin/order-groups/<order-group-id> \+ -H "Authorization: Bearer <admin-token>"+```++Returns the order group with aggregated payment and fulfillment statuses across all orders.++### List order groups (Store)++```bash+curl http://localhost:9000/store/order-groups \+ -H "Authorization: Bearer <customer-token>"+```++Returns only order groups belonging to the authenticated customer. Includes nested order data with items, variants, products, and seller information.++### Get order group detail (Store)++```bash+curl http://localhost:9000/store/order-groups/<order-group-id> \+ -H "Authorization: Bearer <customer-token>"+```++Returns a single order group. Throws `404` if the order group doesn't belong to the authenticated customer.++## Workflows++| Workflow | Purpose |+|----------|---------|+| `getOrderGroupsListWorkflow` | Retrieves a paginated list of order groups with aggregated payment and fulfillment statuses for each |+| `getOrderGroupDetailWorkflow` | Retrieves a single order group with full order details and aggregated statuses |+| `createOrderGroupStep` | Internal step used by `completeCartWithSplitOrdersWorkflow` — not called directly |++The list and detail workflows automatically inject order-related fields (items, payment collections, fulfillments) and compute an overall `payment_status` and `fulfillment_status` for each order group by aggregating across all linked orders.diff --git a/apps/docs/v2/core-concepts/payout.mdx b/apps/docs/core-concepts/payout.mdxsimilarity index 100%rename from apps/docs/v2/core-concepts/payout.mdxrename to apps/docs/core-concepts/payout.mdxdiff --git a/apps/docs/v2/core-concepts/seller-members.mdx b/apps/docs/core-concepts/seller-members.mdxsimilarity index 95%rename from apps/docs/v2/core-concepts/seller-members.mdxrename to apps/docs/core-concepts/seller-members.mdxindex e4fbb18b1..9026adceb 100644--- a/apps/docs/v2/core-concepts/seller-members.mdx+++ b/apps/docs/core-concepts/seller-members.mdx@@ -59,4 +59,4 @@ Both **operators** and **seller admins** can remove members, subject to the cons- A seller account must have **at least one member** with admin access at all times- **Email addresses** must be unique within a single seller account-- Members are managed through the [seller account lifecycle](/v2/core-concepts/seller) — if a seller is terminated, all member associations are effectively void+- Members are managed through the [seller account lifecycle](/core-concepts/seller) — if a seller is terminated, all member associations are effectively voiddiff --git a/apps/docs/core-concepts/seller.mdx b/apps/docs/core-concepts/seller.mdxindex 20695690a..67048b09c 100644--- a/apps/docs/core-concepts/seller.mdx+++ b/apps/docs/core-concepts/seller.mdx@@ -1,137 +1,118 @@---title: "Seller"+description: "The central marketplace actor — seller profile, lifecycle, registration flows, and business rules."----Mercur comes with a `Seller` module that allows you to manage seller products, team members, orders, stock locations and shipping options.--# Entities--- `Seller`-- `Member`-- `Invite`-- `Onboarding`--# Seller--In Mercur, the `Seller` is the entity that represents member group in the marketplace.-You can think of a seller as a group of members that share the same products, orders etc.--Seller can be in state `ACTIVE`, which allows him to use the platform, or in state `SUSPENDED`, which prevents him from using the platform, except order and fulfillment management.--By default, a seller is linked to Medusa's default entities such as:--- `Product`-- `Order`-- `Return`-- `Stock Location`-- `Service Zone`-- `Shipping Option`-- `Shipping Profile`-- `Fulfillment Set`-- `Promotion`-- `Campaign`-- `Price List`-- `Customer Group`-- `Inventory Item`--```mermaid-graph LR- subgraph SellerModule[Seller Module]- Seller- end-- subgraph InventoryModule[Inventory Module]- InventoryItem- end-- subgraph CustomerModule[Customer Module]- CustomerGroup- end-- subgraph PricingModule[Pricing Module]- PriceList- end-- subgraph PromotionModule[Promotion Module]- Promotion- Campaign- end-- subgraph ProductModule[Product Module]- Product- end-- subgraph OrderModule[Order Module]- Return- Order- end-- subgraph FulfillmentModule[Fulfillment Module]- ServiceZone- ShippingOption- ShippingProfile- FulfillmentSet- end-- subgraph StockLocationModule[Stock Location Module]- StockLocation- end-- Seller --> Product- Seller --> Order- Seller --> Return- Seller --> ServiceZone- Seller --> ShippingOption- Seller --> ShippingProfile- Seller --> StockLocation- Seller --> FulfillmentSet- Seller --> Promotion- Seller --> Campaign- Seller --> PriceList- Seller --> CustomerGroup- Seller --> InventoryItem-```+A **seller** is the central actor in a Mercur marketplace. Every product listing, order, payout, and storefront presence traces back to a seller account. This page covers the seller data model, lifecycle, and the business rules that govern how sellers operate on the platform.-# Member+## Seller Profile-`Member` is the entity that represents a user in the marketplace that can manage seller products, orders, service zones etc.+Each seller account holds the following core fields:-```mermaid-graph TD- subgraph SellerModule[Seller Module]- Seller- Member- end- Seller -->|One-to-Many| Member-```+| Field | Description |+| --------------- | ----------------------------------------------------------------------------- |+| `name` | Display name shown to customers on the storefront (unique) |+| `handle` | URL-friendly identifier for the seller (unique) |+| `email` | Primary contact email for the seller account (unique) |+| `description` | Free-text seller description, typically shown on the seller's storefront page |+| `logo` | Seller logo or avatar |+| `banner` | Banner image for the seller's storefront page |+| `website_url` | Seller's external website |+| `currency_code` | The single currency in which this seller operates |+| `is_premium` | Operator-designated premium seller flag (see below) |+| `status_reason` | Optional explanation for the current status (e.g. reason for suspension) |+| `external_id` | Identifier in an external system (unique, optional) |+| `metadata` | Arbitrary JSON metadata |-# Member Invite-`Member Invite` is the entity that represents a pending member invitation to a seller in the marketplace.+### Single Currency Per Account-```mermaid-graph TD- subgraph SellerModule[Seller Module]- Seller- Invite- end+Every seller account is locked to **one currency**. Prices, payouts, and subscription billing all use this currency. This constraint keeps financial reporting simple and eliminates exchange-rate ambiguity in payouts.- Seller -->|One-to-Many| Invite+If a seller needs to trade in multiple currencies, the recommended pattern is to create **separate seller accounts** — one per currency. Each account operates independently with its own products, orders, and payouts.-```+### Professional Sellers++A seller can optionally have associated **professional details**. If present, the seller is treated as a registered business; if absent, the seller is an individual.-# Onboarding+## Address and Payment Information-`Onboarding` is the entity that holds the information about current state of the onboarding of a seller.+Sellers can store one or more **addresses** (warehouse, return, business) and **payment details** used for payout processing. These are managed as sub-resources of the seller account and are referenced by workflows such as fulfillment and payout settlement.-```mermaid-graph TD- subgraph SellerModule[Seller Module]- Seller- Onboarding- end+## Seller Lifecycle- Seller -->|One-to-One| Onboarding+A seller account moves through **four statuses** over its lifetime:```+ ┌──────────────────┐+ │ pending_approval │+ └────────┬─────────┘+ │ approve+ ▼+ ┌──────────┐ ┌────────┐+ │ suspended │◄────►│ open │+ └──────────┘ └───┬────┘+ │ terminate+ ▼+ ┌────────────┐+ │ terminated │+ └────────────┘+```++### Status Definitions++- `**pending_approval**` — The seller has registered but has not yet been reviewed by the platform operator.+- `**open**` — The seller is active and may list products, receive orders, and collect payouts.+- `**suspended**` — The seller's operations are temporarily frozen. Products remain in the catalog but cannot be purchased.+- `**terminated**` — The seller account is permanently closed. This status is irreversible.++### Status Transition Rules+++| From | To | Who | Conditions |+| ------------------ | ------------ | ----------------- | --------------------------------------------------------- |+| `pending_approval` | `open` | Operator | Operator reviews and approves the application |+| `open` | `suspended` | Operator | Policy violation, compliance hold, or operator discretion |+| `suspended` | `open` | Operator | Issue resolved, seller reinstated |+| `open` | `terminated` | Operator / Seller | All prerequisites met (see below) |+| `suspended` | `terminated` | Operator | All prerequisites met (see below) |+++## Scheduled Closures++Sellers can schedule **temporary closures** without changing their account status. Two date fields control this:++- `closed_from` — The date the closure begins+- `closed_to` — The date the closure ends++During a scheduled closure the seller's storefront shows as unavailable and new orders cannot be placed, but the account remains in `open` status. This is designed for holidays, seasonal breaks, or planned downtime. Once `closed_to` passes, the seller automatically resumes normal operation.++Scheduled closures are **not a status** — they overlay on top of the current status and do not affect status transition rules.++## Premium Sellers++The `is_premium` flag is set **exclusively by the platform operator**. Sellers cannot designate themselves as premium. This flag is used for storefront features such as:++- Featured placement in search results or category pages+- Visual badges or highlights on the seller's profile+- Priority in marketplace curation++The specific storefront behavior tied to premium status is determined by the frontend implementation.++## Registration Flows++There are **two methods** for creating a seller account:++1. **Operator-created** — The platform operator creates the seller account directly via the admin dashboard. The account can be set to `open` immediately, bypassing `pending_approval`.+2. **Self-registration** — The seller registers through the public-facing registration flow. The account enters `pending_approval` status and waits for operator review.++## Business Rules Summary++- A seller account operates in **exactly one currency**+- The presence of `professional_details` determines whether the seller is a registered business+- Only the **operator** can approve, suspend, or reinstate sellers+- **Termination** is irreversible and requires all orders and payouts to be resolved+- Scheduled closures are **date-driven** and do not change account status+- **Premium** designation is operator-only and influences storefront presentation+- Every seller account must have at least one [member](/core-concepts/seller-members) with an admin rolediff --git a/apps/docs/v2/core-concepts/subscriptions.mdx b/apps/docs/core-concepts/subscriptions.mdxsimilarity index 91%rename from apps/docs/v2/core-concepts/subscriptions.mdxrename to apps/docs/core-concepts/subscriptions.mdxindex 53cdcce37..fa879636f 100644--- a/apps/docs/v2/core-concepts/subscriptions.mdx+++ b/apps/docs/core-concepts/subscriptions.mdx@@ -30,7 +30,7 @@ When subscriptions are enabled, the operator defines a **default plan** for each### How the Default Plan Works-When a new [seller](/v2/core-concepts/seller) account is approved, the system automatically assigns the default plan matching the seller's currency. The seller begins their subscription immediately, starting with any configured free months.+When a new [seller](/core-concepts/seller) account is approved, the system automatically assigns the default plan matching the seller's currency. The seller begins their subscription immediately, starting with any configured free months.The `requires_orders` flag is designed for marketplaces that want to avoid charging inactive sellers. When this flag is set, a billing cycle with zero orders produces no invoice — the seller is effectively not charged for that month.@@ -66,7 +66,7 @@ If the start date falls on the 29th, 30th, or 31st, billing rolls to the last da### Billing Across Statuses-Subscription billing continues regardless of the seller's [account status](/v2/core-concepts/seller), with one exception:+Subscription billing continues regardless of the seller's [account status](/core-concepts/seller), with one exception:| Status | Billed? | Notes |@@ -87,5 +87,5 @@ Persistent negative balances may be grounds for suspension or termination at the## Relationship to Other Concepts-- **Seller accounts** determine which default plan applies based on `currency_code` (see [Seller](/v2/core-concepts/seller))-- Subscription status is independent of [member management](/v2/core-concepts/seller-members) — adding or removing members does not affect billing+- **Seller accounts** determine which default plan applies based on `currency_code` (see [Seller](/core-concepts/seller))+- Subscription status is independent of [member management](/core-concepts/seller-members) — adding or removing members does not affect billingdiff --git a/apps/docs/v2/developer-guide/api-client.mdx b/apps/docs/developer-guide/api-client.mdxsimilarity index 100%rename from apps/docs/v2/developer-guide/api-client.mdxrename to apps/docs/developer-guide/api-client.mdxdiff --git a/apps/docs/v2/developer-guide/blocks.mdx b/apps/docs/developer-guide/blocks.mdxsimilarity index 93%rename from apps/docs/v2/developer-guide/blocks.mdxrename to apps/docs/developer-guide/blocks.mdxindex 2fb5b04a2..1d60e859f 100644--- a/apps/docs/v2/developer-guide/blocks.mdx+++ b/apps/docs/developer-guide/blocks.mdx@@ -12,7 +12,7 @@ bunx @mercurjs/cli@latest add reviewsbunx @mercurjs/cli@latest add wishlist product-import-export```-The CLI fetches the block from the [registry](/v2/developer-guide/registry), resolves dependencies, transforms imports to match your project's path aliases, and copies the files into the right directories.+The CLI fetches the block from the [registry](/developer-guide/registry), resolves dependencies, transforms imports to match your project's path aliases, and copies the files into the right directories.## What's inside a blockdiff --git a/apps/docs/v2/developer-guide/cli.mdx b/apps/docs/developer-guide/cli.mdxsimilarity index 98%rename from apps/docs/v2/developer-guide/cli.mdxrename to apps/docs/developer-guide/cli.mdxindex 1d0995c8f..15ee09077 100644--- a/apps/docs/v2/developer-guide/cli.mdx+++ b/apps/docs/developer-guide/cli.mdx@@ -109,7 +109,7 @@ bunx @mercurjs/cli@latest add wishlist --overwrite### codegen-Generate TypeScript types from your API routes. Used by the [API Client](/v2/developer-guide/api-client) for type-safe requests.+Generate TypeScript types from your API routes. Used by the [API Client](/developer-guide/api-client) for type-safe requests.```bashbunx @mercurjs/cli@latest codegendiff --git a/apps/docs/v2/developer-guide/custom-fields.mdx b/apps/docs/developer-guide/custom-fields.mdxsimilarity index 100%rename from apps/docs/v2/developer-guide/custom-fields.mdxrename to apps/docs/developer-guide/custom-fields.mdxdiff --git a/apps/docs/v2/developer-guide/extending-panels.mdx b/apps/docs/developer-guide/extending-panels.mdxsimilarity index 100%rename from apps/docs/v2/developer-guide/extending-panels.mdxrename to apps/docs/developer-guide/extending-panels.mdxdiff --git a/apps/docs/v2/developer-guide/overview.mdx b/apps/docs/developer-guide/overview.mdxsimilarity index 100%rename from apps/docs/v2/developer-guide/overview.mdxrename to apps/docs/developer-guide/overview.mdxdiff --git a/apps/docs/v2/developer-guide/registry.mdx b/apps/docs/developer-guide/registry.mdxsimilarity index 100%rename from apps/docs/v2/developer-guide/registry.mdxrename to apps/docs/developer-guide/registry.mdxdiff --git a/apps/docs/docs.json b/apps/docs/docs.jsonindex 1e78d41af..10ab757a8 100644--- a/apps/docs/docs.json+++ b/apps/docs/docs.json@@ -35,7 +35,7 @@{"group": "Welcome","pages": [- "v2/welcome"+ "welcome"]}]@@ -46,60 +46,60 @@{"group": "Getting started","pages": [- "v2/getting-started/introduction",- "v2/getting-started/concepts",- "v2/getting-started/installation"+ "getting-started/introduction",+ "getting-started/concepts",+ "getting-started/installation"]},{"group": "Core Concepts","pages": [- "v2/core-concepts/seller",- "v2/core-concepts/seller-members",- "v2/core-concepts/subscriptions",- "v2/core-concepts/payout",- "v2/core-concepts/commission",- "v2/core-concepts/order-groups"+ "core-concepts/seller",+ "core-concepts/seller-members",+ "core-concepts/subscriptions",+ "core-concepts/payout",+ "core-concepts/commission",+ "core-concepts/order-groups"]},{"group": "Developer Guide","pages": [- "v2/developer-guide/overview",- "v2/developer-guide/blocks",- "v2/developer-guide/registry",- "v2/developer-guide/api-client",- "v2/developer-guide/cli",- "v2/developer-guide/extending-panels",- "v2/developer-guide/custom-fields"+ "developer-guide/overview",+ "developer-guide/blocks",+ "developer-guide/registry",+ "developer-guide/api-client",+ "developer-guide/cli",+ "developer-guide/extending-panels",+ "developer-guide/custom-fields"]},{"group": "How-to Guides","pages": [- "v2/how-to-guides/stripe-connect-integration"+ "how-to-guides/stripe-connect-integration"]},{"group": "Migration","pages": [- "v2/migrations/overview",- "v2/migrations/from-2-0-to-2-1",- "v2/migrations/from-1-x-to-2-0"+ "migrations/overview",+ "migrations/from-2-0-to-2-1",+ "migrations/from-1-x-to-2-0"]},{"group": "AI Development","pages": [- "v2/ai-development/llms",- "v2/ai-development/mcp",- "v2/ai-development/skills"+ "ai-development/llms",+ "ai-development/mcp",+ "ai-development/skills"]},{"group": "Legal","pages": [- "v2/telemetry"+ "telemetry"]}]@@ -110,13 +110,13 @@{"group": "Admin Panel","pages": [- "v2/user-guides/admin/stores"+ "user-guides/admin/stores"]},{"group": "Vendor Panel","pages": [- "v2/user-guides/vendor/stores"+ "user-guides/vendor/stores"]}]@@ -141,38 +141,38 @@{"group": "Quick start","pages": [- "introduction",- "get-started"+ "v1/introduction",+ "v1/get-started"]},{"group": "Components","pages": [- "components/backend",- "components/admin-panel",- "components/vendor-panel",- "components/storefront"+ "v1/components/backend",+ "v1/components/admin-panel",+ "v1/components/vendor-panel",+ "v1/components/storefront"]},{"group": "Core Concepts","pages": [- "core-concepts/seller",- "core-concepts/order-splitting",- "core-concepts/payouts",- "core-concepts/commission",- "core-concepts/marketplace-settings",- "core-concepts/requests",- "core-concepts/reviews",- "core-concepts/notifications"+ "v1/core-concepts/seller",+ "v1/core-concepts/order-splitting",+ "v1/core-concepts/payouts",+ "v1/core-concepts/commission",+ "v1/core-concepts/marketplace-settings",+ "v1/core-concepts/requests",+ "v1/core-concepts/reviews",+ "v1/core-concepts/notifications"]},{"group": "Product","pages": [- "product/framework",- "product/core-commerce-modules",- "product/core-infrastructure-modules",+ "v1/product/framework",+ "v1/product/core-commerce-modules",+ "v1/product/core-infrastructure-modules",{"group": "Mercur marketplace modules","pages": [@@ -182,82 +182,82 @@{"group": "Attribute module","pages": [- "product/modules/b2c-core/attribute/attribute-concept",- "product/modules/b2c-core/attribute/attribute-links",- "product/modules/b2c-core/attribute/attributes-data-models-ref",- "product/modules/b2c-core/attribute/attributes-services"+ "v1/product/modules/b2c-core/attribute/attribute-concept",+ "v1/product/modules/b2c-core/attribute/attribute-links",+ "v1/product/modules/b2c-core/attribute/attributes-data-models-ref",+ "v1/product/modules/b2c-core/attribute/attributes-services"]},{"group": "Configuration module","pages": [- "product/modules/b2c-core/configuration/configuration-concept",- "product/modules/b2c-core/configuration/configuration-data-models-ref",- "product/modules/b2c-core/configuration/configuration-services"+ "v1/product/modules/b2c-core/configuration/configuration-concept",+ "v1/product/modules/b2c-core/configuration/configuration-data-models-ref",+ "v1/product/modules/b2c-core/configuration/configuration-services"]},{"group": "Marketplace module","pages": [- "product/modules/b2c-core/marketplace/marketplace-concept",- "product/modules/b2c-core/marketplace/marketplace-links",- "product/modules/b2c-core/marketplace/marketplace-data-model-reference",- "product/modules/b2c-core/marketplace/marketplace-service"+ "v1/product/modules/b2c-core/marketplace/marketplace-concept",+ "v1/product/modules/b2c-core/marketplace/marketplace-links",+ "v1/product/modules/b2c-core/marketplace/marketplace-data-model-reference",+ "v1/product/modules/b2c-core/marketplace/marketplace-service"]},{"group": "Payout module","pages": [- "product/modules/b2c-core/payout/payout-concept",- "product/modules/b2c-core/payout/payout-links",- "product/modules/b2c-core/payout/payout-data-model-reference",- "product/modules/b2c-core/payout/payout-services"+ "v1/product/modules/b2c-core/payout/payout-concept",+ "v1/product/modules/b2c-core/payout/payout-links",+ "v1/product/modules/b2c-core/payout/payout-data-model-reference",+ "v1/product/modules/b2c-core/payout/payout-services"]},{"group": "Secondary Category Module","pages": [- "product/modules/b2c-core/secondary-categories/secondary-categories-concept",- "product/modules/b2c-core/secondary-categories/secondary-category-links",- "product/modules/b2c-core/secondary-categories/sec-cat-data-model-reference",- "product/modules/b2c-core/secondary-categories/secondary-category-services"+ "v1/product/modules/b2c-core/secondary-categories/secondary-categories-concept",+ "v1/product/modules/b2c-core/secondary-categories/secondary-category-links",+ "v1/product/modules/b2c-core/secondary-categories/sec-cat-data-model-reference",+ "v1/product/modules/b2c-core/secondary-categories/secondary-category-services"]},{"group": "Seller module","pages": [- "product/modules/b2c-core/seller/seller-concept",- "product/modules/b2c-core/seller/seller-module-options",- "product/modules/b2c-core/seller/seller-links",- "product/modules/b2c-core/seller/seller-data-model-reference",- "product/modules/b2c-core/seller/seller-services"+ "v1/product/modules/b2c-core/seller/seller-concept",+ "v1/product/modules/b2c-core/seller/seller-module-options",+ "v1/product/modules/b2c-core/seller/seller-links",+ "v1/product/modules/b2c-core/seller/seller-data-model-reference",+ "v1/product/modules/b2c-core/seller/seller-services"]},{"group": "Split Order Payment Module","pages": [- "product/modules/b2c-core/split-order-payment/split-order-payment-concept",- "product/modules/b2c-core/split-order-payment/split-order-links",- "product/modules/b2c-core/split-order-payment/split-order-data-model-reference",- "product/modules/b2c-core/split-order-payment/split-order-services"+ "v1/product/modules/b2c-core/split-order-payment/split-order-payment-concept",+ "v1/product/modules/b2c-core/split-order-payment/split-order-links",+ "v1/product/modules/b2c-core/split-order-payment/split-order-data-model-reference",+ "v1/product/modules/b2c-core/split-order-payment/split-order-services"]},{"group": "Taxcode module","pages": [- "product/modules/b2c-core/taxcode/taxcode-concept",- "product/modules/b2c-core/taxcode/taxcode-links",- "product/modules/b2c-core/taxcode/taxcode-data-model-reference",- "product/modules/b2c-core/taxcode/taxcode-services"+ "v1/product/modules/b2c-core/taxcode/taxcode-concept",+ "v1/product/modules/b2c-core/taxcode/taxcode-links",+ "v1/product/modules/b2c-core/taxcode/taxcode-data-model-reference",+ "v1/product/modules/b2c-core/taxcode/taxcode-services"]},{"group": "Wishlist module","pages": [- "product/modules/b2c-core/wishlist/wishlist-concept",- "product/modules/b2c-core/wishlist/wishlist-links",- "product/modules/b2c-core/wishlist/wishlist-data-model-reference",- "product/modules/b2c-core/wishlist/wishlist-services"+ "v1/product/modules/b2c-core/wishlist/wishlist-concept",+ "v1/product/modules/b2c-core/wishlist/wishlist-links",+ "v1/product/modules/b2c-core/wishlist/wishlist-data-model-reference",+ "v1/product/modules/b2c-core/wishlist/wishlist-services"]}]@@ -268,9 +268,9 @@{"group": "Commission module","pages": [- "product/modules/commission/commission/commission-concept",- "product/modules/commission/commission/commission-data-model-reference",- "product/modules/commission/commission/commission-services"+ "v1/product/modules/commission/commission/commission-concept",+ "v1/product/modules/commission/commission/commission-data-model-reference",+ "v1/product/modules/commission/commission/commission-services"]}]@@ -281,19 +281,19 @@{"group": "Request module","pages": [- "product/modules/requests/requests/requests-concept",- "product/modules/requests/requests/requests-links",- "product/modules/requests/requests/request-data-model-reference",- "product/modules/requests/requests/requests-services"+ "v1/product/modules/requests/requests/requests-concept",+ "v1/product/modules/requests/requests/requests-links",+ "v1/product/modules/requests/requests/request-data-model-reference",+ "v1/product/modules/requests/requests/requests-services"]},{"group": "Order Return Request module","pages": [- "product/modules/requests/order-return-request/order-return-request",- "product/modules/requests/order-return-request/order-return-request-links",- "product/modules/requests/order-return-request/order-return-request-data-model-reference",- "product/modules/requests/order-return-request/order-return-request-services"+ "v1/product/modules/requests/order-return-request/order-return-request",+ "v1/product/modules/requests/order-return-request/order-return-request-links",+ "v1/product/modules/requests/order-return-request/order-return-request-data-model-reference",+ "v1/product/modules/requests/order-return-request/order-return-request-services"]}]@@ -304,10 +304,10 @@{"group": "Reviews module","pages": [- "product/modules/reviews/reviews/reviews-concept",- "product/modules/reviews/reviews/review-links",- "product/modules/reviews/reviews/review-data-model-reference",- "product/modules/reviews/reviews/review-service"+ "v1/product/modules/reviews/reviews/reviews-concept",+ "v1/product/modules/reviews/reviews/review-links",+ "v1/product/modules/reviews/reviews/review-data-model-reference",+ "v1/product/modules/reviews/reviews/review-service"]}]@@ -320,69 +320,69 @@{"group": "Core","pages": [- "docs/product/workflows/core/price-list-workflows",- "docs/product/workflows/core/attribute",- "docs/product/workflows/core/campaign-workflows",- "docs/product/workflows/core/cart-workflows",- "docs/product/workflows/core/configuration-workflows",- "docs/product/workflows/core/customer-groups-workflows",- "docs/product/workflows/core/fulfillment-set-workflows",- "docs/product/workflows/core/order-workflows",- "docs/product/workflows/core/order-set-workflows",- "docs/product/workflows/core/payout-workflows",- "docs/product/workflows/core/product-workflows",- "docs/product/workflows/core/promotions-workflows",- "docs/product/workflows/core/seller-workflows",- "docs/product/workflows/core/split-order-payment",- "docs/product/workflows/core/wishlist-workflows",- "docs/product/workflows/core/common-workflows",- "docs/product/workflows/core/hooks"+ "v1/docs/product/workflows/core/price-list-workflows",+ "v1/docs/product/workflows/core/attribute",+ "v1/docs/product/workflows/core/campaign-workflows",+ "v1/docs/product/workflows/core/cart-workflows",+ "v1/docs/product/workflows/core/configuration-workflows",+ "v1/docs/product/workflows/core/customer-groups-workflows",+ "v1/docs/product/workflows/core/fulfillment-set-workflows",+ "v1/docs/product/workflows/core/order-workflows",+ "v1/docs/product/workflows/core/order-set-workflows",+ "v1/docs/product/workflows/core/payout-workflows",+ "v1/docs/product/workflows/core/product-workflows",+ "v1/docs/product/workflows/core/promotions-workflows",+ "v1/docs/product/workflows/core/seller-workflows",+ "v1/docs/product/workflows/core/split-order-payment",+ "v1/docs/product/workflows/core/wishlist-workflows",+ "v1/docs/product/workflows/core/common-workflows",+ "v1/docs/product/workflows/core/hooks"]},{"group": "Commission","pages": [- "docs/product/workflows/commission/commission-workflows"+ "v1/docs/product/workflows/commission/commission-workflows"]},{"group": "Requests","pages": [- "docs/product/workflows/requests/requests",- "docs/product/workflows/requests/order-return-request-workflows"+ "v1/docs/product/workflows/requests/requests",+ "v1/docs/product/workflows/requests/order-return-request-workflows"]},{"group": "Reviews","pages": [- "docs/product/workflows/reviews/review-workflows"+ "v1/docs/product/workflows/reviews/review-workflows"]}]},- "docs/product/js-sdk",- "docs/product/api",+ "v1/docs/product/js-sdk",+ "v1/docs/product/api",{"group": "Events","pages": [- "docs/product/events/core-events",- "docs/product/events/request-events",- "docs/product/events/reviews-events"+ "v1/docs/product/events/core-events",+ "v1/docs/product/events/request-events",+ "v1/docs/product/events/reviews-events"]},{"group": "Scheduled Jobs","pages": [- "docs/product/scheduled-jobs/core-scheduled-jobs"+ "v1/docs/product/scheduled-jobs/core-scheduled-jobs"]},{"group": "Subscribers","pages": [- "docs/product/subscribers/core",- "docs/product/subscribers/commission",- "docs/product/subscribers/requests",- "docs/product/subscribers/reviews"+ "v1/docs/product/subscribers/core",+ "v1/docs/product/subscribers/commission",+ "v1/docs/product/subscribers/requests",+ "v1/docs/product/subscribers/reviews"]}]@@ -390,29 +390,29 @@{"group": "Integrations","pages": [- "integrations/algolia",- "integrations/resend",- "integrations/stripe"+ "v1/integrations/algolia",+ "v1/integrations/resend",+ "v1/integrations/stripe"]},{"group": "Deployment","pages": [- "medusa-cloud"+ "v1/medusa-cloud"]},{"group": "Development","pages": [- "development/set-up"+ "v1/development/set-up"]},{"group": "Help","pages": [- "help/llm",- "help/mcp",- "help/support"+ "v1/help/llm",+ "v1/help/mcp",+ "v1/help/support"]}]@@ -422,7 +422,7 @@"groups": [{"group": "API Documentation",- "openapi": "api-reference/combined.oas.json"+ "openapi": "v1/api-reference/combined.oas.json"}]},@@ -439,6 +439,100 @@}]},+ "redirects": [+ {+ "source": "/v2/welcome",+ "destination": "/welcome"+ },+ {+ "source": "/v2/:slug*",+ "destination": "/:slug*"+ },+ {+ "source": "/introduction",+ "destination": "/getting-started/introduction"+ },+ {+ "source": "/get-started",+ "destination": "/getting-started/installation"+ },+ {+ "source": "/installation",+ "destination": "/getting-started/installation"+ },+ {+ "source": "/cli-installation",+ "destination": "/getting-started/installation"+ },+ {+ "source": "/core-concepts/order-splitting",+ "destination": "/core-concepts/order-groups"+ },+ {+ "source": "/core-concepts/payouts",+ "destination": "/core-concepts/payout"+ },+ {+ "source": "/core-concepts/marketplace-settings",+ "destination": "/v1/core-concepts/marketplace-settings"+ },+ {+ "source": "/core-concepts/requests",+ "destination": "/v1/core-concepts/requests"+ },+ {+ "source": "/core-concepts/reviews",+ "destination": "/v1/core-concepts/reviews"+ },+ {+ "source": "/core-concepts/notifications",+ "destination": "/v1/core-concepts/notifications"+ },+ {+ "source": "/components/:slug*",+ "destination": "/v1/components/:slug*"+ },+ {+ "source": "/product/:slug*",+ "destination": "/v1/product/:slug*"+ },+ {+ "source": "/docs/:slug*",+ "destination": "/v1/docs/:slug*"+ },+ {+ "source": "/development/:slug*",+ "destination": "/v1/development/:slug*"+ },+ {+ "source": "/integrations/:slug*",+ "destination": "/v1/integrations/:slug*"+ },+ {+ "source": "/essentials/:slug*",+ "destination": "/v1/essentials/:slug*"+ },+ {+ "source": "/help/:slug*",+ "destination": "/v1/help/:slug*"+ },+ {+ "source": "/api-reference/:slug*",+ "destination": "/v1/api-reference/:slug*"+ },+ {+ "source": "/snippets/:slug*",+ "destination": "/v1/snippets/:slug*"+ },+ {+ "source": "/try-the-api",+ "destination": "/v1/try-the-api"+ },+ {+ "source": "/medusa-cloud",+ "destination": "/v1/medusa-cloud"+ }+ ],"footer": {"socials": {"github": "https://github.com/mercurjs/mercur",diff --git a/apps/docs/v2/getting-started/concepts.mdx b/apps/docs/getting-started/concepts.mdxsimilarity index 81%rename from apps/docs/v2/getting-started/concepts.mdxrename to apps/docs/getting-started/concepts.mdxindex fbeb75aa7..5050ae413 100644--- a/apps/docs/v2/getting-started/concepts.mdx+++ b/apps/docs/getting-started/concepts.mdx@@ -53,16 +53,16 @@ Blocks are the unit of distribution in Mercur. Each block is a self-contained pi## 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](/v2/developer-guide/cli#custom-registries) for your own blocks.+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](/developer-guide/cli#custom-registries) for your own blocks.## CLI-The [Mercur CLI](/v2/developer-guide/cli) (`@mercurjs/cli@latest`) manages your project — scaffolding from templates, installing blocks, searching registries, generating types, and diffing local changes against upstream versions.+The [Mercur CLI](/developer-guide/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](/v2/developer-guide/extending-panels) (`@mercurjs/dashboard-sdk`) is a Vite plugin shared by the admin panel and vendor portal. It provides file-based routing, automatic navigation generation, component overrides, and i18n support.+The [Dashboard SDK](/developer-guide/extending-panels) (`@mercurjs/dashboard-sdk`) is a Vite plugin shared by the admin panel and vendor portal. It provides file-based routing, automatic navigation generation, component overrides, and i18n support.## API Client-The [API Client](/v2/developer-guide/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.+The [API Client](/developer-guide/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.diff --git a/apps/docs/v2/getting-started/installation.mdx b/apps/docs/getting-started/installation.mdxsimilarity index 100%rename from apps/docs/v2/getting-started/installation.mdxrename to apps/docs/getting-started/installation.mdxdiff --git a/apps/docs/v2/getting-started/introduction.mdx b/apps/docs/getting-started/introduction.mdxsimilarity index 93%rename from apps/docs/v2/getting-started/introduction.mdxrename to apps/docs/getting-started/introduction.mdxindex 1a11afebd..29d4c3904 100644--- a/apps/docs/v2/getting-started/introduction.mdx+++ b/apps/docs/getting-started/introduction.mdx@@ -51,9 +51,9 @@ Here's what that looks like in practice:To start building with AI, connect your environment to Mercur's knowledge base:-- **[LLMs](/v2/ai-development/llms)** — Feed the full Mercur documentation to any LLM via `llms.txt`-- **[MCP Server](/v2/ai-development/mcp)** — Let your AI tool search Mercur docs in real time (Cursor, VS Code, Claude, Claude Code)-- **[Skills](/v2/ai-development/skills)** — Pre-built AI workflows that ship with every Mercur project for guided development+- **[LLMs](/ai-development/llms)** — Feed the full Mercur documentation to any LLM via `llms.txt`+- **[MCP Server](/ai-development/mcp)** — Let your AI tool search Mercur docs in real time (Cursor, VS Code, Claude, Claude Code)+- **[Skills](/ai-development/skills)** — Pre-built AI workflows that ship with every Mercur project for guided development### Why this mattersdiff --git a/apps/docs/v2/how-to-guides/stripe-connect-integration.mdx b/apps/docs/how-to-guides/stripe-connect-integration.mdxsimilarity index 99%rename from apps/docs/v2/how-to-guides/stripe-connect-integration.mdxrename to apps/docs/how-to-guides/stripe-connect-integration.mdxindex a82f6f9a4..de42b5cd9 100644--- a/apps/docs/v2/how-to-guides/stripe-connect-integration.mdx+++ b/apps/docs/how-to-guides/stripe-connect-integration.mdx@@ -15,7 +15,7 @@ This guide covers both — setting up Stripe, configuring both providers, wiring- A [Stripe account](https://dashboard.stripe.com) with Connect enabled- Stripe Secret API key and Publishable API key-- A running Mercur project ([installation guide](/v2/quickstart))+- A running Mercur project ([installation guide](/getting-started/installation))- Node.js 20+## Architecture overview@@ -269,7 +269,7 @@ PENDING → (Stripe onboarding) → ACTIVE4. **Ongoing monitoring** — Stripe may send additional `account.updated` events if requirements change. The provider re-evaluates and updates the status accordingly.-For more details on payout accounts, balances, and transactions, see [Payout](/v2/core-concepts/payout).+For more details on payout accounts, balances, and transactions, see [Payout](/core-concepts/payout).## Transfers vs payoutsdiff --git a/apps/docs/v2/migrations/from-1-x-to-2-0.mdx b/apps/docs/migrations/from-1-x-to-2-0.mdxsimilarity index 95%rename from apps/docs/v2/migrations/from-1-x-to-2-0.mdxrename to apps/docs/migrations/from-1-x-to-2-0.mdxindex 841135977..1917ea3fe 100644--- a/apps/docs/v2/migrations/from-1-x-to-2-0.mdx+++ b/apps/docs/migrations/from-1-x-to-2-0.mdx@@ -5,7 +5,7 @@ description: What changed and how to port your existing Mercur 1.x code to 2.0.# Migrating from 1.x to 2.0-Start with a working 2.0 project (see [Installation](/v2/getting-started/installation)). This guide covers what to change when porting your 1.x code.+Start with a working 2.0 project (see [Installation](/getting-started/installation)). This guide covers what to change when porting your 1.x code.<Note>**Using version older than 1.4.0?** Your admin panel code is inside the backend repo (not a separate app). When scanning for custom admin code to port, look there instead of `apps/admin/`. Everything else in this guide applies identically.@@ -98,7 +98,7 @@ Two fields are now **computed at query time** (not stored as columns):4. Update event listeners: `OrderSetWorkflowEvents` → `OrderGroupWorkflowEvents`5. If you used `payment_collection_id` or `sales_channel_id` from the order set, retrieve these from the individual orders instead (via the `order_group_order` link)-See [Order Groups](/v2/core-concepts/order-groups) for the full 2.0 data model and API reference.+See [Order Groups](/core-concepts/order-groups) for the full 2.0 data model and API reference.## Porting Custom Backend Codediff --git a/apps/docs/v2/migrations/from-2-0-to-2-1.mdx b/apps/docs/migrations/from-2-0-to-2-1.mdxsimilarity index 95%rename from apps/docs/v2/migrations/from-2-0-to-2-1.mdxrename to apps/docs/migrations/from-2-0-to-2-1.mdxindex 9d10b35ae..9e0187fa0 100644--- a/apps/docs/v2/migrations/from-2-0-to-2-1.mdx+++ b/apps/docs/migrations/from-2-0-to-2-1.mdx@@ -7,7 +7,7 @@ description: What changed in Mercur 2.1 and how to upgrade an existing 2.0.x proMercur `2.1.1` is the first stable release of the 2.x line after `2.0.2`. The only required change is a package rename. Everything else is handled by `bun run medusa db:migrate`.-If you are starting fresh, follow [Installation](/v2/getting-started/installation) instead — new projects already use the 2.1 names.+If you are starting fresh, follow [Installation](/getting-started/installation) instead — new projects already use the 2.1 names.## Breaking change: `@mercurjs/core-plugin` → `@mercurjs/core`diff --git a/apps/docs/v2/migrations/overview.mdx b/apps/docs/migrations/overview.mdxsimilarity index 86%rename from apps/docs/v2/migrations/overview.mdxrename to apps/docs/migrations/overview.mdxindex 84e951ebf..45390e9c5 100644--- a/apps/docs/v2/migrations/overview.mdx+++ b/apps/docs/migrations/overview.mdx@@ -7,7 +7,7 @@ description: Understand what changes between Mercur 1.x and 2.0 and how to migraMercur 2.0 replaces the monolithic plugin architecture (`@mercurjs/b2c-core`) with a block-based model (`@mercurjs/core` + registry blocks).-This guide is about **porting your existing 1.x code to a 2.0 project**. For setting up a fresh 2.0 project, see [Installation](/v2/getting-started/installation).+This guide is about **porting your existing 1.x code to a 2.0 project**. For setting up a fresh 2.0 project, see [Installation](/getting-started/installation).<Tip>If you're using an AI Agent/IDE (Claude Code, Cursor, or similar), your project includes a `migration-guide` skill that can analyze your 1.x Mercur project and walk you through the migration step by step.@@ -49,10 +49,10 @@ Current migration exceptions:- `SecondaryCategory` does not yet have full 1.x parity and may require manual migration for now.- The 1.x product attribute system is not carried over 1:1, so product attributes may require manual migration for now.-See [From 1.x to 2.0](/v2/migrations/from-1-x-to-2-0) for the full migration guidance and current status.+See [From 1.x to 2.0](/migrations/from-1-x-to-2-0) for the full migration guidance and current status.</Warning>## Next Steps-- [From 2.0 to 2.1](/v2/migrations/from-2-0-to-2-1) — package rename (`@mercurjs/core-plugin` → `@mercurjs/core`) and a `db:migrate` step-- [From 1.x to 2.0](/v2/migrations/from-1-x-to-2-0) — full guide for porting an existing 1.x project\ No newline at end of file+- [From 2.0 to 2.1](/migrations/from-2-0-to-2-1) — package rename (`@mercurjs/core-plugin` → `@mercurjs/core`) and a `db:migrate` step+- [From 1.x to 2.0](/migrations/from-1-x-to-2-0) — full guide for porting an existing 1.x project\ No newline at end of filediff --git a/apps/docs/v2/telemetry.mdx b/apps/docs/telemetry.mdxsimilarity index 100%rename from apps/docs/v2/telemetry.mdxrename to apps/docs/telemetry.mdxdiff --git a/apps/docs/v2/user-guides/admin/stores.mdx b/apps/docs/user-guides/admin/stores.mdxsimilarity index 100%rename from apps/docs/v2/user-guides/admin/stores.mdxrename to apps/docs/user-guides/admin/stores.mdxdiff --git a/apps/docs/v2/user-guides/vendor/stores.mdx b/apps/docs/user-guides/vendor/stores.mdxsimilarity index 100%rename from apps/docs/v2/user-guides/vendor/stores.mdxrename to apps/docs/user-guides/vendor/stores.mdxdiff --git a/apps/docs/api-reference/combined.oas.json b/apps/docs/v1/api-reference/combined.oas.jsonsimilarity index 100%rename from apps/docs/api-reference/combined.oas.jsonrename to apps/docs/v1/api-reference/combined.oas.jsondiff --git a/apps/docs/api-reference/endpoint/create.mdx b/apps/docs/v1/api-reference/endpoint/create.mdxsimilarity index 100%rename from apps/docs/api-reference/endpoint/create.mdxrename to apps/docs/v1/api-reference/endpoint/create.mdxdiff --git a/apps/docs/api-reference/endpoint/delete.mdx b/apps/docs/v1/api-reference/endpoint/delete.mdxsimilarity index 100%rename from apps/docs/api-reference/endpoint/delete.mdxrename to apps/docs/v1/api-reference/endpoint/delete.mdxdiff --git a/apps/docs/api-reference/endpoint/get.mdx b/apps/docs/v1/api-reference/endpoint/get.mdxsimilarity index 100%rename from apps/docs/api-reference/endpoint/get.mdxrename to apps/docs/v1/api-reference/endpoint/get.mdxdiff --git a/apps/docs/api-reference/introduction.mdx b/apps/docs/v1/api-reference/introduction.mdxsimilarity index 100%rename from apps/docs/api-reference/introduction.mdxrename to apps/docs/v1/api-reference/introduction.mdxdiff --git a/apps/docs/api-reference/openapi.json b/apps/docs/v1/api-reference/openapi.jsonsimilarity index 100%rename from apps/docs/api-reference/openapi.jsonrename to apps/docs/v1/api-reference/openapi.jsondiff --git a/apps/docs/cli-installation.mdx b/apps/docs/v1/cli-installation.mdxsimilarity index 100%rename from apps/docs/cli-installation.mdxrename to apps/docs/v1/cli-installation.mdxdiff --git a/apps/docs/components/admin-panel.mdx b/apps/docs/v1/components/admin-panel.mdxsimilarity index 100%rename from apps/docs/components/admin-panel.mdxrename to apps/docs/v1/components/admin-panel.mdxdiff --git a/apps/docs/components/backend.mdx b/apps/docs/v1/components/backend.mdxsimilarity index 100%rename from apps/docs/components/backend.mdxrename to apps/docs/v1/components/backend.mdxdiff --git a/apps/docs/components/storefront.mdx b/apps/docs/v1/components/storefront.mdxsimilarity index 100%rename from apps/docs/components/storefront.mdxrename to apps/docs/v1/components/storefront.mdxdiff --git a/apps/docs/components/vendor-panel.mdx b/apps/docs/v1/components/vendor-panel.mdxsimilarity index 100%rename from apps/docs/components/vendor-panel.mdxrename to apps/docs/v1/components/vendor-panel.mdxdiff --git a/apps/docs/v1/core-concepts/commission.mdx b/apps/docs/v1/core-concepts/commission.mdxnew file mode 100644index 000000000..4e596ba0d--- /dev/null+++ b/apps/docs/v1/core-concepts/commission.mdx@@ -0,0 +1,96 @@+---+title: "Marketplace commission"+---++Marketplace admin can set commission rates in various combinations, which enables to charge different commission for different product types, categories, sellers etc.++# Commission rule reference types++Each commission rule has its reference. A reference entity types are listed below. There are simple (one `reference_id` at once), and combined types, that take into account more than one reference at once. Each combination (`reference` and `reference_id`) are required to be unique.++- `site` - default commission applied for all products in the marketplace, can be overriden by other rules,+- `product_type` - applied to products of specified type,+- `product_category` - applied to products from specified category,+- `seller+product_category` - applied to products from specified category, and sold by specified seller,+- `seller+product_type` - applied to products of specified type, and sold by specified seller,+- `seller` - applied to products sold by specified seller.++# Commission rules priority++Multiple different condition rates can be applied to each of the items in order. That's why some of the rules are more important that others, and during commission calculation process only one is applied. Rule reference types priority is described below.++1. `seller+product_type`+2. `seller+product_category`+3. `seller`+4. `product_type`+5. `product_category`+6. `site`++# Commission rate++Each rule should have applicable rate attached. Commission rate entity describes the details on how the commission should be calculated. Available options:++- `type` - `flat` or `percentage`+- `percentage_rate` - applicable if `type` is `percentage`+- `include_tax` - indicates if commission should be calculated including tax+- `price_set_id` - applicable if `type` is `flat`+- `max_price_set_id` - maximum commission value+- `min_price_set_id` - minimum commission value++# Commission rate types++- `flat` - share for marketplace is a fixed amount,+- `percentage` - share for marketplace is a percent of price.++# Calculation++```mermaid+flowchart LR++id1(Take order line_item)+id2(Select applicable rule)+id3{Select associated rate}+id4a(Select appropiate price from price_set, return as a value)+id4b(Calculate % of the line_item price, return as a value)+id5(Clamp commission value between min_price/max_price)+id6(Save commission_line)+++id1-->id2+id2-->id3+id3--type == flat-->id4a+id3--type == percentage-->id4b+id4a-->id5+id4b-->id5+id5-->id6++```++# Database models++```mermaid+erDiagram+ commission_rule ||--o| commission_rate : has+ commission_rule {+ uuid id+ string name+ string reference+ string reference_id+ }+ commission_rate {+ uuid id+ string type+ float percentage_rate+ bool include_tax+ string price_set_id+ string max_price_set_id+ string min_price_set_id+ }+ commission_line {+ uuid id+ string item_line_id+ string rule_id+ string currency_code+ float value+ }+```diff --git a/apps/docs/core-concepts/marketplace-settings.mdx b/apps/docs/v1/core-concepts/marketplace-settings.mdxsimilarity index 100%rename from apps/docs/core-concepts/marketplace-settings.mdxrename to apps/docs/v1/core-concepts/marketplace-settings.mdxdiff --git a/apps/docs/core-concepts/notifications.mdx b/apps/docs/v1/core-concepts/notifications.mdxsimilarity index 100%rename from apps/docs/core-concepts/notifications.mdxrename to apps/docs/v1/core-concepts/notifications.mdxdiff --git a/apps/docs/core-concepts/order-splitting.mdx b/apps/docs/v1/core-concepts/order-splitting.mdxsimilarity index 100%rename from apps/docs/core-concepts/order-splitting.mdxrename to apps/docs/v1/core-concepts/order-splitting.mdxdiff --git a/apps/docs/core-concepts/payouts.mdx b/apps/docs/v1/core-concepts/payouts.mdxsimilarity index 100%rename from apps/docs/core-concepts/payouts.mdxrename to apps/docs/v1/core-concepts/payouts.mdxdiff --git a/apps/docs/core-concepts/requests.mdx b/apps/docs/v1/core-concepts/requests.mdxsimilarity index 100%rename from apps/docs/core-concepts/requests.mdxrename to apps/docs/v1/core-concepts/requests.mdxdiff --git a/apps/docs/core-concepts/reviews.mdx b/apps/docs/v1/core-concepts/reviews.mdxsimilarity index 100%rename from apps/docs/core-concepts/reviews.mdxrename to apps/docs/v1/core-concepts/reviews.mdxdiff --git a/apps/docs/v1/core-concepts/seller.mdx b/apps/docs/v1/core-concepts/seller.mdxnew file mode 100644index 000000000..20695690a--- /dev/null+++ b/apps/docs/v1/core-concepts/seller.mdx@@ -0,0 +1,137 @@+---+title: "Seller"+---++Mercur comes with a `Seller` module that allows you to manage seller products, team members, orders, stock locations and shipping options.++# Entities++- `Seller`+- `Member`+- `Invite`+- `Onboarding`++# Seller++In Mercur, the `Seller` is the entity that represents member group in the marketplace.+You can think of a seller as a group of members that share the same products, orders etc.++Seller can be in state `ACTIVE`, which allows him to use the platform, or in state `SUSPENDED`, which prevents him from using the platform, except order and fulfillment management.++By default, a seller is linked to Medusa's default entities such as:++- `Product`+- `Order`+- `Return`+- `Stock Location`+- `Service Zone`+- `Shipping Option`+- `Shipping Profile`+- `Fulfillment Set`+- `Promotion`+- `Campaign`+- `Price List`+- `Customer Group`+- `Inventory Item`++```mermaid+graph LR+ subgraph SellerModule[Seller Module]+ Seller+ end++ subgraph InventoryModule[Inventory Module]+ InventoryItem+ end++ subgraph CustomerModule[Customer Module]+ CustomerGroup+ end++ subgraph PricingModule[Pricing Module]+ PriceList+ end++ subgraph PromotionModule[Promotion Module]+ Promotion+ Campaign+ end++ subgraph ProductModule[Product Module]+ Product+ end++ subgraph OrderModule[Order Module]+ Return+ Order+ end++ subgraph FulfillmentModule[Fulfillment Module]+ ServiceZone+ ShippingOption+ ShippingProfile+ FulfillmentSet+ end++ subgraph StockLocationModule[Stock Location Module]+ StockLocation+ end++ Seller --> Product+ Seller --> Order+ Seller --> Return+ Seller --> ServiceZone+ Seller --> ShippingOption+ Seller --> ShippingProfile+ Seller --> StockLocation+ Seller --> FulfillmentSet+ Seller --> Promotion+ Seller --> Campaign+ Seller --> PriceList+ Seller --> CustomerGroup+ Seller --> InventoryItem+```++# Member++`Member` is the entity that represents a user in the marketplace that can manage seller products, orders, service zones etc.++```mermaid+graph TD+ subgraph SellerModule[Seller Module]+ Seller+ Member+ end++ Seller -->|One-to-Many| Member+```++# Member Invite++`Member Invite` is the entity that represents a pending member invitation to a seller in the marketplace.++```mermaid+graph TD+ subgraph SellerModule[Seller Module]+ Seller+ Invite+ end++ Seller -->|One-to-Many| Invite++```++# Onboarding++`Onboarding` is the entity that holds the information about current state of the onboarding of a seller.++```mermaid+graph TD+ subgraph SellerModule[Seller Module]+ Seller+ Onboarding+ end++ Seller -->|One-to-One| Onboarding++```diff --git a/apps/docs/development/set-up.mdx b/apps/docs/v1/development/set-up.mdxsimilarity index 100%rename from apps/docs/development/set-up.mdxrename to apps/docs/v1/development/set-up.mdxdiff --git a/apps/docs/docs/product/api.mdx b/apps/docs/v1/docs/product/api.mdxsimilarity index 100%rename from apps/docs/docs/product/api.mdxrename to apps/docs/v1/docs/product/api.mdxdiff --git a/apps/docs/docs/product/events/core-events.mdx b/apps/docs/v1/docs/product/events/core-events.mdxsimilarity index 100%rename from apps/docs/docs/product/events/core-events.mdxrename to apps/docs/v1/docs/product/events/core-events.mdxdiff --git a/apps/docs/docs/product/events/request-events.mdx b/apps/docs/v1/docs/product/events/request-events.mdxsimilarity index 100%rename from apps/docs/docs/product/events/request-events.mdxrename to apps/docs/v1/docs/product/events/request-events.mdxdiff --git a/apps/docs/docs/product/events/reviews-events.mdx b/apps/docs/v1/docs/product/events/reviews-events.mdxsimilarity index 100%rename from apps/docs/docs/product/events/reviews-events.mdxrename to apps/docs/v1/docs/product/events/reviews-events.mdxdiff --git a/apps/docs/docs/product/js-sdk.mdx b/apps/docs/v1/docs/product/js-sdk.mdxsimilarity index 100%rename from apps/docs/docs/product/js-sdk.mdxrename to apps/docs/v1/docs/product/js-sdk.mdxdiff --git a/apps/docs/docs/product/scheduled-jobs/core-scheduled-jobs.mdx b/apps/docs/v1/docs/product/scheduled-jobs/core-scheduled-jobs.mdxsimilarity index 100%rename from apps/docs/docs/product/scheduled-jobs/core-scheduled-jobs.mdxrename to apps/docs/v1/docs/product/scheduled-jobs/core-scheduled-jobs.mdxdiff --git a/apps/docs/docs/product/subscribers/commission.mdx b/apps/docs/v1/docs/product/subscribers/commission.mdxsimilarity index 100%rename from apps/docs/docs/product/subscribers/commission.mdxrename to apps/docs/v1/docs/product/subscribers/commission.mdxdiff --git a/apps/docs/docs/product/subscribers/core.mdx b/apps/docs/v1/docs/product/subscribers/core.mdxsimilarity index 100%rename from apps/docs/docs/product/subscribers/core.mdxrename to apps/docs/v1/docs/product/subscribers/core.mdxdiff --git a/apps/docs/docs/product/subscribers/requests.mdx b/apps/docs/v1/docs/product/subscribers/requests.mdxsimilarity index 100%rename from apps/docs/docs/product/subscribers/requests.mdxrename to apps/docs/v1/docs/product/subscribers/requests.mdxdiff --git a/apps/docs/docs/product/subscribers/reviews.mdx b/apps/docs/v1/docs/product/subscribers/reviews.mdxsimilarity index 100%rename from apps/docs/docs/product/subscribers/reviews.mdxrename to apps/docs/v1/docs/product/subscribers/reviews.mdxdiff --git a/apps/docs/docs/product/workflows/commission/commission-workflows.mdx b/apps/docs/v1/docs/product/workflows/commission/commission-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/commission/commission-workflows.mdxrename to apps/docs/v1/docs/product/workflows/commission/commission-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/attribute.mdx b/apps/docs/v1/docs/product/workflows/core/attribute.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/attribute.mdxrename to apps/docs/v1/docs/product/workflows/core/attribute.mdxdiff --git a/apps/docs/docs/product/workflows/core/campaign-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/campaign-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/campaign-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/campaign-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/cart-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/cart-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/cart-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/cart-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/common-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/common-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/common-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/common-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/configuration-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/configuration-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/configuration-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/configuration-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/customer-groups-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/customer-groups-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/customer-groups-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/customer-groups-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/fulfillment-set-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/fulfillment-set-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/fulfillment-set-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/fulfillment-set-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/hooks.mdx b/apps/docs/v1/docs/product/workflows/core/hooks.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/hooks.mdxrename to apps/docs/v1/docs/product/workflows/core/hooks.mdxdiff --git a/apps/docs/docs/product/workflows/core/order-set-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/order-set-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/order-set-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/order-set-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/order-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/order-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/order-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/order-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/payout-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/payout-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/payout-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/payout-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/price-list-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/price-list-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/price-list-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/price-list-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/product-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/product-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/product-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/product-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/promotions-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/promotions-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/promotions-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/promotions-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/seller-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/seller-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/seller-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/seller-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/core/split-order-payment.mdx b/apps/docs/v1/docs/product/workflows/core/split-order-payment.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/split-order-payment.mdxrename to apps/docs/v1/docs/product/workflows/core/split-order-payment.mdxdiff --git a/apps/docs/docs/product/workflows/core/wishlist-workflows.mdx b/apps/docs/v1/docs/product/workflows/core/wishlist-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/core/wishlist-workflows.mdxrename to apps/docs/v1/docs/product/workflows/core/wishlist-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/requests/order-return-request-workflows.mdx b/apps/docs/v1/docs/product/workflows/requests/order-return-request-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/requests/order-return-request-workflows.mdxrename to apps/docs/v1/docs/product/workflows/requests/order-return-request-workflows.mdxdiff --git a/apps/docs/docs/product/workflows/requests/requests.mdx b/apps/docs/v1/docs/product/workflows/requests/requests.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/requests/requests.mdxrename to apps/docs/v1/docs/product/workflows/requests/requests.mdxdiff --git a/apps/docs/docs/product/workflows/reviews/review-workflows.mdx b/apps/docs/v1/docs/product/workflows/reviews/review-workflows.mdxsimilarity index 100%rename from apps/docs/docs/product/workflows/reviews/review-workflows.mdxrename to apps/docs/v1/docs/product/workflows/reviews/review-workflows.mdxdiff --git a/apps/docs/essentials/openapi.mdx b/apps/docs/v1/essentials/openapi.mdxsimilarity index 100%rename from apps/docs/essentials/openapi.mdxrename to apps/docs/v1/essentials/openapi.mdxdiff --git a/apps/docs/get-started.mdx b/apps/docs/v1/get-started.mdxsimilarity index 100%rename from apps/docs/get-started.mdxrename to apps/docs/v1/get-started.mdxdiff --git a/apps/docs/help/llm.mdx b/apps/docs/v1/help/llm.mdxsimilarity index 100%rename from apps/docs/help/llm.mdxrename to apps/docs/v1/help/llm.mdxdiff --git a/apps/docs/help/mcp.mdx b/apps/docs/v1/help/mcp.mdxsimilarity index 100%rename from apps/docs/help/mcp.mdxrename to apps/docs/v1/help/mcp.mdxdiff --git a/apps/docs/help/support.mdx b/apps/docs/v1/help/support.mdxsimilarity index 100%rename from apps/docs/help/support.mdxrename to apps/docs/v1/help/support.mdxdiff --git a/apps/docs/installation.mdx b/apps/docs/v1/installation.mdxsimilarity index 100%rename from apps/docs/installation.mdxrename to apps/docs/v1/installation.mdxdiff --git a/apps/docs/integrations/algolia.mdx b/apps/docs/v1/integrations/algolia.mdxsimilarity index 100%rename from apps/docs/integrations/algolia.mdxrename to apps/docs/v1/integrations/algolia.mdxdiff --git a/apps/docs/integrations/resend.mdx b/apps/docs/v1/integrations/resend.mdxsimilarity index 100%rename from apps/docs/integrations/resend.mdxrename to apps/docs/v1/integrations/resend.mdxdiff --git a/apps/docs/integrations/stripe.mdx b/apps/docs/v1/integrations/stripe.mdxsimilarity index 100%rename from apps/docs/integrations/stripe.mdxrename to apps/docs/v1/integrations/stripe.mdxdiff --git a/apps/docs/introduction.mdx b/apps/docs/v1/introduction.mdxsimilarity index 100%rename from apps/docs/introduction.mdxrename to apps/docs/v1/introduction.mdxdiff --git a/apps/docs/medusa-cloud.mdx b/apps/docs/v1/medusa-cloud.mdxsimilarity index 100%rename from apps/docs/medusa-cloud.mdxrename to apps/docs/v1/medusa-cloud.mdxdiff --git a/apps/docs/product/core-commerce-modules.mdx b/apps/docs/v1/product/core-commerce-modules.mdxsimilarity index 100%rename from apps/docs/product/core-commerce-modules.mdxrename to apps/docs/v1/product/core-commerce-modules.mdxdiff --git a/apps/docs/product/core-infrastructure-modules.mdx b/apps/docs/v1/product/core-infrastructure-modules.mdxsimilarity index 100%rename from apps/docs/product/core-infrastructure-modules.mdxrename to apps/docs/v1/product/core-infrastructure-modules.mdxdiff --git a/apps/docs/product/framework.mdx b/apps/docs/v1/product/framework.mdxsimilarity index 100%rename from apps/docs/product/framework.mdxrename to apps/docs/v1/product/framework.mdxdiff --git a/apps/docs/product/modules/b2c-core/attribute/attribute-concept.mdx b/apps/docs/v1/product/modules/b2c-core/attribute/attribute-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/attribute/attribute-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/attribute/attribute-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/attribute/attribute-links.mdx b/apps/docs/v1/product/modules/b2c-core/attribute/attribute-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/attribute/attribute-links.mdxrename to apps/docs/v1/product/modules/b2c-core/attribute/attribute-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/attribute/attributes-data-models-ref.mdx b/apps/docs/v1/product/modules/b2c-core/attribute/attributes-data-models-ref.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/attribute/attributes-data-models-ref.mdxrename to apps/docs/v1/product/modules/b2c-core/attribute/attributes-data-models-ref.mdxdiff --git a/apps/docs/product/modules/b2c-core/attribute/attributes-services.mdx b/apps/docs/v1/product/modules/b2c-core/attribute/attributes-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/attribute/attributes-services.mdxrename to apps/docs/v1/product/modules/b2c-core/attribute/attributes-services.mdxdiff --git a/apps/docs/product/modules/b2c-core/configuration/configuration-concept.mdx b/apps/docs/v1/product/modules/b2c-core/configuration/configuration-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/configuration/configuration-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/configuration/configuration-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/configuration/configuration-data-models-ref.mdx b/apps/docs/v1/product/modules/b2c-core/configuration/configuration-data-models-ref.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/configuration/configuration-data-models-ref.mdxrename to apps/docs/v1/product/modules/b2c-core/configuration/configuration-data-models-ref.mdxdiff --git a/apps/docs/product/modules/b2c-core/configuration/configuration-services.mdx b/apps/docs/v1/product/modules/b2c-core/configuration/configuration-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/configuration/configuration-services.mdxrename to apps/docs/v1/product/modules/b2c-core/configuration/configuration-services.mdxdiff --git a/apps/docs/product/modules/b2c-core/marketplace/marketplace-concept.mdx b/apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/marketplace/marketplace-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/marketplace/marketplace-data-model-reference.mdx b/apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/marketplace/marketplace-data-model-reference.mdxrename to apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-data-model-reference.mdxdiff --git a/apps/docs/product/modules/b2c-core/marketplace/marketplace-links.mdx b/apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/marketplace/marketplace-links.mdxrename to apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/marketplace/marketplace-service.mdx b/apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-service.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/marketplace/marketplace-service.mdxrename to apps/docs/v1/product/modules/b2c-core/marketplace/marketplace-service.mdxdiff --git a/apps/docs/product/modules/b2c-core/payout/payout-concept.mdx b/apps/docs/v1/product/modules/b2c-core/payout/payout-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/payout/payout-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/payout/payout-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/payout/payout-data-model-reference.mdx b/apps/docs/v1/product/modules/b2c-core/payout/payout-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/payout/payout-data-model-reference.mdxrename to apps/docs/v1/product/modules/b2c-core/payout/payout-data-model-reference.mdxdiff --git a/apps/docs/product/modules/b2c-core/payout/payout-links.mdx b/apps/docs/v1/product/modules/b2c-core/payout/payout-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/payout/payout-links.mdxrename to apps/docs/v1/product/modules/b2c-core/payout/payout-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/payout/payout-services.mdx b/apps/docs/v1/product/modules/b2c-core/payout/payout-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/payout/payout-services.mdxrename to apps/docs/v1/product/modules/b2c-core/payout/payout-services.mdxdiff --git a/apps/docs/product/modules/b2c-core/secondary-categories/sec-cat-data-model-reference.mdx b/apps/docs/v1/product/modules/b2c-core/secondary-categories/sec-cat-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/secondary-categories/sec-cat-data-model-reference.mdxrename to apps/docs/v1/product/modules/b2c-core/secondary-categories/sec-cat-data-model-reference.mdxdiff --git a/apps/docs/product/modules/b2c-core/secondary-categories/secondary-categories-concept.mdx b/apps/docs/v1/product/modules/b2c-core/secondary-categories/secondary-categories-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/secondary-categories/secondary-categories-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/secondary-categories/secondary-categories-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/secondary-categories/secondary-category-links.mdx b/apps/docs/v1/product/modules/b2c-core/secondary-categories/secondary-category-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/secondary-categories/secondary-category-links.mdxrename to apps/docs/v1/product/modules/b2c-core/secondary-categories/secondary-category-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/secondary-categories/secondary-category-services.mdx b/apps/docs/v1/product/modules/b2c-core/secondary-categories/secondary-category-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/secondary-categories/secondary-category-services.mdxrename to apps/docs/v1/product/modules/b2c-core/secondary-categories/secondary-category-services.mdxdiff --git a/apps/docs/product/modules/b2c-core/seller/seller-concept.mdx b/apps/docs/v1/product/modules/b2c-core/seller/seller-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/seller/seller-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/seller/seller-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/seller/seller-data-model-reference.mdx b/apps/docs/v1/product/modules/b2c-core/seller/seller-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/seller/seller-data-model-reference.mdxrename to apps/docs/v1/product/modules/b2c-core/seller/seller-data-model-reference.mdxdiff --git a/apps/docs/product/modules/b2c-core/seller/seller-links.mdx b/apps/docs/v1/product/modules/b2c-core/seller/seller-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/seller/seller-links.mdxrename to apps/docs/v1/product/modules/b2c-core/seller/seller-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/seller/seller-module-options.mdx b/apps/docs/v1/product/modules/b2c-core/seller/seller-module-options.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/seller/seller-module-options.mdxrename to apps/docs/v1/product/modules/b2c-core/seller/seller-module-options.mdxdiff --git a/apps/docs/product/modules/b2c-core/seller/seller-services.mdx b/apps/docs/v1/product/modules/b2c-core/seller/seller-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/seller/seller-services.mdxrename to apps/docs/v1/product/modules/b2c-core/seller/seller-services.mdxdiff --git a/apps/docs/product/modules/b2c-core/split-order-payment/split-order-data-model-reference.mdx b/apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/split-order-payment/split-order-data-model-reference.mdxrename to apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-data-model-reference.mdxdiff --git a/apps/docs/product/modules/b2c-core/split-order-payment/split-order-links.mdx b/apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/split-order-payment/split-order-links.mdxrename to apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/split-order-payment/split-order-payment-concept.mdx b/apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-payment-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/split-order-payment/split-order-payment-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-payment-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/split-order-payment/split-order-services.mdx b/apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/split-order-payment/split-order-services.mdxrename to apps/docs/v1/product/modules/b2c-core/split-order-payment/split-order-services.mdxdiff --git a/apps/docs/product/modules/b2c-core/taxcode/taxcode-concept.mdx b/apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/taxcode/taxcode-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/taxcode/taxcode-data-model-reference.mdx b/apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/taxcode/taxcode-data-model-reference.mdxrename to apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-data-model-reference.mdxdiff --git a/apps/docs/product/modules/b2c-core/taxcode/taxcode-links.mdx b/apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/taxcode/taxcode-links.mdxrename to apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/taxcode/taxcode-services.mdx b/apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/taxcode/taxcode-services.mdxrename to apps/docs/v1/product/modules/b2c-core/taxcode/taxcode-services.mdxdiff --git a/apps/docs/product/modules/b2c-core/wishlist/wishlist-concept.mdx b/apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/wishlist/wishlist-concept.mdxrename to apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-concept.mdxdiff --git a/apps/docs/product/modules/b2c-core/wishlist/wishlist-data-model-reference.mdx b/apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/wishlist/wishlist-data-model-reference.mdxrename to apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-data-model-reference.mdxdiff --git a/apps/docs/product/modules/b2c-core/wishlist/wishlist-links.mdx b/apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-links.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/wishlist/wishlist-links.mdxrename to apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-links.mdxdiff --git a/apps/docs/product/modules/b2c-core/wishlist/wishlist-services.mdx b/apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-services.mdxsimilarity index 100%rename from apps/docs/product/modules/b2c-core/wishlist/wishlist-services.mdxrename to apps/docs/v1/product/modules/b2c-core/wishlist/wishlist-services.mdxdiff --git a/apps/docs/product/modules/commission/commission/commission-concept.mdx b/apps/docs/v1/product/modules/commission/commission/commission-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/commission/commission/commission-concept.mdxrename to apps/docs/v1/product/modules/commission/commission/commission-concept.mdxdiff --git a/apps/docs/product/modules/commission/commission/commission-data-model-reference.mdx b/apps/docs/v1/product/modules/commission/commission/commission-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/commission/commission/commission-data-model-reference.mdxrename to apps/docs/v1/product/modules/commission/commission/commission-data-model-reference.mdxdiff --git a/apps/docs/product/modules/commission/commission/commission-services.mdx b/apps/docs/v1/product/modules/commission/commission/commission-services.mdxsimilarity index 100%rename from apps/docs/product/modules/commission/commission/commission-services.mdxrename to apps/docs/v1/product/modules/commission/commission/commission-services.mdxdiff --git a/apps/docs/product/modules/requests/order-return-request/order-return-request-data-model-reference.mdx b/apps/docs/v1/product/modules/requests/order-return-request/order-return-request-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/order-return-request/order-return-request-data-model-reference.mdxrename to apps/docs/v1/product/modules/requests/order-return-request/order-return-request-data-model-reference.mdxdiff --git a/apps/docs/product/modules/requests/order-return-request/order-return-request-links.mdx b/apps/docs/v1/product/modules/requests/order-return-request/order-return-request-links.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/order-return-request/order-return-request-links.mdxrename to apps/docs/v1/product/modules/requests/order-return-request/order-return-request-links.mdxdiff --git a/apps/docs/product/modules/requests/order-return-request/order-return-request-services.mdx b/apps/docs/v1/product/modules/requests/order-return-request/order-return-request-services.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/order-return-request/order-return-request-services.mdxrename to apps/docs/v1/product/modules/requests/order-return-request/order-return-request-services.mdxdiff --git a/apps/docs/product/modules/requests/order-return-request/order-return-request.mdx b/apps/docs/v1/product/modules/requests/order-return-request/order-return-request.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/order-return-request/order-return-request.mdxrename to apps/docs/v1/product/modules/requests/order-return-request/order-return-request.mdxdiff --git a/apps/docs/product/modules/requests/requests/request-data-model-reference.mdx b/apps/docs/v1/product/modules/requests/requests/request-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/requests/request-data-model-reference.mdxrename to apps/docs/v1/product/modules/requests/requests/request-data-model-reference.mdxdiff --git a/apps/docs/product/modules/requests/requests/requests-concept.mdx b/apps/docs/v1/product/modules/requests/requests/requests-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/requests/requests-concept.mdxrename to apps/docs/v1/product/modules/requests/requests/requests-concept.mdxdiff --git a/apps/docs/product/modules/requests/requests/requests-links.mdx b/apps/docs/v1/product/modules/requests/requests/requests-links.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/requests/requests-links.mdxrename to apps/docs/v1/product/modules/requests/requests/requests-links.mdxdiff --git a/apps/docs/product/modules/requests/requests/requests-services.mdx b/apps/docs/v1/product/modules/requests/requests/requests-services.mdxsimilarity index 100%rename from apps/docs/product/modules/requests/requests/requests-services.mdxrename to apps/docs/v1/product/modules/requests/requests/requests-services.mdxdiff --git a/apps/docs/product/modules/reviews/reviews/review-data-model-reference.mdx b/apps/docs/v1/product/modules/reviews/reviews/review-data-model-reference.mdxsimilarity index 100%rename from apps/docs/product/modules/reviews/reviews/review-data-model-reference.mdxrename to apps/docs/v1/product/modules/reviews/reviews/review-data-model-reference.mdxdiff --git a/apps/docs/product/modules/reviews/reviews/review-links.mdx b/apps/docs/v1/product/modules/reviews/reviews/review-links.mdxsimilarity index 100%rename from apps/docs/product/modules/reviews/reviews/review-links.mdxrename to apps/docs/v1/product/modules/reviews/reviews/review-links.mdxdiff --git a/apps/docs/product/modules/reviews/reviews/review-service.mdx b/apps/docs/v1/product/modules/reviews/reviews/review-service.mdxsimilarity index 100%rename from apps/docs/product/modules/reviews/reviews/review-service.mdxrename to apps/docs/v1/product/modules/reviews/reviews/review-service.mdxdiff --git a/apps/docs/product/modules/reviews/reviews/reviews-concept.mdx b/apps/docs/v1/product/modules/reviews/reviews/reviews-concept.mdxsimilarity index 100%rename from apps/docs/product/modules/reviews/reviews/reviews-concept.mdxrename to apps/docs/v1/product/modules/reviews/reviews/reviews-concept.mdxdiff --git a/apps/docs/product/workflows/b2c-core/attribute/attribute-workflows.mdx b/apps/docs/v1/product/workflows/b2c-core/attribute/attribute-workflows.mdxsimilarity index 100%rename from apps/docs/product/workflows/b2c-core/attribute/attribute-workflows.mdxrename to apps/docs/v1/product/workflows/b2c-core/attribute/attribute-workflows.mdxdiff --git a/apps/docs/snippets/snippet-intro.mdx b/apps/docs/v1/snippets/snippet-intro.mdxsimilarity index 100%rename from apps/docs/snippets/snippet-intro.mdxrename to apps/docs/v1/snippets/snippet-intro.mdxdiff --git a/apps/docs/try-the-api.mdx b/apps/docs/v1/try-the-api.mdxsimilarity index 100%rename from apps/docs/try-the-api.mdxrename to apps/docs/v1/try-the-api.mdxdiff --git a/apps/docs/v2/core-concepts/commission.mdx b/apps/docs/v2/core-concepts/commission.mdxdeleted file mode 100644index 257c26faf..000000000--- a/apps/docs/v2/core-concepts/commission.mdx+++ /dev/null@@ -1,158 +0,0 @@-----title: "Commission"-description: "How marketplace commissions work in Mercur — rates, rules, calculation, and the commission pipeline."------Commissions are how the marketplace earns revenue. Rather than storing a single commission percentage, Mercur uses a **rule-based system** where commission rates are matched to line items and shipping methods based on configurable conditions.--## Commission rates--A **CommissionRate** defines how much commission the marketplace takes. Each rate has a type, a target, and an optional set of rules that determine when it applies.--| Field | Description |-|-------|-------------|-| `name` | Human-readable name (e.g. "Default Product Commission") |-| `code` | Unique system identifier |-| `type` | `FIXED` (flat amount) or `PERCENTAGE` |-| `target` | `ITEM` (applies to line items) or `SHIPPING` (applies to shipping methods) |-| `value` | The rate value — either a fixed amount or a percentage |-| `min_amount` | Optional minimum commission (floor) |-| `include_tax` | Whether to include tax in the base amount for calculation |-| `priority` | Higher priority rates are evaluated first |-| `currency_code` | Optional — restricts the rate to a specific currency |--## Commission rules--Rules determine **when** a rate applies. A rate without rules acts as a **default** — it applies to all items or shipping methods of its target type. Rules narrow the scope.--Each rule has a `reference` (the type of condition) and a `reference_id` (the value to match):--| Reference | Matches against |-|-----------|----------------|-| `product` | A specific product ID |-| `product_type` | Products of a given type |-| `product_collection` | Products in a collection |-| `product_category` | Products in a category |-| `seller` | Products owned by a specific seller |-| `shipping_option_type` | Shipping options of a given type |--A single rate can have multiple rules. The rate applies if **any** of its rules match.--### Priority and matching--Rates are evaluated in **descending priority order**. The first matching rate wins — subsequent rates are not applied. This lets you set up specific overrides with high priority and catch-all defaults with low priority.--**Example configuration:**--| Rate | Priority | Rules | Type | Value |-|------|----------|-------|------|-------|-| Electronics Commission | 10 | `product_category: "electronics"` | Percentage | 12% |-| Premium Seller Rate | 5 | `seller: "slr_abc123"` | Percentage | 8% |-| Default Commission | 0 | _(none — matches all)_ | Percentage | 15% |--An electronics product from the premium seller would match the Electronics Commission rate (priority 10), not the seller-specific rate (priority 5).--## The calculation pipeline--The `getCommissionLines` method calculates commissions for a given cart or order context:--**1. Load rates**-- All enabled commission rates are loaded with their rules, ordered by priority (highest first)-- Rates are separated into `ITEM` and `SHIPPING` targets--**2. Match items**-- For each line item, the system iterates through item-target rates in priority order-- It checks each rate's rules against the item's product, type, collection, category, and seller-- Rates with no rules match everything (defaults)-- First match wins--**3. Calculate amount**-- Base amount is the item subtotal (optionally including tax if `include_tax` is true)-- For `PERCENTAGE` rates: `commission = (base_amount × value) / 100`-- For `FIXED` rates: `commission = value`-- If the result is below `min_amount`, the minimum is used instead--**4. Match and calculate shipping**-- Same process repeats for shipping methods using shipping-target rates-- Matches against `shipping_option_type` rules--**5. Output**-- Returns an array of `CommissionLine` records, one per item and shipping method--<Info>- All commission calculations use `BigNumber` arithmetic for precision. This is critical for financial accuracy — standard floating-point math can introduce rounding errors.-</Info>--## API examples--### Create a commission rate (Admin API)--```bash-curl -X POST http://localhost:9000/admin/commission-rates \- -H "Authorization: Bearer <admin-token>" \- -H "Content-Type: application/json" \- -d '{- "name": "Default Product Commission",- "code": "default-product",- "type": "percentage",- "target": "item",- "value": 15,- "priority": 0- }'-```--### Create a rate with rules (Admin API)--```bash-curl -X POST http://localhost:9000/admin/commission-rates \- -H "Authorization: Bearer <admin-token>" \- -H "Content-Type: application/json" \- -d '{- "name": "Electronics Commission",- "code": "electronics",- "type": "percentage",- "target": "item",- "value": 12,- "priority": 10,- "rules": [- {- "reference": "product_category",- "reference_id": "pcat_electronics"- }- ]- }'-```--### List commission rates--```bash-curl http://localhost:9000/admin/commission-rates \- -H "Authorization: Bearer <admin-token>"-```--## Commission lines--A **CommissionLine** is the calculated commission for a single line item or shipping method. It stores:--| Field | Description |-|-------|-------------|-| `item_id` | References the order line item or shipping method |-| `commission_rate_id` | The rate that was applied |-| `code` | Code of the applied rate |-| `rate` | The actual rate value used |-| `amount` | The calculated commission amount |--Commission lines are linked to order line items via a **read-only link**. This means you can query an order's line items and include their commission data in a single request.--## How commission connects to payouts--Commission lines are the bridge between orders and seller earnings:--1. An order is completed → commission lines are calculated for each item-2. When the order is credited to the seller's payout account, the total commission is subtracted:- ```- seller_earnings = order.total - sum(commission_line.amount)- ```-3. The marketplace retains the commission amount--This separation means commission rates can be changed at any time without affecting already-calculated orders — the `CommissionLine` records serve as a permanent audit trail.diff --git a/apps/docs/v2/core-concepts/seller.mdx b/apps/docs/v2/core-concepts/seller.mdxdeleted file mode 100644index a778f3ef1..000000000--- a/apps/docs/v2/core-concepts/seller.mdx+++ /dev/null@@ -1,118 +0,0 @@-----title: "Seller"-description: "The central marketplace actor — seller profile, lifecycle, registration flows, and business rules."------A **seller** is the central actor in a Mercur marketplace. Every product listing, order, payout, and storefront presence traces back to a seller account. This page covers the seller data model, lifecycle, and the business rules that govern how sellers operate on the platform.--## Seller Profile--Each seller account holds the following core fields:---| Field | Description |-| --------------- | ----------------------------------------------------------------------------- |-| `name` | Display name shown to customers on the storefront (unique) |-| `handle` | URL-friendly identifier for the seller (unique) |-| `email` | Primary contact email for the seller account (unique) |-| `description` | Free-text seller description, typically shown on the seller's storefront page |-| `logo` | Seller logo or avatar |-| `banner` | Banner image for the seller's storefront page |-| `website_url` | Seller's external website |-| `currency_code` | The single currency in which this seller operates |-| `is_premium` | Operator-designated premium seller flag (see below) |-| `status_reason` | Optional explanation for the current status (e.g. reason for suspension) |-| `external_id` | Identifier in an external system (unique, optional) |-| `metadata` | Arbitrary JSON metadata |---### Single Currency Per Account--Every seller account is locked to **one currency**. Prices, payouts, and subscription billing all use this currency. This constraint keeps financial reporting simple and eliminates exchange-rate ambiguity in payouts.--If a seller needs to trade in multiple currencies, the recommended pattern is to create **separate seller accounts** — one per currency. Each account operates independently with its own products, orders, and payouts.--### Professional Sellers--A seller can optionally have associated **professional details**. If present, the seller is treated as a registered business; if absent, the seller is an individual.--## Address and Payment Information--Sellers can store one or more **addresses** (warehouse, return, business) and **payment details** used for payout processing. These are managed as sub-resources of the seller account and are referenced by workflows such as fulfillment and payout settlement.--## Seller Lifecycle--A seller account moves through **four statuses** over its lifetime:--```- ┌──────────────────┐- │ pending_approval │- └────────┬─────────┘- │ approve- ▼- ┌──────────┐ ┌────────┐- │ suspended │◄────►│ open │- └──────────┘ └───┬────┘- │ terminate- ▼- ┌────────────┐- │ terminated │- └────────────┘-```--### Status Definitions--- `**pending_approval**` — The seller has registered but has not yet been reviewed by the platform operator.-- `**open**` — The seller is active and may list products, receive orders, and collect payouts.-- `**suspended**` — The seller's operations are temporarily frozen. Products remain in the catalog but cannot be purchased.-- `**terminated**` — The seller account is permanently closed. This status is irreversible.--### Status Transition Rules---| From | To | Who | Conditions |-| ------------------ | ------------ | ----------------- | --------------------------------------------------------- |-| `pending_approval` | `open` | Operator | Operator reviews and approves the application |-| `open` | `suspended` | Operator | Policy violation, compliance hold, or operator discretion |-| `suspended` | `open` | Operator | Issue resolved, seller reinstated |-| `open` | `terminated` | Operator / Seller | All prerequisites met (see below) |-| `suspended` | `terminated` | Operator | All prerequisites met (see below) |---## Scheduled Closures--Sellers can schedule **temporary closures** without changing their account status. Two date fields control this:--- `closed_from` — The date the closure begins-- `closed_to` — The date the closure ends--During a scheduled closure the seller's storefront shows as unavailable and new orders cannot be placed, but the account remains in `open` status. This is designed for holidays, seasonal breaks, or planned downtime. Once `closed_to` passes, the seller automatically resumes normal operation.--Scheduled closures are **not a status** — they overlay on top of the current status and do not affect status transition rules.--## Premium Sellers--The `is_premium` flag is set **exclusively by the platform operator**. Sellers cannot designate themselves as premium. This flag is used for storefront features such as:--- Featured placement in search results or category pages-- Visual badges or highlights on the seller's profile-- Priority in marketplace curation--The specific storefront behavior tied to premium status is determined by the frontend implementation.--## Registration Flows--There are **two methods** for creating a seller account:--1. **Operator-created** — The platform operator creates the seller account directly via the admin dashboard. The account can be set to `open` immediately, bypassing `pending_approval`.-2. **Self-registration** — The seller registers through the public-facing registration flow. The account enters `pending_approval` status and waits for operator review.--## Business Rules Summary--- A seller account operates in **exactly one currency**-- The presence of `professional_details` determines whether the seller is a registered business-- Only the **operator** can approve, suspend, or reinstate sellers-- **Termination** is irreversible and requires all orders and payouts to be resolved-- Scheduled closures are **date-driven** and do not change account status-- **Premium** designation is operator-only and influences storefront presentation-- Every seller account must have at least one [member](/v2/core-concepts/seller-members) with an admin rolediff --git a/apps/docs/v2/welcome.mdx b/apps/docs/welcome.mdxsimilarity index 86%rename from apps/docs/v2/welcome.mdxrename to apps/docs/welcome.mdxindex 773d63c6b..59afb538d 100644--- a/apps/docs/v2/welcome.mdx+++ b/apps/docs/welcome.mdx@@ -12,7 +12,7 @@ mode: "custom"Most tools use AI to generate snippets. Mercur lets AI work at the system level — composing APIs, modifying workflows, extending UI, and evolving your marketplace architecture.</p><div className="mt-8 flex gap-4 justify-center">- <a href="/v2/getting-started/installation" className="inline-flex items-center px-5 py-2.5 rounded-lg bg-black dark:bg-white text-white dark:text-black font-medium text-sm hover:opacity-90 transition-opacity no-underline">+ <a href="/getting-started/installation" className="inline-flex items-center px-5 py-2.5 rounded-lg bg-black dark:bg-white text-white dark:text-black font-medium text-sm hover:opacity-90 transition-opacity no-underline">Get Started</a><a href="https://github.com/mercurjs/mercur/releases/tag/v2.0.0" className="inline-flex items-center px-5 py-2.5 rounded-lg border border-gray-200 dark:border-gray-700 font-medium text-sm hover:bg-gray-50 dark:hover:bg-gray-800 transition-colors no-underline">@@ -59,7 +59,7 @@ mode: "custom"<div className="mb-16"><h2 className="text-2xl font-semibold mb-6">Resources</h2><div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-4">- <a href="/v2/getting-started/introduction" className="block p-5 rounded-xl border border-gray-200 dark:border-gray-800 hover:border-gray-300 dark:hover:border-gray-700 hover:bg-gray-50 dark:hover:bg-gray-900 transition-all no-underline">+ <a href="/getting-started/introduction" className="block p-5 rounded-xl border border-gray-200 dark:border-gray-800 hover:border-gray-300 dark:hover:border-gray-700 hover:bg-gray-50 dark:hover:bg-gray-900 transition-all no-underline"><h3 className="font-semibold text-base mb-2">Documentation</h3><p className="text-sm text-gray-500 dark:text-gray-400 m-0">Guides on setup, configuration, and extending your marketplace.</p></a>@@ -71,14 +71,14 @@ mode: "custom"<h3 className="font-semibold text-base mb-2">Discord</h3><p className="text-sm text-gray-500 dark:text-gray-400 m-0">Join the community for help, discussions, and updates.</p></a>- <a href="/v2/blocks" className="block p-5 rounded-xl border border-gray-200 dark:border-gray-800 hover:border-gray-300 dark:hover:border-gray-700 hover:bg-gray-50 dark:hover:bg-gray-900 transition-all no-underline">+ <a href="/blocks" className="block p-5 rounded-xl border border-gray-200 dark:border-gray-800 hover:border-gray-300 dark:hover:border-gray-700 hover:bg-gray-50 dark:hover:bg-gray-900 transition-all no-underline"><div className="flex items-center gap-3 mb-2"><span className="text-lg">🧱</span><h3 className="font-semibold text-base m-0">Browse Blocks</h3></div><p className="text-sm text-gray-500 dark:text-gray-400 m-0">Official registry blocks — install only what you need.</p></a>- <a href="/v2/ai-development/llms" className="block p-5 rounded-xl border border-gray-200 dark:border-gray-800 hover:border-gray-300 dark:hover:border-gray-700 hover:bg-gray-50 dark:hover:bg-gray-900 transition-all no-underline">+ <a href="/ai-development/llms" className="block p-5 rounded-xl border border-gray-200 dark:border-gray-800 hover:border-gray-300 dark:hover:border-gray-700 hover:bg-gray-50 dark:hover:bg-gray-900 transition-all no-underline"><h3 className="font-semibold text-base mb-2">AI Development</h3><p className="text-sm text-gray-500 dark:text-gray-400 m-0">LLMs, MCP server, and skills — connect your AI tools to Mercur.</p></a>diff --git a/packages/admin/src/components/layout/user-menu/user-menu.tsx b/packages/admin/src/components/layout/user-menu/user-menu.tsxindex 1ec3e90c1..ea86d5a86 100644--- a/packages/admin/src/components/layout/user-menu/user-menu.tsx+++ b/packages/admin/src/components/layout/user-menu/user-menu.tsx@@ -59,7 +59,7 @@ export const UserMenu = () => {</DropdownMenu.Item><DropdownMenu.Separator data-testid="sidebar-user-menu-separator-2" /><DropdownMenu.Item asChild data-testid="sidebar-user-menu-documentation">- <Link to="https://docs.mercurjs.com/v2/welcome" target="_blank">+ <Link to="https://docs.mercurjs.com/welcome" target="_blank"><BookOpen className="text-ui-fg-subtle me-2" />{t("app.menus.user.documentation")}</Link>diff --git a/packages/cli/src/commands/create.ts b/packages/cli/src/commands/create.tsindex c04781099..6d90875b8 100644--- a/packages/cli/src/commands/create.ts+++ b/packages/cli/src/commands/create.ts@@ -414,7 +414,7 @@ ${header("Create your first seller:")}${header("Documentation:")}- - ${createTerminalLink("Getting Started", "https://docs.mercurjs.com/v2/welcome")}+ - ${createTerminalLink("Getting Started", "https://docs.mercurjs.com/welcome")}`;}@@ -477,4 +477,3 @@ function validateNodeVersion(): void {);}}-diff --git a/packages/cli/src/telemetry/index.ts b/packages/cli/src/telemetry/index.tsindex 96a294905..7dc7b239c 100644--- a/packages/cli/src/telemetry/index.ts+++ b/packages/cli/src/telemetry/index.ts@@ -23,7 +23,7 @@ export const toggleTelemetry = (enabled: boolean) => {configStore.set("telemetry_enabled", enabled)}-export const TELEMETRY_DOCS_URL = 'https://docs.mercurjs.com/v2/telemetry'+export const TELEMETRY_DOCS_URL = 'https://docs.mercurjs.com/telemetry'export const showTelemetryNoticeIfNeeded = () => {if (configStore.get("notice_shown")) {@@ -120,4 +120,4 @@ const getProjectId = (export const getTelemetryEmail = () => {return configStore.get("telemetry_email") || undefined-}\ No newline at end of file+}diff --git a/packages/vendor/src/components/layout/user-menu/user-menu.tsx b/packages/vendor/src/components/layout/user-menu/user-menu.tsxindex fa4c8a8ff..617e989ec 100644--- a/packages/vendor/src/components/layout/user-menu/user-menu.tsx+++ b/packages/vendor/src/components/layout/user-menu/user-menu.tsx@@ -61,7 +61,7 @@ export const UserMenu = () => {</DropdownMenu.Item><DropdownMenu.Separator /><DropdownMenu.Item asChild>- <Link to="https://docs.mercurjs.com/v2/welcome" target="_blank">+ <Link to="https://docs.mercurjs.com/welcome" target="_blank"><BookOpen className="text-ui-fg-subtle me-2" />{t("app.menus.user.documentation")}</Link>