Skip to content

Future Development Roadmap: Upgrading to Meteor Components

You are viewing the next version (v6.7) of the documentation.
Click here to switch to the stable version (v6.6), or use the version switcher on the left to navigate between versions.

Future Development Roadmap: Upgrading to Meteor Components

Note: The information provided in this article, including timelines and specific implementations, is subject to change. This document serves as a general guideline for our development direction.

Introduction

With the release of Shopware 6.7, we will replace several current administration components with components from the Meteor Component Library.

Why Meteor Components?

The Meteor Component Library is Shopware's official collection of reusable components used across multiple Shopware projects and built on the Shopware Design System.

Using a shared component library offers several advantages:

  • Consistent Design: All components follow the Shopware Design System guidelines.
  • Consistent Behavior: All components share standardized behavior patterns and API conventions.
  • Reusability: Components can be seamlessly integrated across different projects and apps.
  • Maintenance: Updates and improvements to components are managed centrally and automatically propagate to all projects using the component library.

Migration guide

For each component being replaced, we provide a detailed upgrade guide that explains the migration process from the old component to the new Meteor Component. You can find these guides in the technical upgrade documentation for the release.

Using Codemods for migration

To simplify the plugin migration process, we provide codemods that automatically replace old components with new Meteor Components.

Prerequisites

Running the Migration Tool

  1. Execute the following composer command:

    bash
    # Main command which also outputs the help text
    composer run admin:code-mods
    
    ## Example with arguments
    # composer run admin:code-mods -- --plugin-name example-plugin --fix -v 6.7
  2. Provide your plugin name and target Shopware version for migration

  3. The tool will:

    • Automatically replace compatible components with Meteor Components
    • Add guidance comments for components that require manual migration
    • Fixes some other deprecated code where possible