From 2cad93eef7594bf2ebb93c76e166d14b21485109 Mon Sep 17 00:00:00 2001
From: Konrad Michalik <km@move-elevator.de>
Date: Mon, 2 Mar 2026 14:37:31 +0100
Subject: [PATCH] feat: add stage deployment configuration and update README
 with staging details

---
 README.md                | 12 ++++++++++++
 deploy/deploy-stage.yaml | 25 +++++++++++++++++++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 deploy/deploy-stage.yaml

diff --git a/README.md b/README.md
index b068e16..7f51eb6 100644
--- a/README.md
+++ b/README.md
@@ -87,6 +87,18 @@ Includes:
 - `deploy/deploy-prod.yaml`
 - `deploy/deploy-prod-rollback.yaml`
 
+### Stage Deployment
+
+Deployment to staging environment.
+
+The deployment uses [deployer](https://deployer.org/) and [deployer-tools](https://github.com/move-elevator/deployer-tools) as deployment base.
+
+Includes:
+- `deploy/deploy-stage.yaml`
+
+> [!NOTE]
+> Use this template if the project wants a simple stage deployment and doesn't need an advanced feature branch deployment. 
+
 ### Release
 
 Create a GitLab release with release notes.
diff --git a/deploy/deploy-stage.yaml b/deploy/deploy-stage.yaml
new file mode 100644
index 0000000..71513df
--- /dev/null
+++ b/deploy/deploy-stage.yaml
@@ -0,0 +1,25 @@
+# Purpose:
+#   Deploy an application on the stage system
+#
+deploy:stage:
+  extends:
+    - .ssh
+  needs:
+    - build:php
+    - build:node
+  stage: deploy
+  variables:
+    SSH_USER: ${SSH_USER_STAGE}
+    SSH_HOST: ${SSH_HOST_STAGE}
+    STAGE_TARGET_BRANCH: main
+  script:
+    - vendor/bin/dep deploy stage $DEPLOYER_CONFIG_ADDITIONAL_OPTION
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "schedule"
+      when: never
+    - if: $CI_PIPELINE_SOURCE == "pipeline"
+      when: never
+    - if: $CI_COMMIT_REF_NAME == $STAGE_TARGET_BRANCH
+      when: always
+    - when: never
+  allow_failure: false