Canonical package repo template
Template for new Novolis .NET package repositories.

Docs · https://nuget.pkg.github.com/Novolis-Platform/index.json · Org landing · Governance

---

novolis-template-dotnet

Canonical GitHub repository template for new Novolis package, tool, analyzer, app, and template repos.

Use Use this template on GitHub to create a new repository, then rename and add projects.

Supports: library, CLI tool, analyzer, game/app, and template repos without over-specializing.

What you get

Item	Purpose
Directory.Build.props / .targets	net10.0, packable defaults, artifacts layout
Directory.Packages.props	Central package management (optional baseline)
build/version.json + version.props	CalVer versioning
build/Novolis.Documentation.props	README + XML doc policy for packable projects
nuget.config	nuget.org + GitHub Packages (Novolis.* at 2026.1.*)
.github/workflows/	PR, merge, and release CI
docs/getting-started.md	Documentation defaults checklist

Quick start

# After generating your repo from the template:
dotnet restore
dotnet build

Add your first project:

dotnet new classlib -n Acme.Widgets.Core -o src/Acme.Widgets.Core
dotnet sln add src/Acme.Widgets.Core/Acme.Widgets.Core.csproj

Documentation defaults

New packable projects should:

1. Import build/Novolis.Documentation.props (included via root Directory.Build.props).
2. Add README.md next to each packable .csproj with Install/API sections.
3. Document public API with XML comments before removing transitional CS1591 suppressions.

See documentation-policy.md.

Package sources

Only nuget.org and GitHub Packages. No local folder feeds. Cross-repo iteration on platform libraries: open Novolis.Platform.slnx (ProjectReference mode) — see platform-project-ref-mode.

Related templates

For dotnet new scaffolds (microservice, Avalonia, MonoGame), use the novolis-templates package instead.

More documentation

• Getting started
• Design
• Release