Add how-to guide for adopting Aspire in existing applications (#67)

* Initial plan

* Add comprehensive tutorial for adding Aspire to existing apps

Co-authored-by: IEvangelist <[email protected]>

* Final verification complete

Co-authored-by: IEvangelist <[email protected]>

* Address PR feedback: Update badge to How-to, remove project-based AppHost, add config injection explanation

Co-authored-by: IEvangelist <[email protected]>

* refactor: update documentation and labels for adding Aspire to existing apps

* Add missing PeriodicExportingMetricReader import to JavaScript telemetry example

Co-authored-by: IEvangelist <[email protected]>

* Add How-to badge back to sidebar navigation

Co-authored-by: IEvangelist <[email protected]>

* Update sidebar.topics.ts

* Update src/frontend/src/content/docs/get-started/add-aspire-existing-app.mdx

Co-authored-by: Meir Blachman <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: IEvangelist <[email protected]>
Co-authored-by: David Pine <[email protected]>
Co-authored-by: Meir Blachman <[email protected]>

Author: 3 people

src/frontend/sidebar.topics.ts

@@ -212,6 +212,28 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
                 'zh-CN': '',
               }
             }
+          },
+          {
+            label: "Aspireify an existing app",
+            translations: {
+              "da": "Aspireify en eksisterende app",
+              "de": "Eine bestehende App Aspireify",
+              "en": "Aspireify an existing app",
+              "es": "Aspireify una aplicación existente",
+              "fr": "Aspireify une application existante",
+              "hi": "मौजूदा ऐप को Aspireify करें",
+              "id": "Aspireify aplikasi yang sudah ada",
+              "it": "Aspireify un'app esistente",
+              "ja": "既存のアプリを Aspireify する",
+              "ko": "기존 앱을 Aspireify하기",
+              "pt-BR": "Aspireify um app existente",
+              "pt-PT": "Aspireify uma app existente",
+              "ru": "Aspireify существующее приложение",
+              "tr": "Mevcut bir uygulamayı Aspireify et",
+              "uk": "Aspireify наявний застосунок",
+              "zh-CN": "对现有应用进行 Aspireify"
+            },
+            slug: 'get-started/add-aspire-existing-app'
           }
         ]
       },
@@ -1629,4 +1651,4 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
       },
     ]
   },
-];
+];

src/frontend/src/components/InstallPackage.astro

@@ -5,9 +5,14 @@ import { Aside, Code, TabItem, Tabs } from "@astrojs/starlight/components";
 interface Props {
     packageName: string;
     shortName?: string;
+    omitPackageReference?: boolean;
 }
 
-const { packageName, shortName = generateFriendlyName(packageName) } = Astro.props;
+const {
+    packageName,
+    shortName = generateFriendlyName(packageName),
+    omitPackageReference,
+} = Astro.props;
 
 const cliCommandTitle = Astro.locals.t("package.cliCommandTitle", {
     packageName,
@@ -46,10 +51,12 @@ const appHostCode = `#:package ${packageName}@*`;
             {Astro.locals.t("package.autoCliSelection")}
         </Aside>
     </TabItem>
-    <TabItem label="AppHost.cs (C# file-based app)">
+    <TabItem label="apphost.cs (C# file-based app)">
         <Code lang="csharp" title={appHostTitle} code={appHostCode} />
     </TabItem>
-    <TabItem label="PackageReference (*.csproj)">
-        <Code lang="xml" title={packageReferenceTitle} code={packageCode} />
-    </TabItem>
+    {!omitPackageReference && (
+        <TabItem label="PackageReference (*.csproj)">
+            <Code lang="xml" title={packageReferenceTitle} code={packageCode} />
+        </TabItem>
+    )}
 </Tabs>