GitHub Actions

Pull requests and merges to master run CI and Release (.github/workflows/ci.yml):

• npm run lint:css
• npm run validate:contracts
• npm run validate:manifest
• dotnet build src/dotnet/AspFrontend.csproj -c Release
• dotnet test src/dotnet/tests/AspFrontend.Tests/AspFrontend.Tests.csproj -c Release --no-build
• npm run test:unit
• npm run test:component
• npm run build

Run the full local quality bar with npm run lint (CSS, JS, contracts, manifest) and dotnet test src/dotnet/tests/AspFrontend.Tests/AspFrontend.Tests.csproj -c Release.

Commits with messages starting release: skip the build job to avoid duplicate runs after semantic-release pushes the version bump.

Release (merge to master only)

Merges to master also trigger semantic-release, which:

• publishes @policedigitalservices/asp-frontend to GitHub Packages (npm)
• publishes AspFrontend to GitHub Packages (NuGet)
• updates CHANGELOG.md and version fields in package.json, composer.json, and src/dotnet/Directory.Build.props
• creates a GitHub release and tag

Release commits are written as release: <version>.

Azure Pipelines

Azure Pipelines is configured in azure-pipelines.yml.

CI runs automatically on master. Other branches can be built manually (queue the pipeline and select the branch).

Build numbers

The Azure build number is derived from package.json:

• master — the package version as-is (e.g. 2.17.0)
• any other branch — package version plus a sanitized branch name and the Azure build ID (e.g. 2.17.0-side-nav.12345), so test releases do not collide with the real version

What Azure Pipelines runs

• Installs Node.js (see the Node version in azure-pipelines.yml)
• Installs dependencies with npm ci
• Runs unit tests with npm run test:unit
• Builds the package with npm run build
• Publishes dist/ as a build artefact

Notes

• npm run test:axe is available locally and can be added to CI later. It may produce incomplete results for some rules (particularly colour contrast). See docs/accessibility-testing.md for known issues and troubleshooting.

Source

Imported from docs/ci.md in asp-frontend.