Add Gitea runner build workflow

.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.

.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

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

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

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