MMonrad.Nuke.Slnx 0.0.8

Nuke.Slnx

Nuke.Slnx is a lightweight extension library for working with .slnx solution metadata files directly from NUKE build pipelines.

The .slnx file format is an emerging companion to standard .sln files, enabling richer solution configuration with structured metadata. Nuke.Slnx adds strongly-typed utilities and helpers for reading, parsing, and modifying .slnx files as part of automated build and CI workflows.

✅ Features

• 📄 Parse .slnx files into strongly-typed objects
• ✍️ Modify solution metadata programmatically during a NUKE build
• 🔁 Commit or regenerate .slnx files in CI without manual edits
• 🧩 Designed to plug directly into existing NukeBuild classes

📦 Installation

Add the package to your NUKE build project:

dotnet add package Nuke.Slnx

🚀 Quickstart

using Nuke.Slnx;
using Nuke.Common.ProjectModel;

public class Build : NukeBuild
{
    [SolutionX] readonly SolutionX Solution;
}

💡 Note: Unfortunately, the world isn't perfect—and neither is the current NUKE CLI support for .slnx. If you're using nuke :setup, the CLI will not detect your .slnx file. When asked to select a solution, choose None. Afterwards, manually update your .nuke/parameters.json file to point to your .slnx instead of a .sln.

Example:

{
  "$schema": "build.schema.json",
  "Solution": "src/Nuke.Slnx.slnx"
}

🧠 Why .slnx?

You use SLNX for a more human-readable, maintainable, and tool-friendly .NET solution file format, replacing legacy .sln files to reduce complexity, simplify collaboration, and improve Git conflict resolution through its clean, XML-based structure with convention-based defaults.

Modern .NET workflows—CI/CD pipelines, cross-platform development, and automated tooling—benefit from SLNX's structured approach and predictable formatting, fully supported by Visual Studio, the .NET CLI, and IDE-agnostic tooling.

✅ Key Benefits of SLNX

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit PRs with improvements, discussions, or new feature proposals around .slnx tooling and NUKE integration.

📜 License

Distributed under the MIT License. See LICENSE for more information.