FAQ
General
What is Guppy exactly?
A theme framework for Shopware 6.7 by digital.manufaktur. Made up of the core theme DmfGuppyTheme, 12 complementary plugins, and a browser-based Theme Builder. More under Introduction.
Which Shopware version do I need?
Shopware 6.7. Full version matrix: Requirements.
Is Guppy free / open source?
Proprietary, developed and maintained by digital.manufaktur. Not on the public Marketplace; distribution is via digital.manufaktur.
Where can I see live demos?
Guppy Playground. Express demo: express-demo.digital-manufaktur.com.
Theme setup
Should I use the Theme Builder or a manual child theme?
| Need | Recommendation |
|---|---|
| Pure brand customisation (colors, fonts, logos) | Theme Builder |
| Custom Twig overrides or JS | Manual child theme |
How do I change my brand colors?
In the admin: Content → Themes → Guppy Theme → Configure, then set primary and secondary color. Detail: Colors.
theme:compile fails, what now?
bin/console plugin:list | grep -i guppy # all active?
bin/console plugin:refresh
bin/console theme:compile -v # check verbose output
bin/console cache:clearIf a plugin is missing: composer install. If the storefront build is broken: bin/build-storefront.sh.
Plugins
Which plugins are mandatory?
Only DmfGuppyTheme and DmfSplideSlider (required dependency). Everything else is optional. Recommendations: Recommended Plugins.
How do I install all recommended plugins at once?
bin/console guppy:install:pluginsInteractive command, asks per plugin.
Are the plugins interdependent?
DmfGuppyEmotionworldElements requires DmfGuppyTheme: ^2.0. Slider-based custom elements from DmfCmsCustomElements need DmfSplideSlider. Otherwise independent.
Which plugin does what?
Plugin overview and Recommended Plugins (with decision matrix).
Theme Builder
What happens when I close the builder tab?
Data stays in localStorage. On reopening, the state is restored, as long as you use the same browser.
How do I version my builder configuration?
Use Save Snapshot: you get a .guppy-builder.json. Commit it to your repo.
Can I combine Builder + repo?
Yes. Extract the ZIP, place it under custom/plugins/<Name>/, version with git. Commit .guppy-builder.json too so you can re-edit via the builder later. Detail: Workflow.
Development
Where do my customisations belong?
Never directly in DmfGuppyTheme. Instead:
- Brand / token tweaks → child theme.
- Custom templates → your own plugin or child theme.
- Custom CMS elements → DmfCmsCustomElements or your own plugin.
- Detail: Plugin Integration.
Which mixins / functions are available?
Full list in Theme Variables.
How do I override a Twig template?
Mirror the path and use {% sw_extends '@Storefront/...' %}. Detail: Twig Overrides.
How do I write my own storefront JS plugin?
Extend PluginBase, register with PluginManager. Example: Storefront JS.
What is the correct inheritance order?
overrides.scss (child) → @DmfGuppyTheme → base.scss (child)
configInheritance: ["@Storefront", "@DmfGuppyTheme"]This order is hard-wired.
Updates
How do I run a theme update?
composer update dmf/sw6-guppy-theme
bin/console plugin:refresh
bin/console plugin:update DmfGuppyTheme
bin/console theme:compile
bin/console cache:clearIs there an upgrade scanner?
Yes, bin/console guppy:upgrade:scan. Detail: Changelog.
What do the main and stage branches mean?
main is production LTS, stage is the QA branch (playground). There is no separate next branch. Major releases targeting upcoming Shopware versions are published as RC tags on main, e.g. 2.8.0-rc1. Detail: Contributing.
Help
Where do I find the source code?
GitLab: theme-guppy.
Where do I report bugs?
GitLab repository of the affected plugin, issue tracker. For client projects, primarily via digital.manufaktur's support ticket system.