AdventureWorks is a sample application built around Microsoft's AdventureWorks SQL Server database. This repository contains the web application, APIs, database tooling, infrastructure, and local development tools.
| Area | Technology |
|---|---|
| Backend | .NET 10 |
| Functions | .NET 10 Azure Functions and a Rust custom handler |
| Frontend | Angular 21 and Nx 22 |
| Design system | Tailwind CSS 4 and DaisyUI 5 |
| Database | SQL Server, Entity Framework Core, DbUp, Cosmos DB |
| Messaging | Azure Service Bus, RabbitMQ (integration tests) |
| Caching | Redis |
| Local orchestration | .NET Aspire |
| Containers | Docker Compose |
| Testing | xUnit, Vitest, and Playwright |
- .NET 10 SDK
- Node.js 24 or later and npm
- A Docker-compatible container runtime
- Access to a SQL Server instance containing the AdventureWorks database
- Visual Studio or Visual Studio Code
- Optional: SQL Server Management Studio
Run these commands from the repository root:
cd apps/angular-web
npm install
cd ../..
dotnet user-secrets set "ConnectionStrings:AdventureWorks" "YOUR_CONNECTION_STRING" --project tools/aspire/AdventureWorks.AppHost
dotnet run --project tools/aspire/AdventureWorks.AppHostContinue with the Aspire local development guide for all other setup and usage instructions.
AdventureWorks/
├── apps/ # Application workspaces
│ ├── angular-web/ # Angular workspace
│ ├── api-dotnet/ # .NET API
│ │ ├── src/ # API source projects
│ │ └── tests/ # API test projects
│ ├── functions-dotnet/ # Azure Functions workspace
│ │ ├── src/ # Functions source projects
│ │ └── tests/ # Functions test projects
│ └── functions-rust/ # Rust Azure Functions custom handler (BOM cost engine)
│ ├── src/ # Handler library and binary
│ └── tests/ # Integration and live tests
├── database/ # Database projects and migration tooling
├── docker/ # Docker Compose configuration
├── docs/ # Repository documentation
├── infra/ # Infrastructure as code
├── pipelines/ # CI/CD definitions and templates
└── tools/ # Local development and utility projects
├── aspire/ # Aspire AppHost and its documentation
└── console-apps/ # Command-line utilities
This project is licensed under the MIT License.