Skip to content

Split deploy-first-app into C# and TypeScript AppHost pages#615

Open
davidfowl wants to merge 1 commit intomainfrom
davidfowl/deployment-update
Open

Split deploy-first-app into C# and TypeScript AppHost pages#615
davidfowl wants to merge 1 commit intomainfrom
davidfowl/deployment-update

Conversation

@davidfowl
Copy link
Contributor

Summary

Splits the monolithic 1350-line deploy-first-app.mdx into three focused pages, matching the established pattern used by "Build your first app" and "Aspireify an existing app."

Changes

New files

  • deploy-first-app.mdx — Short CardGrid landing page (33 lines) with links to C# and TypeScript paths
  • deploy-first-app-csharp.mdx — C#/Python pivot deploy tutorial (Docker Compose + Azure tabs)
  • deploy-first-app-typescript.mdx — Standalone JS/TS deploy tutorial with no pivots — feels native to TypeScript developers

Updated files

  • docs.topics.ts — Sidebar: single slug → collapsed group (Overview / C# AppHost / TypeScript AppHost)
  • first-app-typescript-apphost.mdx — Added deploy link in LearnMore section (previously had no deploy path)
  • add-aspire-existing-app-typescript-apphost.mdx — Deploy links now point to TS-specific page
  • add-aspire-existing-app-csharp-apphost.mdx — Deploy links now point to C#-specific page
  • whats-new/aspire-13.mdx (en + ja) — ?lang=python links updated to C# deploy page
  • dashboard/standalone-for-python.mdx?lang=python link updated to C# deploy page

Why

A TypeScript developer finishing the TS quickstart had no clear path to deploy — the existing deploy page was framed around C#/Python/JavaScript pivots, which is confusing when you've been working in apphost.ts. Now each AppHost language gets a first-class deploy tutorial.

Validation

  • ✅ Full pnpm build passes — all internal links valid, 13,182 pages
  • ✅ All 12 internal link targets verified
  • ✅ Playwright tested: landing page, C# page, TS page all render correctly
  • ✅ No unused imports, no terminology issues, no cross-contamination between pages

- Replace 1350-line monolithic deploy tutorial with landing page + two focused pages
- deploy-first-app.mdx: short CardGrid landing (matches first-app.mdx pattern)
- deploy-first-app-csharp.mdx: C#/Python pivots, Docker Compose + Azure tabs
- deploy-first-app-typescript.mdx: standalone JS/TS page, no pivots needed
- Update sidebar to collapsed group with Overview/C#/TypeScript items
- Update links from TS-specific pages to TS deploy, Python links to C# deploy
- Add deploy link to first-app-typescript-apphost.mdx LearnMore section

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI review requested due to automatic review settings March 26, 2026 05:56
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.

1 participant