.NET Aspire Samples

Samples for .NET Aspire.

.NET Aspire is a stack for building resilient, observable, cloud-native apps with .NET.

Official Samples

Official samples hosted in this repo can be accessed via the Samples browser.

Sample highlights include:

• Aspire Shop
• Custom metrics visualization with OpenTelemetry, Prometheus & Grafana
• Integrating a Node.js app
• Integrating frontend apps using React, Vue, Angular, etc.
• Integrating a Go app using a Dockerfile
• Integrating Dapr
• Integrating Orleans
• Persisting data in composed containers using volume mounts
• Working with and initializing database containers
• Running Entity Framework Core migrations
• Integrating clients apps like WinForms

eShop

eShop is a reference .NET application implementing an eCommerce web site using a services-based architecture using .NET Aspire.

.NET Aspire Links

• .NET Aspire Documentation
• .NET Aspire Blog
• .NET Aspire GitHub

License

.NET (including the aspire-samples repo) is licensed under the MIT license.

Disclaimer

The sample applications provided in this repository are intended to illustrate individual concepts that may be beneficial in understanding the underlying technology and its potential uses. These samples may not illustrate best practices for production environments.

The code is not intended for operational deployment. Users should exercise caution and not rely on the samples as a foundation for any commercial or production use. See ASP.NET Core security topics for more information on security concerns related to hosting ASP.NET Core applications.

Contributing

We welcome contributions to this repository of samples related to official .NET Aspire features and integrations (i.e. those pieces who's code lives in the Aspire repo and that ship from the Aspire NuGet account). It's generally a good idea to log an issue first to discuss any idea for a sample with the team before sending a pull request.

Code of conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information, see the .NET Foundation Code of Conduct.