Nano ASP.NET SaaS Boilerplate
Admin credentials (all tenants): / Password123!
Sample data resets every hour
Nano ASP.NET SaaS Boilerplate
.NET Solution
Vue UI
React UI
Razor Pages
.NET Solution


Open the dotnet folder of the zip download and move the Nano.Boilerplate NuGet file to a convenient location on your computer.

Open a Developer PowerShell terminal in your IDE and install the NuGet with the following command:

C:> dotnet new install .\MyFilePath\Nano.Boilerplate.2.1.0.nupkg

The project templates are now installed globally (you don’t need to keep the NuGet file). New versions can be installed in the same way. To uninstall use command: dotnet new uninstall Nano.Boilerplate.

Now you can scaffold customized projects anywhere using the command line. There are also commands for scaffolding services and API controllers. For more information about using the CLI tool, check out the next section.

While the CLI tool is the best way to use Nano, a full solution file is also included.

Connection Strings

When you name a project using the CLI tool, a connection string is generated under appsettings.json using the same name. To change this, open appsettings.json. Under ConnectionStrings “DefaultConnection” edit the string as needed to point to your local SQL Server instance. For example:

"ConnectionStrings": {
    "DefaultConnection": "Data Source=(localdb)\\mssqllocaldb;Database=MyApplicationDb;Trusted_Connection=True;MultipleActiveResultSets=true"

Run the Application

Initial migrations are already created. To begin, just run the application – any pending migrations are automatically applied. Entity Framework will create a database and seed it with a root tenant and default root-level user with the following credentials:

Password: Password123!

The application will run at:


When you navigate to the localhost:7250 address, you will notice that a client is already running. The client instance you see here is actually being served from the static files found within the wwwroot folder of the WebApi project. This is the ‘build’ version of the Vue / React client. When you work with a client project, it will run the ‘development’ version on a different port (localhost:3000).

Next Steps

Learn about using the CLI tool, in the next section.