The Nano Boilerplate is a customizable project template, which can be used to scaffold code on unlimited projects. It is not a rigid application framework like ABP, with dependencies on proprietary NuGet packages. The code generated with Nano is simple and generic, avoiding unnecessary abstraction when possible.

The project templates are available after installing the Nano.Boilerplate NuGet package. You can generate new projects from the command line or by selecting the Nano Boilerplate template in Visual Studio. When creating new projects, options can be passed for multi-tenancy and UI. The scaffolded code is completely unopinionated and can be modified as needed. Follow the .NET setup guide for details on installing NuGet package and using the CLI tool.

On the one hand, Nano is nothing special. We took ASP Identity, and built out multi-tenancy. We set up and documented a clean architecture project that implements useful patterns like specification and generic repository. Plus we added some effort saving extensions methods, built out user management; we could go on but that’s just the back-end. The front-end projects include 3 variants. Confusing stuff like the routing, state management, and data-tables is already figured out for you. A Bootstrap 5 theme is provided, which uses Sass and is highly customizable.

Sure you could do this yourself, but would you really want to? Think of the time you are saving. Here are over 20 endpoints, including views, for all the boring stuff. All the code is documented, making it easy for you or your whole team, to get on board quickly. Since this is a project template, you can generate these projects whenever you need. And, as .NET evolves so will the Nano boilerplate; access it for life.

.NET Solution

The .NET solution has been revised to the latest version .NET 8. Start with the .NET Solution Setup guide to learn about the back-end Web API project. For a more hands on approach, check out the Building API Endpoints with Nano ASP.NET Boilerplate walkthrough.

Single Page Applications – React & Vue

React and Vue are stand-alone UI projects. Follow those guides to learn about the front-end projects.

.NET Razor

The Razor pages project is part of the .NET solution. This documentation will focus on the differences when using Razor pages as opposed to the WebApi .

Bootstrap 5 Shared Components and Styles

The styling in the Nano Boilerplate is a custom theme built on top the Bootstrap 5 default theme, written with Scss,. It’s responsive, contains a full range of component samples, and can be easily modified.

Next Steps

The next guide will go over the basic requirements for running this project.