From 26d213df9b02e85bf9b0cfad7d9f24991382436d Mon Sep 17 00:00:00 2001
From: ToxicCrzay270 <185776014+ToxicCrzay270@users.noreply.github.com>
Date: Fri, 15 May 2026 00:53:40 +0200
Subject: [PATCH] Add Gitea runner build workflow

---
 .codex/project.md          | 12 ++++++++++--
 .gitea/workflows/build.yml | 38 ++++++++++++++++++++++++++++++++++++++
 AGENTS.md                  |  2 ++
 README.md                  |  2 ++
 docs/agent-handoff.md      |  3 ++-
 5 files changed, 54 insertions(+), 3 deletions(-)
 create mode 100644 .gitea/workflows/build.yml

diff --git a/.codex/project.md b/.codex/project.md
index 04f7325..14fcc46 100644
--- a/.codex/project.md
+++ b/.codex/project.md
@@ -30,6 +30,14 @@ git diff --check
 
 There is no separate lint script yet. `npm run build` runs `tsc --noEmit` before the Vite build. There is no audit or release-check script yet.
 
+Build and test verification should run on the Gitea runner with:
+
+```text
+.gitea/workflows/build.yml
+```
+
+The local machine is not the source of truth for CI results.
+
 ## Stack
 
 ```text
@@ -46,12 +54,12 @@ npm
 
 Release artifacts are produced in:
 
-Expected files:
-
 ```text
 dist/
 ```
 
+The Gitea build workflow uploads `dist/` as the `league-of-legends-gui-overhaul-dist` workflow artifact.
+
 ## Security Rules
 
 - Do not commit secrets, tokens, `.env` files, certificates, or private keys.
diff --git a/.gitea/workflows/build.yml b/.gitea/workflows/build.yml
new file mode 100644
index 0000000..6889875
--- /dev/null
+++ b/.gitea/workflows/build.yml
@@ -0,0 +1,38 @@
+name: Build
+
+on:
+  push:
+    branches:
+      - master
+      - main
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build web artifact
+        run: npm run build
+
+      - name: Upload dist artifact
+        uses: actions/upload-artifact@v3
+        with:
+          name: league-of-legends-gui-overhaul-dist
+          path: dist/
+          if-no-files-found: error
diff --git a/AGENTS.md b/AGENTS.md
index e6c0ee1..f9d598a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -33,6 +33,8 @@ git diff --check
 
 There is no separate lint script yet. `npm run build` runs `tsc --noEmit` before the Vite build.
 
+For build and test verification, prefer the Gitea runner workflow `.gitea/workflows/build.yml` over relying on this local machine. Local runs are useful for quick checks only when the required tools are already available.
+
 Keep `.codex/project.md` and this `AGENTS.md` aligned when commands, artifact paths, or release rules change.
 
 ## Artifacts
diff --git a/README.md b/README.md
index 6ff187a..8a4f426 100644
--- a/README.md
+++ b/README.md
@@ -48,6 +48,8 @@ Run tests:
 npm test
 ```
 
+CI verification runs on the Gitea runner through `.gitea/workflows/build.yml`.
+
 ## Project Structure
 
 ```text
diff --git a/docs/agent-handoff.md b/docs/agent-handoff.md
index 573a29e..ed5b81f 100644
--- a/docs/agent-handoff.md
+++ b/docs/agent-handoff.md
@@ -15,6 +15,7 @@ Codex Agent Repository Kit baseline applied. The project is a React/Vite/TypeScr
 - Added non-destructive Gitea maintenance workflows.
 - Project remote set to `https://git.wilkensxl.de/Toxic/league-of-legends-gui-overhaul.git`.
 - Documented current npm build and test commands.
+- Added a Gitea runner build workflow for `npm ci`, `npm test`, `npm run build`, and `dist/` artifact upload.
 
 ## Verification
 
@@ -30,7 +31,7 @@ Codex Agent Repository Kit baseline applied. The project is a React/Vite/TypeScr
 ## Next Steps
 
 - Add separate lint, audit, and release-check scripts if needed.
-- Add or update build workflow around `npm run build` and `npm test`.
+- Watch the Gitea build workflow after pushes and fix runner-only failures in follow-up commits.
 - Update README, `AGENTS.md`, `.codex/project.md`, and release docs when implementation begins.
 
 ## Risks