Merge pull request #7301 from diberry/diberry/0519-tsp-js-2

JS TypeSpec quickstart for a scaffolded server 2

Author: denrea

articles/typespec/TOC.yml

@@ -8,6 +8,8 @@
   items:
     - name: .NET
       href: quickstart-scaffold-dotnet.md
+    - name: TypeScript
+      href: quickstart-scaffold-typescript.md
 - name: Resources
   items:
     - name: Getting started

articles/typespec/includes/quickstart/file-structure-typescript.md

@@ -3,14 +3,45 @@ ms.custom: devx-track-ts, devx-track-typespec
 ms.topic: include
 ms.date: 04/23/2025
 ---
-The project structure for the generated server includes the Express.js server, the package.json, and the middleware for your Azure integration. 
+The Express.js project structure found at `tsp-output/server/` includes the generated server, the package.json, and the middleware for your Azure integration. 
 
 ```console
-├── docs
-├── generated
-├── mocks
-├── server.ts
-├── README.md
+server
 ├── package.json
-├── openapi3.json
+├── package-lock.json
+├── src
+│   ├── controllers
+│   │   └── widgets.ts
+│   ├── generated
+│   │   ├── helpers
+│   │   │   ├── datetime.ts
+│   │   │   ├── header.ts
+│   │   │   ├── http.ts
+│   │   │   ├── multipart.ts
+│   │   │   ├── router.ts
+│   │   │   └── temporal
+│   │   │       ├── native.ts
+│   │   │       └── polyfill.ts
+│   │   ├── http
+│   │   │   ├── openapi3.ts
+│   │   │   ├── operations
+│   │   │   │   └── server-raw.ts
+│   │   │   └── router.ts
+│   │   └── models
+│   │       └── all
+│   │           ├── demo-service.ts
+│   │           └── typespec.ts
+│   ├── index.ts
+│   └── swagger-ui.ts
+```
+
+The file structure for the parent TypeSpec project includes this Express.js project in `tsp-output`:
+
+```console
+├── tsp-output
+├── .gitignore
+├── main.tsp
+├── package-lock.json
+├── package.json
+├── tspconfig.yaml
 ```

articles/typespec/includes/quickstart/prereqs-typescript.md

@@ -6,7 +6,7 @@ ms.date: 04/23/2025
 * An active Azure account. [Create an account for free](https://azure.microsoft.com/free) if you don't have one.
 * [Node.js LTS](https://nodejs.org/) installed on your system.
 * [TypeScript](https://www.typescriptlang.org/) for writing and compiling TypeScript code.
-
+* [Docker](https://www.docker.com/)
 * [Visual Studio Code](https://code.visualstudio.com/)
 * [TypeSpec extension](https://marketplace.visualstudio.com/items?itemName=typespec.typespec-vscode)
-* Optional: Deployment with [Azure Developer CLI](azure/developer/azure-developer-cli/)
+* Optional: Deployment with [Azure Developer CLI](/azure/developer/azure-developer-cli/)

articles/typespec/index.yml

@@ -25,6 +25,8 @@ landingContent:
             url: https://typespec.io/docs/
           - text: .NET Quickstart
             url: quickstart-scaffold-dotnet.md
+          - text: TypeScript Quickstart
+            url: quickstart-scaffold-typescript.md
 
   - title: API language
     linkLists:

articles/typespec/quickstart-scaffold-dotnet.md

@@ -1012,6 +1012,27 @@ Create the files needed to have a repeatable deployment with [Azure Developer CL
     ...bicep..
     ```
 
+## Project structure
+
+The final project structure includes the TypeSpec API files, the Express.js server, and the Azure deployment files: 
+
+```console
+├── infra
+├── tsp-output
+├── .gitignore
+├── .azure.yaml
+├── Dockerfile
+├── main.tsp
+├── package-lock.json
+├── package.json
+├── tspconfig.yaml
+```
+
+| Area                     | Files/Directories                                                                 |
+|--------------------------|-----------------------------------------------------------------------------------|
+| **TypeSpec**             | `main.tsp`, `tspconfig.yaml`                                        |
+| **Express.js server**    | `./tsp-output/server/` (includes generated files like `controllers/`, `models/`, `ServiceProject.csproj`) |
+| **Azure Developer CLI deployment** | `./azure.yaml`,`./infra/`                             |
 
 ## Deploy application to Azure