Skip to content

Commit 8c02197

Browse files
committed
fix(docs): extract Medusa integration section and update UI paths in 1.6.0 release notes
Made-with: Cursor
1 parent f648481 commit 8c02197

1 file changed

Lines changed: 27 additions & 7 deletions

File tree

apps/docs/blog/releases/o2s/1.6.0.md

Lines changed: 27 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -27,12 +27,32 @@ What's included:
2727
- New blocks covering the full purchase journey: from cart management through checkout steps to order confirmation.
2828
- "Add to Cart" buttons across product blocks (Product List, Product Details, Recommended Products) with promo code support.
2929
- Multi-step checkout with address, company data, and payment forms — including validation and error handling.
30-
- [Medusa.js integration](../../../docs/integrations/commerce/medusa-js/overview) for carts, checkout, customers, and payments — so you can connect to a real commerce backend out of the box.
3130

3231
:::tip
3332
For setup instructions and data model details, see the new documentation for [Carts](../../../docs/main-components/harmonization-app/normalized-data-model/core-model-carts), [Checkout](../../../docs/main-components/harmonization-app/normalized-data-model/core-model-checkout), and [Payments](../../../docs/main-components/harmonization-app/normalized-data-model/core-model-payments).
3433
:::
3534

35+
### Medusa.js commerce integration
36+
37+
To power the cart and checkout features above, we've added a full [Medusa.js integration](../../../docs/integrations/commerce/medusa-js/overview) — the first commerce backend supported in O2S. This means you can connect to a real store out of the box, without building your own API layer.
38+
39+
The integration covers six O2S modules:
40+
41+
| Module | What it enables |
42+
| --------- | --------------- |
43+
| Carts | Cart creation, line items, addresses, shipping methods, promo codes |
44+
| Checkout | Multi-step checkout flow with order placement |
45+
| Customers | Saved address management for authenticated users |
46+
| Orders | Order history and details |
47+
| Payments | Payment session creation and provider selection |
48+
| Products | Product catalog browsing with variants and pricing |
49+
50+
It supports both guest and authenticated checkout, multi-currency pricing, and uses Medusa's Store API with SSO-based authentication. For extended use cases like asset tracking and service subscriptions, there's also an optional [Medusa plugin](https://github.com/o2sdev/medusa-plugin-assets-services) that adds custom entities.
51+
52+
:::tip
53+
See the full [Medusa.js integration docs](../../../docs/integrations/commerce/medusa-js/overview) for setup instructions, and the [Cart & Checkout guide](../../../docs/integrations/commerce/medusa-js/cart-checkout) for details on the checkout flow.
54+
:::
55+
3656
### Interactive CLI wizard
3757

3858
Setting up a new O2S project is now much easier. Instead of cloning a repository and manually configuring packages, you can use the new interactive wizard that walks you through the entire process:
@@ -55,17 +75,17 @@ For all available CLI options and usage examples, see the [Installation guide](.
5575

5676
### Domain-based block and UI organization
5777

58-
Blocks and UI components are now organized by business domain. For example, billing-related blocks live under `packages/blocks/billing/`, support blocks under `packages/blocks/support/`, and checkout blocks under `packages/blocks/checkout/`. The same applies to UI components, which are now grouped into categories like `Cart`, `Checkout`, `cards`, `data`, `forms`, and others.
78+
Blocks and UI components are now organized by business domain. For example, billing-related blocks live under `packages/blocks/billing/`, support blocks under `packages/blocks/support/`, and checkout blocks under `packages/blocks/checkout/`. The same applies to UI components, which are now grouped into categories like `Cart`, `Checkout`, `Cards`, `Data`, `Forms`, `Products`, and others.
5979

6080
This makes it easier to find what you're looking for when working with the codebase, and scales better as the number of blocks grows.
6181

6282
:::info
6383
**Breaking change**: UI import paths have changed. The new format is `@o2s/ui/components/<group>/<Component>` — for example:
6484

6585
```typescript
66-
import { ProductCard } from '@o2s/ui/components/cards/ProductCard';
67-
import { DataGrid } from '@o2s/ui/components/data/DataGrid';
68-
import { Carousel } from '@o2s/ui/components/media/Carousel';
86+
import { ProductCard } from '@o2s/ui/components/Cards/ProductCard';
87+
import { DataGrid } from '@o2s/ui/components/Data/DataGrid';
88+
import { Carousel } from '@o2s/ui/components/Media/Carousel';
6989
```
7090
:::
7191

@@ -137,9 +157,9 @@ Several improvements make day-to-day work with O2S smoother:
137157
A set of new UI components was added to support the cart and checkout flows:
138158

139159
- [`StepIndicator`](https://storybook-o2s.openselfservice.com/?path=/docs/components-checkout-stepindicator--docs) — visual step progress for multi-step checkout.
140-
- [`RadioTile`](https://storybook-o2s.openselfservice.com/?path=/docs/components-radiotilegroup--docs) — selectable option tiles (e.g., for shipping or payment methods).
160+
- [`RadioTile`](https://storybook-o2s.openselfservice.com/?path=/docs/components-forms-radiotilegroup--docs) — selectable option tiles (e.g., for shipping or payment methods).
141161
- [`CartItem`](https://storybook-o2s.openselfservice.com/?path=/docs/components-cart-cartitem--docs), [`CartSummary`](https://storybook-o2s.openselfservice.com/?path=/docs/components-cart-cartsummary--docs), [`CartPromoCode`](https://storybook-o2s.openselfservice.com/?path=/docs/components-cart-cartpromocode--docs) — cart display and promo code input.
142-
- [`AddressFields`](https://storybook-o2s.openselfservice.com/?path=/docs/components-checkout-addressfields--docs), [`QuantityInput`](https://storybook-o2s.openselfservice.com/?path=/docs/components-quantityinput--docs) — form building blocks for checkout pages.
162+
- [`AddressFields`](https://storybook-o2s.openselfservice.com/?path=/docs/components-checkout-addressfields--docs), [`QuantityInput`](https://storybook-o2s.openselfservice.com/?path=/docs/components-forms-quantityinput--docs) — form building blocks for checkout pages.
143163

144164
### Storybook and documentation
145165

0 commit comments

Comments
 (0)