https://github.com/hannahchan/scaffold.service
An opinionated template of a service built using ASP.NET Core (.NET 7).
https://github.com/hannahchan/scaffold.service
clean-architecture dotnet explicit-architecture template
Last synced: 11 months ago
JSON representation
An opinionated template of a service built using ASP.NET Core (.NET 7).
- Host: GitHub
- URL: https://github.com/hannahchan/scaffold.service
- Owner: hannahchan
- License: mit
- Created: 2019-01-11T21:55:48.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2022-11-19T23:35:07.000Z (over 3 years ago)
- Last Synced: 2025-04-11T13:25:04.007Z (about 1 year ago)
- Topics: clean-architecture, dotnet, explicit-architecture, template
- Language: C#
- Homepage:
- Size: 1.17 MB
- Stars: 9
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Scaffold.Service
Scaffold.Service is an opinionated template of a service built using ASP.NET Core. It is intended to be used as an example for, or as a bootstrap to, the development of other services and aims to address some common concerns when building microservices with ASP.NET Core. Scaffold is an example of a [Service Template](https://www.thoughtworks.com/radar/techniques/tailored-service-templates).
## How to Use
To bootstrap your next service with Scaffold.Service.
1. Install or update the template package from [NuGet.org](https://www.nuget.org/packages/Scaffold.Service) onto your computer by running;
```
dotnet new install Scaffold.Service
```
2. Create your new service by running;
```
dotnet new scaffold.service --output
```
3. Update `README.md` and all other documentation in your service so that it makes sense.
Alternatively just browse the [template directory](Scaffold) to copy and paste the parts of the service that you actually need.
## Features
Scaffold.Service comes pre-configured with or aims to make developing the following features in your next service a little bit more easier.
- [API Documentation](./Scaffold/Docs/ApiDocumentation.md)
- [Content Negotiation](./Scaffold/Docs/ContentNegotiation.md)
- [Error Handling](./Scaffold/Docs/ErrorHandling.md)
- [Health Checks](./Scaffold/Docs/HealthChecks.md)
- [Logging](./Scaffold/Docs/Logging.md)
- [Metrics](./Scaffold/Docs/Metrics.md)
- [Tracing](./Scaffold/Docs/Tracing.md)
### Developer / Team Experience
Other stuff you inherit when you bootstrap with Scaffold.Service.
- [Architecture](./Scaffold/Docs/Architecture.md)
- [Code Analysis and Formatting](./Scaffold/Docs/CodeAnalysisAndFormatting.md)
- [Cross-platform Support](./Scaffold/Docs/CrossPlatformSupport.md)
- [Deterministic Builds](./Scaffold/Docs/DeterministicBuilds.md)
- [Development Container](./Scaffold/Docs/DevelopmentContainer.md)
- [Docker Support](./Scaffold/Docs/Docker.md)
- [Entity Framework Support](./Scaffold/Docs/EntityFramework.md)
- [Nullable Reference Types](./Scaffold/Docs/NullableReferenceTypes.md)
- [Software Bill of Materials](./Scaffold/Docs/SoftwareBillOfMaterials.md)
- [Test Structure](./Scaffold/Docs/TestStructure.md)
### Not Included
Stuff you might want to add to your service but not included with Scaffold.Service.
- [API Versioning](https://github.com/Microsoft/aspnet-api-versioning)
- [Authentication](https://learn.microsoft.com/aspnet/core/security/authentication) and [Authorization](https://learn.microsoft.com/aspnet/core/security/authorization)
- [Caching](https://learn.microsoft.com/dotnet/core/extensions/caching) (See also [Overview of caching in ASP.NET Core](https://learn.microsoft.com/aspnet/core/performance/caching/overview))
- [Console Log Formatting](https://learn.microsoft.com/dotnet/core/extensions/console-log-formatter)
- [Cross-Origin Resource Sharing (CORS)](https://learn.microsoft.com/aspnet/core/security/cors)
- [Feature Gates](https://github.com/hannahchan/FeatureGates.Net)
- [Forwarded Headers Handling](https://learn.microsoft.com/aspnet/core/host-and-deploy/proxy-load-balancer)
- [Header Propagation](https://learn.microsoft.com/aspnet/core/fundamentals/http-requests#header-propagation-middleware)
- [Response Compressions](https://learn.microsoft.com/aspnet/core/performance/response-compression)
- [Secrets Management](https://learn.microsoft.com/aspnet/core/security/app-secrets)
If building microservices, you may want to bring your own sidecars.
## Example App
Scaffold.Service includes an example application which is intended to be replaced with your actual application when using this template. This example application has been included to help demonstrate features in this template.
The example application is a simple CRUD application where you can create **Buckets** and put **Items** in them. The Buckets have a _size_ which represents the number of Items you can put in them. To _Create_, _Read_, _Update_ and _Delete_ Buckets or Items in the application, simply send HTTP _POST_, _GET_, _PUT_ or _DELETE_ requests to the service.
Explore the service by going to `/swagger` in a web browser.
## Create Your Own
You are also invited to fork this repository to create your own template. Organizations may want to do this to pre-configure the template to work in their environment and incorporate their own sensible defaults.
For more information about custom templates, please checkout [_Custom templates for dotnet new_](https://learn.microsoft.com/dotnet/core/tools/custom-templates).
## Acknowledgements
Scaffold.Service has been inspired by and built from the prior experience and work of many others. In particular, Scaffold.Service heavily relies on the open-source community and those who support that community. Please consider contributing back to their open-source projects in whatever way you can.