The purpose of this repository is to standardize development and deployment workflow for ASP.NET Core based server side development. It contains a sample web API application built with .NET Core.

Best practices related to .NET Development have been followed while developing this template application. It is however, not absolute and any improvement in this template is highly encouraged. :star: :rocket: :octocat:

Please read CONTRIBUTING.md before starting to contribute in this project.

• Pre-requisites
• Structure
  • Solution Projects
  • Repository Root Miscellaneous Items
• Pre-configured Features
• Known Issues
• Learning

• Git Version Control System
• .NET 6 SDK & Runtime
• EF Core Command Line Tool v 6.0.0+
• PostgreSQL v13.2 / SQL Server 2017 Express Edition+ with SQL Server Authentication enabled
• Visual Studio 2022 Community Edition / Visual Studio Code with OmniSharp extension installed / JetBrains Rider
• Docker v20.10.6 build 370c289 or above
• Docker Compose v3.7+
• Additional setup needed for generating unit test coverage reports described here

• Console logging using Serilog
• Application monitoring using Sentry & New Relic
• HTTPS redirection
• Health check endpoint
• CORS
• Dependency Injection
• EF Core with in-memory database setup or PostgreSQL or SQL Server database setup with Migrations and Seed Data
• Data access from persistence medium through EF Core using Generic Repository Pattern, Unit of Work pattern
• AutoMapping
• Pagination in API response
• Sample GET/POST/PUT/PATCH/DELETE APIs
• Filtration, Sorting support on GET APIs through OData
• HATEOAS complaint API response
• Consistent & Machine readable error response using ProblemDetails
• API Versioning
• Open API documentation support using Swagger
• Unit Testing setup using XUnit, Moq, Generic Repository Pattern
• Code Coverage Report Generation setup with report summary in GitHub PR as Bot Comment
• Git Ignore, Docker Ignore, Dockerfile and Docker Compose script for containerization
• GitHub actions
• Script to auto renaming components (files/directories, file contents) for setup of new solution from this template.

• Containairization / Dockerization with HTTPS certification and PostgreSQL image
• Containairization / Dockerization with HTTPS certification and SQL Server image

• C# Extension Methods
• Fundamentals of ASP.NET Core
• ASP.NET Core WebAPI Sample
• Best Practices for REST API Design
• Generic Repository Pattern
• .NET CLI
• Options Pattern in .NET Core - Microsoft Documentation
• Options Pattern in .NET Core
• Code Coderage in .NET using Coverlet
• Publish Code Coverage Summary to GitHub PR as Bot Comment