ASP.NET-Starter is a template project designed to help developers get started with building .NET web applications quickly and easily. The project follows a simple project structure and includes a heavily opinionated approach to Domain Driven Design (DDD). The template includes a Web API project, domain and infrastructure examples, and is designed to be flexible and easily extensible.
In addition, the project aims to include Docker and Kubernetes deployment files to facilitate easy deployment and scaling in production environments.
ASP.NET-Starter is aimed at developers who want a starter project for building web applications using .NET.
To build and run this project, you will need to have .NET 6 installed on your machine.
Once you have installed .NET 6, you can follow these steps to build and run the project:
- Clone the repository to your local machine:
git clone https://github.com/RohanChhipa/asp.net-starter.git
- Navigate to the project directory:
cd asp.net-starter/
- Build the project using the .NET CLI:
dotnet build
- Run the project using the .NET CLI:
dotnet run --project src/WebAPI/WebAPI.csproj
- Access the web API by opening a browser and navigating to
http://localhost:5030/swagger
.
Contributions are welcome and encouraged! To contribute to this project, please follow these steps:
- Fork the repository and create your branch from
main
. - Make your changes.
- Submit a pull request, detailing the changes you made and any relevant information.
If you have any questions or suggestions, please open an issue. I'd love to hear from you!
All notable changes to this project will be documented in the CHANGELOG.md file.
The format of the log entries is based on Keep a Changelog.
I encourage you to use this CHANGELOG.md
file as a template for your own projects, to help you keep track of changes and releases in a standardized and organized way.
In no specific order of priority, future additions include:
- Logging examples using Serilog
- Docker support
- Kubernetes support
- Mapping
appsettings
to a domain model - Build pipeline using Github Actions
- Unit test examples
This project is licensed under the terms of the MIT License. See the LICENSE file for more information.