Tech Hub is a modern .NET 10 web application built with Blazor that serves as a technical content hub — a fast, responsive, accessible platform for showcasing technical content across AI, GitHub Copilot, Azure, .NET, DevOps, Security, and ML topics.
| Layer | Technology |
|---|---|
| Backend | ASP.NET Core Minimal API, .NET 10, C# 13 |
| Frontend | Blazor InteractiveServer with prerendering |
| Orchestration | .NET Aspire (service discovery, telemetry, health checks) |
| Database | PostgreSQL (Dapper) |
| Infrastructure | Azure App Service, Bicep IaC, GitHub Actions CI/CD |
| Testing | xUnit v3, bUnit, Playwright, Pester |
Open in a Dev Container (VS Code or GitHub Codespaces), then:
# Build, run ALL tests (unit + integration + E2E), and start servers
Run
# Start servers without tests (faster iteration)
Run -WithoutTests| URL | Service |
|---|---|
https://localhost:5003 | Web (Blazor) |
https://localhost:5001 | API (Swagger UI at /swagger) |
http://localhost:18888 | Aspire Dashboard |
See docs/running-and-testing.md for the full Run command reference, Docker mode, and targeted test execution.
┌──────────────────────────────────────────────────────┐
│ Aspire AppHost │
└──────────────────────────────────────────────────────┘
│ │ │
┌────────▼──────┐ ┌──────▼────────┐ ┌─────▼──────┐
│ TechHub.Api │ │ TechHub.Web │ │ Dashboard │
│ (port 5001) │◄┤ (port 5003) │ │ (port 18888)│
│ REST API │ │ Blazor SSR │ │ Traces/Logs │
└───────────────┘ └───────────────┘ └─────────────┘
- TechHub.Core — Domain models and interfaces (framework-agnostic)
- TechHub.Infrastructure — Dapper repositories, markdown processing, caching
See docs/architecture.md for full details.
| Directory | Purpose |
|---|---|
src/ | Application source code (API, Web, Core, Infrastructure, AppHost) |
tests/ | Unit, integration, component, E2E, and PowerShell tests |
docs/ | Functional and technical documentation |
scripts/ | PowerShell automation (build, deploy, content processing) |
infra/ | Bicep IaC templates for Azure App Service |
See docs/repository-structure.md for the complete breakdown.
All detailed documentation lives in docs/. Start with:
- docs/running-and-testing.md — Running, testing, and debugging
- docs/architecture.md — System architecture and .NET Aspire setup
- docs/technology-stack.md — Complete technology stack
- docs/testing-strategy.md — Testing Diamond approach
For AI agents: see AGENTS.md and the nested domain AGENTS.md files in each directory.