<picture> <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/59018053/229103275-b5e482bb-4601-46e6-8142-244f531cebdb.svg"> <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/59018053/229103726-e5b529a3-9b3f-4970-8a1f-c6af37f087bf.svg"> </picture>

Medusa

Documentation | Website

Building blocks for digital commerce

Getting Started

Visit the Documentation to set up a Medusa application.

What is Medusa

Medusa is an ecommerce platform with a built-in framework for customization that allows you to build custom commerce applications without reinventing core commerce logic. The framework and modules can be used to build advanced B2B or DTC ecommerce stores, marketplaces, PoS systems, service businesses, or any product that needs foundational commerce primitives. All commerce modules are open-source and freely available on npm.

Learn more about Medusa’s architecture and commerce modules in the Docs.

Upgrades & Integrations

Follow the Release Notes to keep your Medusa project up-to-date.

Check out all available Medusa integrations.

Community & Contributions

The community and core team are available in GitHub Discussions, where you can ask for support, discuss roadmap, and share ideas.

Our Contribution Guide describes how to contribute to the codebase and Docs.

Join our Discord server to meet other community members.

Other channels

• GitHub Issues
• Community Discord
• Twitter
• LinkedIn
• Medusa Blog

License

Licensed under the MIT License.

@medusajs/ui-preset

2.8.5

2.8.4

2.8.3

2.8.2

2.8.1

2.8.0

2.7.1

2.7.0

Patch Changes

• #11734 cc4c5c86e227a6693d53ea6b5b9e62d0a7c57fa2 Thanks @kasperkristensen! - chore(ui-preset,icons,dashboard): Sync with Figma, and update ArrowRight import

2.6.1

Patch Changes

• #11738 3b470f41427e487c68f89b8ee8155de716ffe861 Thanks @olivermrbl! - chore: Remove ranges on Medusa packages

2.6.0

2.5.1

2.5.0

2.4.0

Minor Changes

• #11041 909b685961ec43b35d74db2b158769d6ef33d5cf Thanks @pnodet! - Remove tailwindcss/defaultTheme import

2.3.1

2.3.0

2.2.0

2.1.3

2.1.2

2.1.1

2.1.0

Patch Changes

• #10369 94f6265dfc074969f2f141a19f2fc33a6ab96af1 Thanks @kasperkristensen! - feat(ui,icons,ui-preset): Sync with latest changes from Figma, and fix Code components

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

Major Changes

• #7341 2e42e053d4c9d5445d227bdc268c66713aad8e2e Thanks @olivermrbl! - chore: Medusa 2.0

1.1.3

Patch Changes

• #6680 26531c5a38 Thanks @kasperkristensen! - feat(ui-preset): Pull latest styles from Figma. fix(ui): Fix invalid state styling of Select, so it correctly shows when aria-invalid is true. fix(medusa): Align query params between /admin/products/:id/variants and /admin/variants. chore(client-types): Update medusa client types to reflect changes to the API.

1.1.2

Patch Changes

• #6357 85a44dfd0 Thanks @kasperkristensen! - fix(ui,ui-preset): Fixes an issue where the color styles of two code components was broken

1.1.1

Patch Changes

• #6297 8cbf6c60f Thanks @kasperkristensen! - feat(ui,ui-preset): Update to latest version of TailwindCSS. Increase spacing between columns in component.

  1.1.0

  Minor Changes

  • #6061 a2c149e7e5 Thanks @kasperkristensen! - feat(ui): Updates spacing and sizing of components. Introduces new size variants for some components, such as Button, IconButton, and Avatar. Change most :focus styles to :focus-visible styles, to prevenent focus styles from being visible when not needed, such as on button clicks. feat(ui-preset): Publishes latest updates to our design system styles, as well as adding new colors. Noticable changes include changing ui-code-text-* styles to ui-code-fg-* for better consistency. feat(icons): Updates the LockClosedSolid and LockOpenSolid icons, and introduces four new icons: LockClosedSolidMini, TriangleLeftMini, TriangleRightMini, and TriangleMini.

  1.0.2

  Patch Changes

  • 035fa72: feat(ui,ui-preset): Release 2.1.0

    @medusajs/ui

    • The styling of buttons, inputs, and the CommandBar has been adjusted to have a more consistent look and feel.
    • Fixed an issue that caused DropdownMenu.Content to overflow the viewport.
    • Fixed an issue with the DatePicker component where deleting a time segment would throw an error.
    • The Text component now accepts a leading prop to adjust the line height. It can be set to normal (default) or compact. This change in the API is fully backwards compatible.
    • Adds a new subcomponent to RadioGroup called RadioGroup.ChoiceBox. This component wraps the RadioGroup.Item component with a mandatory label and description.

    @medusajs/ui-preset

    • Updated several colors, shadows, and gradient effects.

    @medusajs/icons

    • Introduces 6 new icons: QuestionMark, SparklesMiniSolid, SparklesMini, ThumbDown, ThumbUp, and UserCircleMini.
    • There have been slight adjustments made to ArrowPathMini, EllipseBlueSolid, EllipseGreenSolid, EllipseGreySolid, EllipseOrangeSolid, EllipsePurpleSolid, and EllipseRedSolid.

  1.0.1

  Patch Changes

  • ef98084: feat(ui,icons,ui-preset): Update to Medusa UI, including new components, icons, and preset styles.

    Changes in @medusajs/ui

    New components

    • IconButton - A button that only contains an icon.
    • IconBadge - A badge that only contains an icon.
    • StatusBadge - A badge component specifically designed to be used for displaying statuses.
    • Tabs - A tab component that can be used to switch between different views.
    • ProgressTabs - A tab component specifically designed to be used for building multi-step tasks.
    • ProgressAccordion - An accordion component specifically designed to be used for building multi-step tasks.
    • CurrencyInput - An input component that can be used to input currency values.
    • CommandBar - A component that can be used to display a list of keyboard commands omn the screen.
    • CurrencyInput - An input component that can be used to input currency values, such as prices.

    Breaking changes

    Several components have been reorganized to streamline their API. The following components have breaking changes:

    • Button - The format property has been removed. To create a Icon only button, use the new IconButton component.
    • Badge - The format property has been removed. To create a Icon only badge, use the new IconBadge component. The border radius of the component is now controlled using the new rounded property.
    • CodeBlock - The hideLineNumbers property has been moved to the snippets property. This allows users to control the visibility of line numbers on a per snippet basis.

    Other changes

    • The z-index's of all components have been cleaned up to to make stacking portalled components easier.
    • Table.Pagination has been tweaked to ensure that it displays the correct number of pages when there is no data.
    • Calendar has been tweaked to prevent clicking a date from submitting any forms that precede it in the DOM.

    Changes in @medusajs/icons

    New icons

    • X
    • AcademicCap
    • Figma
    • Photo
    • PuzzleSolid
    • Text

    Changes in @medusajs/ui-preset

    Minor tweaks to colors, typography, and animations.

  1.0.0

  Major Changes

  • 8d31ce6: Release of the Medusa UI design system, includes three new packages: @medusajs/ui a set of React components, hooks, and utils; @medusajs/icons a set of React icons; @medusajs/ui-preset a Tailwind CSS preset containing Medusa UI design tokens.