Initial hidden11 MVP

README.md

@@ -0,0 +1,68 @@
+# hidden11
+
+Daily football lineup puzzle built with Next.js, React, TypeScript and Tailwind CSS.
+
+## Local development
+
+```bash
+npm install
+npm run dev
+```
+
+Open `http://localhost:3000`.
+
+## Production build
+
+```bash
+npm run build
+npm start
+```
+
+## Docker
+
+```bash
+docker build -t hidden11:latest .
+docker run --rm -p 3000:3000 hidden11:latest
+```
+
+## CI/CD
+
+Gitea Actions workflow:
+
+- `.gitea/workflows/build-and-push.yaml`
+- Builds on `main`
+- Pushes:
+  - `gitea.alexandre-vazquez.cloud/alexandrev/hidden11:<git-sha>`
+  - `gitea.alexandre-vazquez.cloud/alexandrev/hidden11:latest`
+
+Required Gitea repository secrets:
+
+- `REGISTRY_USERNAME`: `alexandrev`
+- `REGISTRY_TOKEN`: token with package/container registry permissions
+
+Create/read tokens from `pass`; never commit credentials.
+
+## Kubernetes
+
+```bash
+kubectl apply -f deploy/k8s
+```
+
+The app is configured for:
+
+- Namespace: `hidden11`
+- Ingress host: `hidden11.app`
+- Ingress class: `public`
+- TLS secret: `hidden11-tls`
+
+## ArgoCD
+
+```bash
+kubectl apply -f deploy/argocd/application.yaml
+```
+
+The ArgoCD Application includes ArgoCD Image Updater annotations for:
+
+- image: `gitea.alexandre-vazquez.cloud/alexandrev/hidden11`
+- strategy: `digest`
+- write-back: `argocd`