SourceRabbit.Blueprint 2.0.1

dotnet add package SourceRabbit.Blueprint --version 2.0.1
                    
NuGet\Install-Package SourceRabbit.Blueprint -Version 2.0.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="SourceRabbit.Blueprint" Version="2.0.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="SourceRabbit.Blueprint" Version="2.0.1" />
                    
Directory.Packages.props
<PackageReference Include="SourceRabbit.Blueprint" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add SourceRabbit.Blueprint --version 2.0.1
                    
#r "nuget: SourceRabbit.Blueprint, 2.0.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package SourceRabbit.Blueprint@2.0.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=SourceRabbit.Blueprint&version=2.0.1
                    
Install as a Cake Addin
#tool nuget:?package=SourceRabbit.Blueprint&version=2.0.1
                    
Install as a Cake Tool

Blueprint

<img src="Assets/BlueprintLogo.png" alt="Blueprint logo" width="120" align="left">

Blueprint is a backend application framework for .NET, designed to provide a stable, consistent API across different underlying technologies. Applications interact with Blueprint’s contracts and services, allowing infrastructure choices to evolve independently of business logic.

Database access follows this approach through BlueprintDatabase: applications select a database provider during initialization while keeping the same API for entities, queries, and transactions. Microsoft SQL Server is currently supported, with MySQL support planned.

See the Blueprint documentation for setup instructions, API details, and examples.

<br clear="left">

Requirements

  • .NET 10 SDK and C# 14.
  • An accessible SQL Server instance.
  • SQL permissions for data access and for database creation or schema updates when needed. RAM caching has additional SQL requirements.

Installation

Choose one of the following methods to reference Blueprint in your .NET 10 project.

From GitHub Releases

To use Blueprint 1.1.0 without downloading the DLL manually, right-click your project in Visual Studio and select Edit Project File. Add the following inside the existing <Project> element, before </Project>:

<PropertyGroup>
  <BlueprintVersion>1.1.0</BlueprintVersion>
  <BlueprintDirectory>$(MSBuildProjectDirectory)/Libraries/Blueprint/$(BlueprintVersion)</BlueprintDirectory>
</PropertyGroup>

<ItemGroup>
  <Reference Include="Blueprint">
    <HintPath>$(BlueprintDirectory)/Blueprint.dll</HintPath>
    <Private>true</Private>
  </Reference>

  <PackageReference Include="Microsoft.Data.SqlClient" Version="7.1.1" />
  <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="10.0.14" />
  <PackageReference Include="System.Security.Cryptography.Pkcs" Version="10.0.14" />
</ItemGroup>

<Target Name="DownloadBlueprintRelease" BeforeTargets="ResolveAssemblyReferences" Condition="'$(DesignTimeBuild)' != 'true' and !Exists('$(BlueprintDirectory)/Blueprint.dll')">
  <DownloadFile SourceUrl="https://github.com/SourceRabbit/Blueprint/releases/download/$(BlueprintVersion)/Blueprint.dll" DestinationFolder="$(BlueprintDirectory)" DestinationFileName="Blueprint.dll" Retries="3" />
</Target>

Keep only one declaration of each package if your project already references it. The package versions above match Blueprint 1.1.0; a DLL reference alone does not install these dependencies.

Run Build once. The target downloads Blueprint.dll into Libraries/Blueprint/1.1.0 before resolving references, and the reference copies it to your application's build output. Later builds reuse the downloaded file. Internet access is needed for the initial DLL download and any missing NuGet packages. IntelliSense may need that first build before it can resolve Blueprint types.

You can exclude Libraries/Blueprint/ from source control because the DLL is downloaded when missing. To upgrade, set BlueprintVersion to the exact GitHub release tag and check the dependency versions required by that release. The example stays on the selected version rather than automatically following the latest release.

From Source

Clone the repository and add a project reference to Visual Studio Project/Blueprint/Blueprint.csproj from your consuming project. This path is relative to the Blueprint repository root. The project reference builds Blueprint with your application and restores its NuGet dependencies. Use this method instead of the DLL reference above.

See the Getting Started guide for more details about project references and manually supplied DLLs.

Getting Started

After adding a Blueprint reference, define an entity contract, configure the database and languages, and register the contract. The successfully initialized database becomes active for Entity API calls automatically.

Once the Product contract is registered and database is active:

using Blueprint.Entities;
using Blueprint.Database.TransactionFactory;

Product product = Product.Create();
product.SKU = "CAMERA-001";
product.Title = "Camera";
product.Price = 120m;

DatabaseTransaction transaction = database.TransactionFactory.CreateNewTransaction();
transaction.AddInsert(product);
await database.TransactionFactory.ExecuteTransactionAsync(transaction);

The complete checkout example includes the entity contracts, database initialization, user and basket creation, transactional checkout, stock updates, and shutdown. Editing a loaded entity does not save it automatically; persistence is explicit.

Documentation

The English consumer manual is maintained in the .wiki directory and published to the GitHub Wiki. The Sync Wiki workflow publishes documentation changes pushed to main. It covers usage, examples, behavior, and limitations of the public API. For common errors, see Troubleshooting.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.1 46 11/18/2026