microsoft / microsoft/aspire.dev

[GitHub Discussions] App Model & Core API gaps

Open
#356 0 comments 0 reactions 1 assignee View on GitHub

@IEvangelist is already working on this.

Since Jun 2, 2026.

external feedback
Dominant language
MDX
Stars
193
Forks
87
Avg merge
1d 22h
Merged PRs (30d)
73

Description

Summary

Based on analysis of 820 GitHub discussions from dotnet/aspire.

Question counts:

Topic Questions
Resource/Endpoint/Binding 174
Networking (ports, localhost) 40+
WaitFor/Lifecycle 25+

Docs That Exist - Verified If They Answer Questions

✅ Questions Answered by Docs
Question Doc Section That Answers
https://github.com/dotnet/aspire/discussions/12484: Overriding Kestrel endpoints from appsettings.json? inner-loop-networking-overview "Kestrel configured endpoints" - ExcludeKestrelEndpoints = false
How does WaitFor work? what-is-the-apphost "Defining your architecture" - WaitFor(postgres) delays startup
How do container networks work? inner-loop-networking-overview "How container networks are managed" - bridge network, DNS
How do proxies and ports work? inner-loop-networking-overview "Ports and proxies" - detailed with diagrams
❌ Questions NOT Answered by Any Doc
Question Searched Docs What's Missing
https://github.com/dotnet/aspire/discussions/14003: Endpoint different from localhost (LAN access) inner-loop-networking-overview No 0.0.0.0 binding for external access
https://github.com/dotnet/aspire/discussions/13840: Optimizing app host start up time what-is-the-apphost Explains WaitFor but no performance optimization
https://github.com/dotnet/aspire/discussions/13670: Launching Desktop Applications None No console/desktop app integration docs
How to bind to 0.0.0.0 for LAN? inner-loop-networking-overview Not covered - only localhost scenarios
CORS configuration None No CORS documentation exists

Critical Gaps - No Documentation Exists

❌ P1: Console/Desktop App Integration

Questions: https://github.com/dotnet/aspire/discussions/13670, plus many Discord questions
Status: No docs exist
Missing:

  • Console app integration guide
  • Background worker patterns
  • Non-HTTP service patterns
  • WPF/WinForms (MAUI exists, but not WPF)
❌ P1: External Network Access (0.0.0.0)

Questions: https://github.com/dotnet/aspire/discussions/14003, plus Discord questions about LAN access
Status: Not in inner-loop-networking-overview
Missing:

  • Binding to 0.0.0.0
  • LAN development scenarios
  • External access patterns
❌ P2: CORS Configuration

Questions: ~3 GitHub, 10+ Discord
Status: No docs exist
Missing:

  • When CORS is needed with Aspire
  • CORS dev vs prod configuration
  • Common CORS troubleshooting
❌ P2: Startup Performance

Questions: https://github.com/dotnet/aspire/discussions/13840, https://github.com/dotnet/aspire/discussions/12518
Status: WaitFor documented but not optimization
Missing:

  • Startup optimization patterns
  • Reducing container pull time
  • Parallel startup options

Data Source

  • GitHub Discussions: 820 total, 174 app-model related
  • Verification method: aspire-get_doc to read actual doc content
  • Date: February 2026

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.