Skip to content

docs: document the 'Use *.dev.localhost URLs?' interactive prompt for aspire new#697

Open
Copilot wants to merge 5 commits intomainfrom
copilot/add-documentation-aspire-new-command
Open

docs: document the 'Use *.dev.localhost URLs?' interactive prompt for aspire new#697
Copilot wants to merge 5 commits intomainfrom
copilot/add-documentation-aspire-new-command

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 10, 2026

The aspire new command reference page had no documentation for the "Use *.dev.localhost URLs?" interactive prompt, leaving users without enough context to make an informed choice.

Changes

  • New "Interactive prompts" section in aspire-new.mdx with a dedicated sub-section for the *.dev.localhost prompt
  • Explains the prompt's effect: whether the generated launch profile uses wildcard *.dev.localhost subdomains (HTTPS) vs. standard localhost:<port> (HTTP)
  • Yes path: per-service HTTPS subdomain URLs, isolated cookie/auth origins, production-like topology; documents the aspire certs trust prerequisite with a <LearnMore> link to the aspire certs trust command reference
  • No path (default): plain http://localhost:<port>, no certificate setup required, works everywhere
  • Safari caveat: *.dev.localhost subdomains don't resolve natively in Safari; added an <Aside> note pointing users to choose No or add a hosts-file entry

… aspire new

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/49848864-c0a9-482c-a045-a860f76cb80f

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI changed the title [WIP] Add documentation for '*.dev.localhost' prompt in aspire new command docs: document the 'Use *.dev.localhost URLs?' interactive prompt for aspire new Apr 10, 2026
Copilot AI requested a review from IEvangelist April 10, 2026 13:33
@IEvangelist IEvangelist marked this pull request as ready for review April 10, 2026 19:58
@IEvangelist IEvangelist requested a review from mitchdenny as a code owner April 10, 2026 19:58
Copilot AI review requested due to automatic review settings April 10, 2026 19:58
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds missing reference documentation for the aspire new interactive prompt “Use *.dev.localhost URLs?” so users understand the tradeoffs between wildcard subdomain HTTPS URLs and standard localhost URLs during template creation.

Changes:

  • Adds an Interactive prompts section to the aspire new command reference.
  • Documents what choosing Yes vs No does for generated service URLs.
  • Adds a Safari-related note for *.localhost-style subdomains.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
…host wording

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/b4be3134-13a1-4f17-b67e-dd41e7a87ace

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Copilot AI requested a review from IEvangelist April 11, 2026 02:13
@IEvangelist IEvangelist enabled auto-merge (squash) April 11, 2026 02:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

aspire new command article is missing documentation for the 'Use *.dev.localhost URLs?' prompt

3 participants