commit c6c1b9e0d2b5d496028571f8c921685c9a287c8c
Author: Swordsteel <swordsteel@gmail.com>
Date:   Wed Oct 1 19:47:28 2025 +0200

    initial commit

diff --git a/.gitea/workflows/build-go.yaml b/.gitea/workflows/build-go.yaml
new file mode 100644
index 0000000..d9ea9f3
--- /dev/null
+++ b/.gitea/workflows/build-go.yaml
@@ -0,0 +1,77 @@
+name: Build Go Tarball
+
+on:
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v3
+        with:
+          repository: stacksmith/go
+          token: ${{ secrets.CI_BOT_TOKEN }}
+
+      - name: Install dependencies
+        run: |
+          apt-get update -y
+          apt-get install -y curl tar build-essential jq
+
+      - name: Determine latest Go release
+        id: get_go
+        run: |
+          LATEST=$(curl -s https://go.dev/dl/?mode=json | jq -r '.[0].version')
+          LATEST_NUM=${LATEST#go}  # -> "1.25.1"
+          echo "LATEST=$LATEST_NUM" >> $GITHUB_ENV
+          echo "Latest Go version: $LATEST_NUM"
+
+      - name: Check if package already exists
+        env:
+          GITEA_TOKEN: ${{ secrets.CI_BOT_TOKEN }}
+          LATEST: ${{ env.LATEST }}
+        run: |
+          EXISTS=$(curl -s -H "Authorization: token $GITEA_TOKEN" \
+            "https://gitea.lulz.ltd/api/packages/list?owner=stacksmith&repo=go" || echo "[]" \
+            | jq -r ".[] | select(.name==\"golang\" and .version==\"${LATEST}-debian12\") | .name")
+          if [ -n "$EXISTS" ]; then
+            echo "Package golang-${LATEST}-debian12 already exists. Skipping build."
+            exit 0
+          fi
+
+      - name: Download Go source
+        env:
+          LATEST: ${{ env.LATEST }}
+        run: |
+          echo "Download: https://go.dev/dl/go${LATEST}.src.tar.gz"
+          curl -LO https://go.dev/dl/go${LATEST}.src.tar.gz
+          tar -xzf go${LATEST}.src.tar.gz
+
+      - name: Install Go bootstrap
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y golang
+          export GOROOT_BOOTSTRAP=/usr/lib/go
+
+      - name: Build Go
+        run: |
+          cd go/src
+          ./make.bash
+          cd ../..
+          mkdir -p golang-${LATEST}-linux-amd64-debian-12/files/go
+          cp -r go/* golang-${LATEST}-linux-amd64-debian-12/files/go/
+
+      - name: Package tarball
+        run: |
+          tar -czf golang-${LATEST}-linux-amd64-debian-12.tar.gz golang-${LATEST}-linux-amd64-debian-12
+
+      - name: Upload to Gitea Packages
+        env:
+          GITEA_TOKEN: ${{ secrets.CI_BOT_TOKEN }}
+          LATEST: ${{ env.LATEST }}
+        run: |
+          curl -X POST \
+               -H "Authorization: token $GITEA_TOKEN" \
+               -F "package=@golang-${LATEST}-linux-amd64-debian-12.tar.gz" \
+               "https://gitea.lulz.ltd/api/packages/upload?owner=stacksmith&repo=go&package_name=golang&package_version=${LATEST}-debian12"
+
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..786a7c6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+# stacksmith/go
+
+A repository and CI pipeline to automatically build and package Go binaries as lulz tarballs for Debian 12 (`bookworm`).
+
+This project generates `golang-<version>-linux-amd64-debian-12.tar.gz` tarballs, suitable for inclusion in custom Docker images or CI/CD pipelines.
+
+---
+
+## Features
+
+- Builds **latest Go releases** automatically from source.
+- Produces a **lulz tarball** with `files/` folder structure.
+- **Idempotent CI workflow**: skips building if the tarball already exists in Gitea Packages.
+- Uploads tarballs to **Gitea Packages** for reuse in your pipelines.
+- Works with **Debian 12 (Bookworm)** environments.
+
+---
+
+## Usage
+
+### 1. Build locally
+
+```
+# Clone the repository
+git clone https://gitea.lulz.ltd/stacksmith/go.git
+cd go
+
+# Determine the Go version to build
+LATEST=v1.24.7  # or use the latest release
+
+# Download and extract Go source
+curl -LO https://go.dev/dl/${LATEST}.src.tar.gz
+tar -xzf ${LATEST}.src.tar.gz
+
+# Build Go
+cd go/src
+./make.bash
+cd ../..
+
+# Package tarball
+mkdir -p golang-${LATEST}-linux-amd64-debian-12/files
+cp -r go/* golang-${LATEST}-linux-amd64-debian-12/files/
+tar -czf golang-${LATEST}-linux-amd64-debian-12.tar.gz golang-${LATEST}-linux-amd64-debian-12
+```
+
+### 2. Use in Docker
+
+```
+FROM debian:bookworm-slim
+
+COPY golang-1.24.7-linux-amd64-debian-12.tar.gz /opt/lulz/
+RUN tar -zxf /opt/lulz/golang-1.24.7-linux-amd64-debian-12.tar.gz \
+      -C /opt/lulz --strip-components=2 --no-same-owner --wildcards '*/files'
+
+ENV PATH="/opt/lulz/go/bin:${PATH}"
+```
\ No newline at end of file