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

Using the CLI Tool

The Nano boilerplate is now available as a dotnet CLI tool. You can create named projects from the command line tailored to your specifications. Once the Nano.Boilerplate NuGet package is installed, the following templates can be used:

Nano (project template)

With the command dotnet new nano you can scaffold a Nano boilerplate project. Type –h (help) to see a list of option parameters.

You can name your project with the name parameter –n. For example:

dotnet new nano –n MyApp

Multi-Tenancy

The –m parameter specifies the multi-tenancy type. The options are:

  • multidb (multi-database, multi-tenancy)
  • singledb (single-database, multi-tenancy)
  • singletenant (single tenant)

If no option is specified, the default setting for multi-tenancy is multidb.

User Interface

The –ui parameter specifies the front-end technology used. The options are:

  • spa (single page application)
  • razor (server-side pages, MVC)

If no option is specified, the default setting is spa. This is the option you should choose if planning to build with React, Vue, or any other kind of single page front end. This parameter is only available in the full version of the boilerplate.

Nano Service (item template)

With the command dotnet new nano-service you can scaffold a complete CRUD service. In the PowerShell terminal, navigate to the location where the service should be created. That will typically be in Application/Services.

You will need to provide a singular name –s, plural name –p, as well as the name of the application –ap. For example:

dotnet new nano-service –s Supplier –p Suppliers –ap MyApp

This will create a folder with the class, interface, and all the DTOs, filters, and specifications for the new service. If you are using Razor pages, another parameter –ui razor can be passed to ensure the pagination endpoint is created appropriately.

Nano Controller (item template)

With the command dotnet new nano-controller you can scaffold a new API controller. In the PowerShell terminal, navigate to the location where the controller should be created. That will typically be in WebApi/Controllers (or RazorApp/Controllers).

You will need to provide a singular name –s, plural name –p, and name of the application –ap. For example:

dotnet new nano-service –s Supplier –p Suppliers –ap MyApp

This will create an API controller in the location specified. If you are using Razor pages, another parameter –ui razor can be passed to ensure the pagination endpoint is created appropriately.

Next Steps

Learn about the .NET back-end in the Solution Overview guide