Installation

This guide walks you through installing the core theme DmfGuppyTheme plus its required dependency DmfSplideSlider into an existing Shopware 6.7 project. If you don't have a Shopware installation yet, follow the official Shopware installation guide first.

Already installed somewhere?

The Guppy Playground lets you explore Guppy live without setting anything up locally.

1. Add the theme via Composer

From your Shopware project root:

composer require dmf/sw6-guppy-theme

Composer pulls in the required dependency dmf/sw6-plugin-splide-slider automatically.

2. Refresh the plugin list

bin/console plugin:refresh

Shopware now recognises both plugins.

3. Install and activate the plugins

bin/console plugin:install --activate DmfSplideSlider
bin/console plugin:install --activate DmfGuppyTheme

Activation order

Activate DmfSplideSlider first, DmfGuppyTheme requires the slider.

4. Assign the theme to the sales channel

bin/console theme:change

The command is interactive: pick the sales channel, then select Guppy Theme.

5. Compile the theme

bin/console theme:compile

Only after theme:compile do SCSS variables and Twig overrides take effect.

6. Clear the cache

bin/console cache:clear

7. Smoke test

Open the storefront and check:

• The layout shows the Guppy style.
• A logo appears (default initially; upload your own under First Steps → Logo).
• Tab navigation works (accessibility default).

Full installation workflow at a glance

composer require dmf/sw6-guppy-theme
bin/console plugin:refresh
bin/console plugin:install --activate DmfSplideSlider
bin/console plugin:install --activate DmfGuppyTheme
bin/console theme:change
bin/console theme:compile
bin/console cache:clear

Auto-install optional plugins

DmfGuppyTheme ships a console command that pulls additional recommended Guppy plugins via Composer:

bin/console guppy:install:plugins

Which plugins make sense is covered in Recommended Plugins.

Troubleshooting

Theme doesn't appear in the storefront

# Check plugin status
bin/console plugin:list | grep -i guppy

# Recompile theme and clear cache
bin/console theme:compile
bin/console cache:clear

Styling issues after an update

# Rebuild the storefront
bin/build-storefront.sh
bin/console theme:compile
bin/console cache:clear

"Plugin not found" during plugin:install

# Invalidate the plugin list cache
bin/console plugin:refresh

Next steps

• First Steps: sales channel assignment, theme config, logo, optional plugins.
• Plugins: overview of all 14 plugins in the ecosystem.
• Child Theme: build your own branded theme with the Theme Builder.