WhiteApp or QuickApp API solution template which is built on Onion Architecture with all essential feature using .NET Core!
Explore the docs »

Download from Marketplace · Report Bug · Request Feature

If you like or are using this project to learn or start your solution, please give it a star. Thanks!

If you have found this project helpful, either as a library that you use or as a learning tool, please consider buying me a coffee:

• Onion Architecture
  • reference
• About the Project
• Getting Started
• Features available in this project
• Project description
• Design patterns Used
• Contributing
• Licence Used
• Contact
• Support This Project

Onion Architecture was introduced by Jeffrey Palermo to provide a better way to build applications in perspective of better testability, maintainability, and dependability on the infrastructures like databases and services

Onion, Clean or Hexagonal architecture: it's all the same. Which is built on Domain-Driven Desgin approach.

Domain in center and building layer top of it. You can call it as Domain-centric Architecture too.

• It's all the same (Domain centeric architecture) - Mark Seemann
• Onion Architecture by Jeffrey Palermo
• Clean Architecture by Robert C. Martin (Uncle Bob)
• Hexagonal Architecture by Dr. Alistair Cockburn

WhiteApp or QuickApp API solution template which is built on Onion Architecture with all essential feature using .NET Core.

Download from Marketplace

Select project type as API, and select Onion Architecture

Select project type as API, and select Onion Architecture

Make sure to connect proper database

  "ConnectionStrings": {
    "OnionArchConn": "Data Source=(local)\\sqlexpress01;Initial Catalog=OnionDb;Integrated Security=True",
    "IdentityConnection": "Data Source=(local)\\sqlexpress01;Initial Catalog=OnionDb;Integrated Security=True"
  }, 

and connect to logging in DB or proer path

  "Serilog": {
    "MinimumLevel": "Information",
    "WriteTo": [
      {
        "Name": "RollingFile",
        "Args": {
++          "pathFormat": "D:\\Logs\\log-{Date}.log",
          "outputTemplate": "{Timestamp:yyyy-MM-dd HH:mm:ss.fff zzz} [{Level}] {Message}{NewLine}{Exception}"
        }
      },
      {
        "Name": "MSSqlServer",
        "Args": {
++          "connectionString": "Data Source=(local)\\sqlexpress01;Initial Catalog=OnionDb3;Integrated Security=True",
          "sinkOptionsSection": {
            "tableName": "Logs",
            "schemaName": "EventLogging",
            "autoCreateSqlTable": true
          },
          "restrictedToMinimumLevel": "Warning"
        }
      }
    ],
    "Properties": {
      "Application": "Onion Architecture application"
    }
  },

For Code First approach (To run this application, use Code First apporach)

• For running migration:

  • Option 1: Using Package Manager Console:

    • Open Package Manager Console, select << ProjectName >>.Persistence as Default Project
    • Run these commands:

      PM> add-migration Initial-commit-Application -Context ApplicationDbContext -o Migrations/Application
      PM> add-migration Identity-commit -Context IdentityContext -o Migrations/Identity
      
      PM> update-database -Context ApplicationDbContext 
      PM> update-database -Context IdentityContext 

    

• Option 2: Using dotnet cli:
  • Install dotnet-ef cli:

    dotnet tool install --global dotnet-ef --version="3.1"
    

  • Navigate to OA and run these commands:

    $ dotnet ef migrations add Initial-commit-Application --context ApplicationDbContext -o Migrations/Application
    $ dotnet ef migrations add Identity-commit-Identity --context IdentityContext -o Migrations/Identity
    $ dotnet ef database update --context ApplicationDbContext 
    $ dotnet ef database update --context IdentityContext 
    

For Database First approach

In Package Manager console in << ProjectName >>.Persistence, run below command

scaffold-dbcontext -provider Microsoft.EntityFrameworkCore.SqlServer -connection "Data Source=(local)\SQLexpress;Initial Catalog=OnionArchitectureDB;Integrated Security=True"

Navigate to Health Checks UI https://localhost:44356/healthcheck-ui and make sure everything is green.

** Change port number according to your application

Swagger UI https://localhost:44356/OpenAPI/index.html

** Change port number according to your application

This is default white application for ASP.NET Core API development

This whiteapp contains following features, uncheck feature need to implement yet.

• Application is implemented on Onion architecture
• RESTful API
• Entityframework Core
• Expection handling
• Automapper
• Unit testing via NUnit
• Integration testing via NUnit
• Versioning
• Swagger UI
• CQRS Pattern

Below features will be implemented in infrastructure layer. You can plug and play based on your project.

• Loggings - seriLog
• Email
• Health checks UI
• JWT authentication with Microsoft Identity
• Role based Authorization
• Fluent validations
• Database Seeding
• Enable CORS origin
• Enable feature flag (Make it true when you configure your email configuration)

we can see that all the Layers are dependent only on the Core Layers

See the contents of the LICENSE file for details

Having any issues or troubles getting started? Drop a mail to amit.naik8103@gmail.com or Raise a Bug or Feature Request. Always happy to help.