Skip to content

Requirements

Guppy targets Shopware 6.7. Plugin constraints are typically shopware/core ~6.7.0. Some plugins accept wider ranges (see below).

Shopware version

ComponentConstraint
DmfGuppyTheme~6.7.0
DmfGuppyEmotionworldElements~6.7.0 (plugin version 2.0); older versions for 6.5/6.6 available
DmfGuppyCheckoutEnhancements`~6.6.0
DmfCmsCustomElements>=6.5.0 <6.8.0
DmfImageFocalPoint>=6.7.0
All other plugins~6.7.0 (or ^6.7)

Shopware LTS

The theme's main branch tracks the current Shopware LTS line. Major releases targeting upcoming Shopware versions are published as RC tags, e.g. 2.8.0-rc1.

PHP

PluginMinimum version
DmfCmsBlockLibraryPHP 8.2+
DmfCmsDynamicGridPHP 8.3+
DmfAutoStyleguidePHP 8.2+
Remaining Guppy pluginsPHP version supported by your Shopware (typically PHP 8.2+)

PHP extensions

DmfCmsImportExport requires:

  • ext-zlib
  • ext-curl

Standard Shopware setups already include both.

Composer

Composer 2.x. Guppy plugins are regular Composer packages of type shopware-platform-plugin.

bash
composer --version
# Composer version 2.x.x

Node and npm

Required as soon as you build the storefront or administration locally, e.g. after adding custom CMS elements or customising plugins.

  • Node: the version officially supported by your Shopware version (Shopware 6.7 → Node 20+).
  • npm: ships with Node.
bash
node --version
# v20.x.x
npm --version

Theme Builder

If you generate child themes exclusively via the Theme Builder, you don't need Node/npm locally. The builder produces an install-ready plugin ZIP.

Shopware build tooling

Available in the Shopware project root:

bash
bin/console            # Symfony Console
bin/build-storefront.sh
bin/build-administration.sh
bin/build-js.sh

Used for activation, theme compilation, and builds.

Web server and MySQL

Standard Shopware requirements, see the official Shopware documentation for Apache/Nginx, MySQL/MariaDB, optional Elasticsearch, etc.

Optional: local Docker setup

Several plugins (DmfDropdownNavigation, DmfGuppyEmotionworldElements) ship Dockware setups. See the relevant plugin README.

macOS and Dockware

The bundled Dockware configurations are primarily tested on Linux. They usually work on macOS but may need minor adjustments.