First Steps

After installing Guppy, a handful of basic configurations are recommended. This checklist walks you through the key steps to get your shop production-ready.

1. Open the theme configuration

In the Shopware admin: Content → Themes → Guppy Theme → Configure.

The configuration is grouped into the following tabs:

Tab	Contents
Layout	Container widths, section padding, sidebar behaviour
Header	Header variant, USP banner, logo position
Footer	Column count, newsletter block, payment/shipping logos
USP	USP bar (toggle, colors, texts, social links)
Login	Login/register box behaviour
Checkout	Checkout layout, 3-step progress, trust elements
Guppy Cards	Card components on the detail page
Productcard	Listing and slider product cards
Detailpage	Buybox styling, product images, sliders
Button	Button colors, sizes, outline toggles
Badges	New / top-seller / discount badges
Alerts	Background and text color per alert type

Full field reference: Config Schema.

2. Pick layout variants

Typical recommendations for a standard setup:

• Header variant: Guppy Standard (compact, optimised).
• Footer variant: Guppy Standard (multi-column, newsletter, payment logos).
• Product cards: Guppy Standard (accessible, optimised markup).

Header and footer in detail

More on layout variants under Header, Footer, and Navigation.

3. Set brand colors

Across the Layout / Header / Button tabs:

• Primary color: default #215AFF.
• Secondary color: default #0B1845.
• Border / background colors: fine-grained adjustment per component tab.

Full color system

Brand, system, and status colors are documented in Colors. For code-level details see Theme Variables.

4. Assign logo and favicon

1. Open Content → Media, upload logo (SVG recommended) and favicon.
2. Navigate to Sales Channels → Storefront → Theme.
3. Assign logo slots: desktop, tablet, mobile, favicon, share image.
4. Save.

Logo recommendations

SVG with max 22 px height for the Guppy Standard header variant. The same recommendations apply to Theme Builder output, see Theme Builder Configuration.

5. Clear cache and recompile

After each theme configuration change:

bin/console theme:compile
bin/console cache:clear

6. Add recommended plugins (optional)

Sensible defaults for most stores:

• DmfGuppyEmotionworldElements: 12 CMS elements.
• DmfDropdownNavigation: accessible navigation.
• DmfGuppyCheckoutEnhancements: checkout UX.
• DmfCmsImportExport: migrate content between stage and prod.

Fast install of all recommended plugins:

bin/console guppy:install:plugins

Full recommendations with three setup tiers: Recommended Plugins.

7. Test the storefront

• Visit the frontend, check layout, header, footer.
• Test tab navigation, are all interactive elements reachable?
• Check mobile view (browser dev tools).
• Walk through the checkout flow (cart → login/guest → order confirmation).

8. Generate a branded child theme (optional)

Custom adjustments belong in a child theme, never directly in DmfGuppyTheme.

Fast path: Theme Builder: generates an install-ready plugin ZIP.

Manual path: Manual Child Theme Development.

Checklist

• [ ] Theme assigned to sales channel (bin/console theme:change)
• [ ] theme:compile executed
• [ ] Header / footer / productcard variant chosen
• [ ] Brand colors set
• [ ] Logo, favicon, share image assigned
• [ ] Recommended plugins installed
• [ ] Cache cleared
• [ ] Storefront tested (desktop + mobile)
• [ ] Optional: child theme generated via Theme Builder