Developer
This section is for Shopware developers and agency devs who want to set Guppy up locally, override templates, use the storefront JS plugin system, or integrate their own plugins into the Guppy ecosystem.
Entry points
| Topic | Description |
|---|---|
| Local Setup | Bootstrap the Shopware project, install the theme, start the storefront watcher. |
| Architecture | Plugin structure, inheritance order, theme.json model. |
| Contributing | Branch strategy, commit conventions, PR workflow. |
| Changelog | Versioning policy (SemVer), release notes. |
Theming
| Topic | Description |
|---|---|
| Variables & Tokens | SCSS architecture, Bootstrap and custom variables, mixins. |
| Twig Overrides | Override templates via sw_extends, leverage theme configuration, variant system. |
| Storefront JS | PluginBase, PluginManager, write your own plugins. |
Extending
| Topic | Description |
|---|---|
| Manual Child Theme Development | Manual workflow without the Theme Builder, plugin skeleton, theme.json, SCSS overrides. |
| Custom CMS Blocks | Register custom blocks, admin component + storefront template. |
| Plugin Integration | Cleanly integrate your own plugins into the Guppy theme, SCSS hooks, Twig extends, asset pipeline. |
Related
- Plugins: full plugin overview of the Guppy ecosystem.
- Child Theme Builder: browser-based configurator as an alternative to manual setup.
- Reference: Twig blocks, theme variables, config schema.