Skip to content

Building and testing ​

All commands run from the repository root.

Prerequisites ​

ToolVersion
.NET SDKas pinned in src/global.json
Node.js26, as in CI and the Dockerfile
pnpmas in packageManager of each package.json
Docker with Composecurrent

Backend ​

bash
dotnet build src/FunkArr.slnx
dotnet format src/FunkArr.slnx --verify-no-changes

TreatWarningsAsErrors is on for every project. Fix the cause of a warning instead of suppressing it. dotnet format src/FunkArr.slnx fixes formatting.

Tests use xUnit v3 on Microsoft.Testing.Platform. Each test project is an executable, so run it with dotnet run, not dotnet test:

bash
dotnet run --project src/FunkArr.Download.Tests/FunkArr.Download.Tests.csproj
dotnet run --project src/FunkArr.Download.Tests/FunkArr.Download.Tests.csproj -- --filter-method "*DispatchNext*"

How tests are written (TestKit, probes, assertions) is on anvil: actor testing, assertions.

Web UI ​

bash
pnpm --dir src/FunkArr.UI install
pnpm --dir src/FunkArr.UI build        # vue-tsc type check and Vite build
pnpm --dir src/FunkArr.UI test         # Vitest
pnpm --dir src/FunkArr.UI test:ui      # Playwright (once: exec playwright install chromium)

Docs ​

bash
pnpm --dir docs install
pnpm --dir docs dev
pnpm --dir docs build                  # also fails on dead links

What CI runs ​

CheckRunsWhen
dotnetbuild, format check, all test projectsevery pull request
frontendUI install and buildevery pull request
commitscommitlintevery pull request
UI Teststype check, Vitest, Playwrightchanges in src/FunkArr.UI/
validate-rulesetsJSON schema checkchanges in data/community/
Architecture modellikec4 validatechanges in docs/architecture/
Securitydependency and image scansDockerfile or package changes, weekly

The build and test jobs come from the shared workflows in st0o0/github-workflows, see CI on anvil.