diff --git a/.github/workflows/check-extension.yaml b/.github/workflows/check-extension.yaml
index 98a927e..881639b 100644
--- a/.github/workflows/check-extension.yaml
+++ b/.github/workflows/check-extension.yaml
@@ -75,6 +75,7 @@ jobs:
           run: composer install
           env:
             COMPOSER_AUTH: ${{ secrets.composer_auth }}
+            COMPOSER_MIRROR_PATH_REPOS: 1
 
         - name: Configure phpunit.xml.dist
           working-directory: ${{ steps.setup-magento.outputs.path }}
@@ -136,6 +137,7 @@ jobs:
           run: composer install
           env:
             COMPOSER_AUTH: ${{ secrets.composer_auth }}
+            COMPOSER_MIRROR_PATH_REPOS: 1
 
         - name: Enable all modules
           working-directory: ${{ steps.setup-magento.outputs.path }}
@@ -205,6 +207,7 @@ jobs:
         run: composer install
         env:
           COMPOSER_AUTH: ${{ secrets.composer_auth }}
+          COMPOSER_MIRROR_PATH_REPOS: 1
 
       - uses: graycoreio/github-actions-magento2/get-magento-version@main
         id: magento-version
diff --git a/.github/workflows/integration.yaml b/.github/workflows/integration.yaml
index af8c307..22a5629 100644
--- a/.github/workflows/integration.yaml
+++ b/.github/workflows/integration.yaml
@@ -140,6 +140,7 @@ jobs:
       env:
         COMPOSER_CACHE_DIR: ${{ steps.composer-cache.outputs.dir }}
         COMPOSER_AUTH: ${{ secrets.composer_auth }}
+        COMPOSER_MIRROR_PATH_REPOS: 1
 
     - name: Replace Configuration Settings for env
       working-directory:  ${{ inputs.magento_directory }}/dev/tests/integration
diff --git a/_test/demo-package/Test/Integration/TemplateRenderTest.php b/_test/demo-package/Test/Integration/TemplateRenderTest.php
new file mode 100644
index 0000000..876a8fb
--- /dev/null
+++ b/_test/demo-package/Test/Integration/TemplateRenderTest.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace Graycore\DemoPackage\Test\Integration;
+
+use Magento\Framework\View\Element\Template;
+use Magento\TestFramework\Helper\Bootstrap;
+
+/**
+ * Fails when the extension is installed as a symlink (default Composer path repo behavior)
+ * because Magento's template engine cannot resolve .phtml files through symlinks.
+ * Requires COMPOSER_MIRROR_PATH_REPOS=1 during composer install.
+ */
+class TemplateRenderTest extends \PHPUnit\Framework\TestCase
+{
+    /**
+     * @magentoAppArea frontend
+     */
+    public function testTemplateRendersWithoutSymlinkError()
+    {
+        $block = Bootstrap::getObjectManager()->create(Template::class);
+        $block->setTemplate('Graycore_DemoPackage::demo.phtml');
+        $this->assertNotEmpty($block->toHtml());
+    }
+}
diff --git a/_test/demo-package/view/frontend/templates/demo.phtml b/_test/demo-package/view/frontend/templates/demo.phtml
new file mode 100644
index 0000000..91bab1b
--- /dev/null
+++ b/_test/demo-package/view/frontend/templates/demo.phtml
@@ -0,0 +1,2 @@
+<?php /** @var \Magento\Framework\View\Element\Template $block */ ?>
+<div>demo</div>