microsoft / microsoft/aspire.dev
[GitHub Discussions] App Model & Core API gaps
@IEvangelist is already working on this.
Since Jun 2, 2026.
- 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_docto read actual doc content - Date: February 2026
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.