Child Theme
The Guppy Theme Builder is a browser-based configurator that produces an install-ready Shopware 6 plugin as a ZIP file. No local setup, no PHP knowledge, no build pipeline required.
Why a child theme?
Custom adjustments never belong directly in DmfGuppyTheme. A child theme inherits Guppy's full configuration and overrides it with your own values, parent updates remain safe to apply.
The Theme Builder automates this pattern: fill in a form, the builder produces a plugin with the correct inheritance layout. Done.
What the builder generates
| Component | Description |
|---|---|
| Plugin skeleton | Composer package, PSR-4 autoload, plugin bootstrap class, depends on dmf/sw6-guppy-theme |
theme.json | with the correct style/script/asset/configInheritance paths to @Storefront, @DmfGuppyTheme |
| ~250 theme variables | brand, typography, UI, layout, detail page, product cards… |
| 80+ Bootstrap overrides | buttons, inputs, spacing, borders, shadows, container… |
| Assets | logo, favicon, plugin icon, theme preview, share image |
| Fonts | @font-face generation from uploaded .woff/.woff2 files |
| Custom SCSS variables | as name+value pairs in custom.scss with !default |
| Snippets | de-DE and en-GB translation keys |
| Icon mappings | Shopware icon name ↔ Phosphor icon |
.guppy-builder.json | snapshot for re-import into the builder |
Local vs. builder
| Theme Builder | Manual child theme | |
|---|---|---|
| Setup | nothing local | PHP project, Composer, Node |
| Dev model | re-import snapshot | git workflow |
| Best for | brand themes, fast iteration | complex changes, custom Twig overrides, custom JS |
| Output | install-ready plugin ZIP | custom/plugins/<Name> in your repo |
| More under | Getting Started | Manual Child Theme Development |
Privacy
Nothing leaves your browser
All input stays in browser localStorage. ZIP generation runs client-side via JSZip. No inputs are sent to a server.
Suggested path
- Getting Started: UI walkthrough, first theme generation.
- Configuration: full field reference.
- Workflow: installation, iteration, snapshot re-import.