Requirements
Guppy targets Shopware 6.7. Plugin constraints are typically shopware/core ~6.7.0. Some plugins accept wider ranges (see below).
Shopware version
| Component | Constraint |
|---|---|
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
| Plugin | Minimum version |
|---|---|
DmfCmsBlockLibrary | PHP 8.2+ |
DmfCmsDynamicGrid | PHP 8.3+ |
DmfAutoStyleguide | PHP 8.2+ |
| Remaining Guppy plugins | PHP version supported by your Shopware (typically PHP 8.2+) |
PHP extensions
DmfCmsImportExport requires:
ext-zlibext-curl
Standard Shopware setups already include both.
Composer
Composer 2.x. Guppy plugins are regular Composer packages of type shopware-platform-plugin.
composer --version
# Composer version 2.x.xNode 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.
node --version
# v20.x.x
npm --versionTheme 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:
bin/console # Symfony Console
bin/build-storefront.sh
bin/build-administration.sh
bin/build-js.shUsed 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.