Skip to content

Aspire: Add README for Aspire AppHost setup and usage#7646

Merged
sbrown-livefront merged 7 commits into
mainfrom
aspire/add-readme
May 15, 2026
Merged

Aspire: Add README for Aspire AppHost setup and usage#7646
sbrown-livefront merged 7 commits into
mainfrom
aspire/add-readme

Conversation

@sbrown-livefront
Copy link
Copy Markdown
Collaborator

@sbrown-livefront sbrown-livefront commented May 15, 2026

🎟️ Tracking

N/A

📔 Objective

Adds Readme on how to use Aspire locally.

@sbrown-livefront sbrown-livefront self-assigned this May 15, 2026
@sbrown-livefront sbrown-livefront marked this pull request as ready for review May 15, 2026 17:57
@sbrown-livefront sbrown-livefront changed the title docs(AppHost): Add README for Aspire AppHost setup and usage Aspire: Add README for Aspire AppHost setup and usage May 15, 2026
@sbrown-livefront
Copy link
Copy Markdown
Collaborator Author

@justindbaur sorry for the additional pings. Adding you to make sure it's okay to add a Readme at the project level.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 15, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 59.84%. Comparing base (419edd5) to head (5a9b042).

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #7646      +/-   ##
==========================================
- Coverage   59.84%   59.84%   -0.01%     
==========================================
  Files        2121     2121              
  Lines       93460    93460              
  Branches     8291     8291              
==========================================
- Hits        55932    55931       -1     
- Misses      35547    35548       +1     
  Partials     1981     1981              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment thread AppHost/README.md Outdated
Comment on lines +62 to +66
dotnet user-secrets set "Services:admin:BasePort" "62911"
dotnet user-secrets set "Services:api:BasePort" "4000"
dotnet user-secrets set "Services:billing:BasePort" "44519"
dotnet user-secrets set "Services:identity:BasePort" "33656"
dotnet user-secrets set "Services:notifications:BasePort" "61840"
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I think I missed this in the original review, I knew you did an empty string but I thought I saw something about it resolving from launchSettings.json by default? Why shouldn't these already be set in appsettings.Development.json?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

We had the URIs defined in secrets.json previously. I wasn't sure if we wanted them in settings. I don't see any harm in having them in appsettings, I was just a bit wary. Addressed in fecfa8e

Comment thread AppHost/README.md Outdated
Runs the web client alongside the server services. Requires the Bitwarden
[clients](https://github.com/bitwarden/clients) repo cloned as a sibling to `server`.

1. Enable the plugin in `AppHost.csproj`:
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

The way I would recommend doing this would be you'd create your own AppHost.csproj.user file and put these property values there. That way you don't have to remember to not commit them.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This is dope. I wasn't familiar with the user copy. Addressed in 06413de

@sonarqubecloud
Copy link
Copy Markdown

@sbrown-livefront sbrown-livefront merged commit 968afb5 into main May 15, 2026
55 checks passed
@sbrown-livefront sbrown-livefront deleted the aspire/add-readme branch May 15, 2026 19:55
@theMickster
Copy link
Copy Markdown
Contributor

Thank you @sbrown-livefront!

@djsmith85 djsmith85 added the t:feature Change Type - Feature Development label May 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

t:feature Change Type - Feature Development

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants