Julien Gautier
f5f0cd6369
Without an image suffix on the runner labels, act_runner uses a minimal default container image that has no Node. Every JavaScript action (actions/checkout, actions/setup-node, nrwl/nx-set-shas, etc.) crashes during the action's launch step with `Cannot find: node in PATH`, blocking every CI gate before any project code runs. The fix is in the runner registration labels: act_runner accepts the format `<label>:docker://<image>`, which makes act spawn jobs in the specified container. catthehacker/ubuntu:act-22.04 is the de facto standard image for act-compatible runners; it bundles Node, Python, git, common build tools, and the Docker CLI, matching what GitHub Actions / Gitea Actions workflows generally assume. infra/ci-runners.compose.yml: GITEA_RUNNER_LABELS updated for the three runners, with an inline comment explaining the format trap. docs/decisions/0015-cicd-gitea-actions.md (§Runners): amend the runner-image baseline. Previous wording said "a Debian image" without specifying which; now states catthehacker/ubuntu:act-22.04 explicitly and explains the docker:// suffix requirement. Status remains 'accepted' - the runner-image choice is implementation detail under the existing decision. Already-running runners need their labels updated in the Gitea UI (Site Administration -> Actions -> Runners -> edit each runner) to the new format. Compose change applies on next re-registration. Documented as the operational follow-up.
Documentation index
This is the entry point to all project documentation. It is maintained automatically: any addition, rename, or removal of a .md file under docs/ must be reflected here in the same change.
Conventions
- Documentation is written in English.
- One topic per file. Group related files into a folder when there are three or more.
- Cross-reference with relative links so they keep working in GitHub, IDEs, and exported sites.
- For architectural decisions, do not add them here — they belong in decisions/ as MADR 4.0.0 ADRs.
Sections
Daily development
- development.md — repo layout, prerequisites, initial setup, daily commands, conventional commit cycle. Day-to-day reference for working on the project.
Architecture
- architecture.md — cross-cutting Mermaid diagrams: C4 system context, C4 containers, Nx module boundaries, CI/CD pipeline. Single-decision diagrams (auth sequence, ERD, etc.) live inline in their ADR.
Onboarding & environment
Setup guides for new contributors:
- setup/01-wsl-terminal-setup.md — modern WSL terminal (Zsh + Powerlevel10k + CLI tools)
- setup/02-dev-web-stack.md — Node via nvm, pnpm via corepack, Docker
- setup/03-angular-nx-monorepo.md — Angular + Nx monorepo bootstrap
Operations & runbooks
Empty — to be populated when we deploy.
Security, performance, accessibility
Empty — placeholders to be filled with rationale docs alongside their corresponding ADRs.