1.5 KiB
1.5 KiB
Build Instructions
Prerequisites
- Build tools: .NET SDK 10 (
10.0.x), Node 20+ with pnpm (CI uses Node 20, pnpm 9; local pnpm 12 works, lockfile format unchanged). - Dependencies: NuGet and npm registries reachable. New frontend packages:
@fontsource/jost@5.3.0,@fontsource/marcellus@5.3.0(only bundled whenVITE_THEME=asf). - Environment variables (admin build only, all optional):
VITE_THEME(asf),VITE_DEFAULT_LANGUAGE(nl|en),VITE_APP_TITLE,VITE_APP_ENV,VITE_SENTRY_DSN.
Build steps
- Backend, all projects:
dotnet build SlpModularCms.sln(from the repo root). Expected: 0 errors; warnings NU1903/NU1902/NU1510 about packages are known (see summary). - Admin, default look:
cd frontend && pnpm install --frozen-lockfile && pnpm build. - Admin, ASF look:
VITE_THEME=asf VITE_DEFAULT_LANGUAGE=nl VITE_APP_TITLE="Andrea Slop Fotografie" pnpm build. Expectdist/favicon-theme.png, four*.woff2files andindex.htmllinking/admin/favicon-theme.png. An unknownVITE_THEMEmust fail the build. - Publish as CI does: copy
frontend/dist/.tosrc/SlpModularCms.Api.AndreaSlopFotografie/wwwroot/admin/, thendotnet publish -c Release -r linux-arm64 --self-contained falsein that project.
Troubleshooting
Unknown VITE_THEME "x": the name must be a folder underfrontend/themes/containingtheme.css(available:asf).- Lockfile mismatch in CI: run
pnpm installlocally with the same major lockfile format and commitpnpm-lock.yaml.