Reusable GitHub Actions for Shopware

A collection of reusable GitHub Actions and Workflows for Shopware extensions and projects.

Actions

Code Quality

Action	Description	Link
cs-fixer	PHP-CS-Fixer action for checking and enforcing code style	README
phpstan	Runs PHPStan static analysis for Shopware extensions	README
eslint	Runs ESLint on administration or storefront files	README
extension-verifier	Validates and formats Shopware extensions using shopware-cli	README
project-validate	Validates a Shopware project code style and structure	README

Testing

Action	Description	Link
admin-jest	Runs administration Jest tests	README
phpunit	Runs PHPUnit tests for Shopware extensions	README
plugin-lifecycle	Validates a plugin's install/uninstall/reinstall lifecycle and DAL wiring	README

Build & Release

Action	Description	Link
ai-release-notes	Generates AI-powered release notes and creates a draft GitHub release	README
build-zip	Builds the extension zip and validates it	README
store-release	Builds the extension and uploads it to the Shopware Store	README

Setup & Configuration

Action	Description	Link
setup-extension	Checkouts Shopware and extension, installs dependencies	README
shopware-version	Gets the Shopware version that matches the current branch	README
npm-ci-retry	Runs npm install commands with retry handling	README
versions	Gets version information for current and LTS major versions	README

Workflow Orchestration

Action	Description	Link
downstream	Triggers a downstream workflow and waits for it to finish	README
upstream-connect	Connects to upstream from downstream run	README

Deployment

Action	Description	Link
project-deployer	Builds and deploys a Shopware project using shopware-cli and deployer	README

SaaS

Action	Description	Link
saas-preview-environment	Creates or archives a SaaS Preview Environment	README
update-saas-refs	Triggers an update of SAAS upstream refs for a given branch	README

Notifications

Action	Description	Link
version-bump	Detects a composer.json version increase between two refs	README

Usage

All actions follow the standard GitHub Actions format:

steps:
  - uses: shopware/github-actions/[action-name]@main
    with:
      # action-specific inputs

Extension Dependencies

For actions that support extension dependencies (e.g., phpstan, phpunit, setup-extension), you can specify them using the dependencies input:

jobs:
  phpstan:
    uses: shopware/github-actions/phpstan@main
    with:
      extensionName: MyExtensionName
      dependencies: |-
        [
          {"name": "SwagPlatformDemoData", "repo": "git@github.com:shopware/SwagPlatformDemoData.git"}
        ]

For private dependencies, you can use variables that will be replaced with secrets:

jobs:
  phpstan:
    uses: shopware/github-actions/setup-extension@main
    with:
      extensionName: MyExtensionName
      dependencies: |-
        [
          {"name": "MyPrivateExtension", "repo": "https://user:$MY_EXTENSION_TOKEN@gitlab.domain.com/org/my-extension.git"}
        ]
      env: MY_EXTENSION_TOKEN=${{ secrets.MY_EXTENSION_TOKEN }}

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.