Sasso Shopware Compiler Laravel Package

Product Decisions This Supports

• Build vs. buy: Whether to maintain a custom Sass/SCSS compilation pipeline for Shopware storefronts or adopt this Symfony bundle instead of a Node-based toolchain.
• Roadmap and dependency planning: 0.3.0 makes Symfony Flex auto-registration work, which lowers setup friction for new Flex-based Shopware projects. Existing 0.2.0 users face a breaking class rename and must schedule migration.
• Feature and onboarding decisions: The package now supports a one-command install on Flex projects (composer require shyim/sasso-shopware-compiler), while non-Flex Shopware projects still require manual bundle registration.
• Use-case fit: Best suited to Shopware 6 projects that need PHP-native Sass compilation and are either Flex-based or willing to manually register the bundle. Not a Laravel package despite the broader PHP/Laravel framing.
• Versioning and support policy: Teams should pin 0.3.x for new Flex installations and treat 0.2.0 → 0.3.0 as a small but mandatory migration because the kernel will fail to boot if the old class name remains in config/bundles.php.

When to Consider This Package

• Adopt when: You are building or maintaining a Shopware 6 storefront/theme and want Sass compilation without a Node toolchain; your project is Symfony Flex and you want automatic bundle registration; or you are on a non-Flex Shopware setup and can manually register Shyim\SassoCompiler\SassoCompilerBundle.
• Look elsewhere when: You need a Laravel-native package (this is a Symfony/Shopware bundle); you require a stable 1.0 API; you cannot absorb a breaking class rename in the near term; or you need a broader asset pipeline beyond Sass compilation.
• Upgrade caution: From 0.2.0, update config/bundles.php from ShyimSassoCompiler::class to SassoCompilerBundle::class. From 0.1.0, uninstall the Shopware plugin first. The 0.3.0 rename is breaking but mechanically simple.

How to Pitch It (Stakeholders)

• Executives: This package reduces frontend build complexity by compiling Sass in PHP instead of relying on a Node toolchain. Release 0.3.0 improves the install experience for Symfony Flex projects, shortening onboarding for new Shopware work. The trade-off is a small breaking rename that existing 0.2.0 users must apply during a maintenance window.
• Engineering: Flex auto-registration now works because the bundle class follows Symfony’s PSR-4 naming heuristic: Shyim\SassoCompiler\SassoCompilerBundle. Non-Flex Shopware projects continue to work with manual registration. There are no functional changes in 0.3.0 beyond the rename and Flex compatibility. Recommend 0.3.x for new projects and a scheduled config update for existing installations.