Quick Start

This guide walks you through the essential steps for quick setup.

Prerequisites

• ✅ Shopware 6 installation (version 6.4+)
• ✅ Composer installed
• ✅ Terminal access

1. Install Guppy Theme

# 1. Install theme
composer require dmf/theme-guppy

# 2. Activate plugin
bin/console plugin:refresh
bin/console plugin:install DmfGuppyTheme --activate

# 3. Assign theme
bin/console theme:change

2. Basic Configuration

Open the Shopware Admin Panel and navigate to: Content > Themes > Guppy Theme

Key Settings:

Select Header Variant:

• Shopware Standard: Classic layout
• Guppy Standard: Optimized, compact variant ⭐ Recommended
• Extended: With top bar for additional information

Footer Variant:

• Guppy Standard: Enhanced footer functions ⭐ Recommended

Product Cards:

• Guppy Standard: Enable accessible product cards ⭐ Recommended

3. First Customizations (optional)

Customize Colors

// In theme configuration
Primary Color: #215AFF
Secondary Color: #0B1845

Upload Logo

• Navigate to Content > Media
• Upload your logo (recommended: SVG, max. 22px height)
• Assign it in Sales Channels > Storefront > Theme

4. Advanced Plugins (optional)

# Install all recommended plugins
bin/console guppy:install:plugins

Available Plugins:

• ✨ Custom Fonts: Integrate custom fonts
• 🎨 Custom Grid: 11 additional CMS layouts
• 🎭 Emotionworld Elements: Enhanced CMS elements

5. Testing

1. Clear cache:

   bin/console cache:clear

2. Test frontend:

   • Visit your shop
   • Test on different devices
   • Check accessibility with tab navigation

3. Optimize performance:

   bin/console theme:compile

Next Steps

For Theme Customizations:

• 📖 Features Overview - All available configurations
• 🎨 Theme Configuration - Detailed settings

For Developers:

• 🏗️ Create Child Theme
• 🔧 SCSS Architecture - Style customizations
• 🧩 JavaScript Plugins - Extend functionalities

Common Issues

Theme not displayed

# Check plugin status
bin/console plugin:list | grep Guppy

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

Styling issues

# Rebuild storefront
bin/build-storefront.sh

Help & Support

• 🎮 Live Demo: Guppy Playground
• 📚 Complete Documentation: Features
• 🔗 Accessibility Guidelines: DMF Guidelines
• 🐛 Issues: GitLab Repository

---

For further customizations, check the detailed documentation.