Application (Single Layer) Startup Template
This template provides a simple solution structure with a single project. This document explains that solution structure in details.
The Difference Between the Application Startup Templates
ABP's Application Startup Template provides a well-organized and layered solution to create maintainable business applications based on the Domain Driven Design (DDD) practices. However, some developers find this template a little bit complex for simple and short-term applications. The single-layer application template has been created to provide a simpler development model for such applications. This template has the same functionality, features and modules on runtime with the Application Startup Template but the development model is minimal and everything is in a single project (
How to Start with It?
You can use the ABP CLI to create a new project using this startup template. Alternatively, you can directly create & download this startup template from the Get Started page. In this section, we will use the ABP CLI.
Firstly, install the ABP CLI if you haven't installed it before:
dotnet tool install -g Volo.Abp.Cli
Then, use the
abp new command in an empty folder to create a new solution:
abp new Acme.BookStore -t app-nolayers
Acme.BookStoreis the solution name, like YourCompany.YourProduct. You can use single-level, two-level or three-level naming.
- In this example, the
--template) option specifies the template name.
Specify the UI Framework
This template provides multiple UI frameworks:
mvc: ASP.NET Core MVC UI with Razor Pages (default)
blazor-server: Blazor Server UI
angular: Angular UI
none: Without UI (for HTTP API development)
This template doesn't have Blazor WebAssembly UI, because it requires 3 projects at least (server-side, UI and shared library between these two projects). We are recommending to use the layered application startup template for Blazor WebAssembly projects.
--ui) option to specify the UI framework while creating the solution:
abp new Acme.BookStore -t app-nolayers -u angular
This example specifies the UI type (the
-u option) as
angular. You can also specify
none for the UI type.
Specify the Database Provider
This template supports the following database providers:
ef: Entity Framework Core (default)
--database-provider) option to specify the database provider while creating the solution:
abp new Acme.BookStore -t app-nolayers -d mongodb
If you don't specify any additional options while creating an
app-nolayers template, you will have a solution as shown below:
In the next sections, we will explain the structure based on this example. Your startup solution can be slightly different based on your preferences.
Since this template provides a single-project solution, we've separated concerns into folders instead of projects. You can see the pre-defined folders as shown below:
- Define your database mappings (for EF Core or MongoDB) and repositories in the
- Define your entities in the
- Define your UI localization keys/values in the
- Define your UI menu items in the
- Define your object-to-object mapping classes in the
- Define your UI pages (Razor Pages) in the
Viewsfolder yourself if you prefer the MVC pattern).
- Define your application services in the
How to Run?
Before running the application, you need to create the database and seed the initial data. To do that, you can run the following command in the directory of your project (in the same folder of the
dotnet run --migrate-database
This command will create the database and seed the initial data for you. Then you can run the application with any IDE that supports .NET or by running the
dotnet run command in the directory of your project. The default username is
admin and the password is
While creating a database & applying migrations seem only necessary for relational databases, you should run this command even if you choose a NoSQL database provider (like MongoDB). In that case, it still seeds the initial data which is necessary for the application.
The Angular UI
If you choose
Angular as the UI framework, the solution will be separated into two folders:
angularfolder that contains the Angular UI application, the client-side code.
aspnet-corefolder that contains the ASP.NET Core solution (a single project), the server-side code.
The server-side is similar to the solution described in the Solution Structure section above. This project serves the API, so the Angular application can consume it.
The client-side application consumes the HTTP APIs as mentioned. You can see the folder structure of the Angular project shown below: