@aws/nx-plugin-mcp 0.121.0 → 1.0.0-rc.0

package/bin/aws-nx-mcp.js

@@ -19072,12 +19072,20 @@ var generators$1 = {
 		"metric": "g20",
 		"hidden": true
 	},
+	"py#api": {
+		"factory": "./src/py/api/generator",
+		"schema": "./src/py/api/schema.json",
+		"description": "Create a Python API",
+		"metric": "g45",
+		"guidePages": ["py-api", "fastapi"]
+	},
 	"py#fast-api": {
 		"factory": "./src/py/fast-api/generator",
 		"schema": "./src/py/fast-api/schema.json",
 		"description": "Generates a FastAPI Python project",
 		"metric": "g3",
-		"guidePages": ["fastapi"]
+		"guidePages": ["fastapi"],
+		"hidden": true
 	},
 	"py#fast-api#react-connection": {
 		"factory": "./src/py/fast-api/react/generator",
@@ -19147,12 +19155,20 @@ var generators$1 = {
 		"metric": "g23",
 		"guidePages": ["terraform-project"]
 	},
+	"ts#docs": {
+		"factory": "./src/ts/docs/generator",
+		"schema": "./src/ts/docs/schema.json",
+		"description": "Generates a documentation site",
+		"metric": "g43",
+		"guidePages": ["docs", "astro-docs"]
+	},
 	"ts#astro-docs": {
 		"factory": "./src/ts/astro-docs/generator",
 		"schema": "./src/ts/astro-docs/schema.json",
 		"description": "Generates an Astro + Starlight documentation site with localisation, snippets, blog, and optional automated documentation translation",
 		"metric": "g37",
-		"guidePages": ["astro-docs"]
+		"guidePages": ["astro-docs"],
+		"hidden": true
 	},
 	"ts#infra": {
 		"factory": "./src/infra/app/generator",
@@ -19193,19 +19209,35 @@ var generators$1 = {
 		"metric": "g1",
 		"guidePages": ["typescript-project"]
 	},
+	"ts#website": {
+		"factory": "./src/ts/website/app/generator",
+		"schema": "./src/ts/website/app/schema.json",
+		"description": "Generates a website application",
+		"metric": "g43",
+		"guidePages": ["website", "react-website"]
+	},
+	"ts#website#auth": {
+		"factory": "./src/ts/website/auth/generator",
+		"schema": "./src/ts/website/auth/schema.json",
+		"description": "Adds auth to an existing website",
+		"metric": "g44",
+		"guidePages": ["react-website-auth"]
+	},
 	"ts#react-website": {
 		"factory": "./src/ts/react-website/app/generator",
 		"schema": "./src/ts/react-website/app/schema.json",
 		"description": "Generates a React static website",
 		"metric": "g5",
-		"guidePages": ["react-website"]
+		"guidePages": ["react-website"],
+		"hidden": true
 	},
 	"ts#react-website#auth": {
 		"factory": "./src/ts/react-website/cognito-auth/generator",
 		"schema": "./src/ts/react-website/cognito-auth/schema.json",
 		"description": "Adds auth to an existing React website",
 		"metric": "g6",
-		"guidePages": ["react-website-auth"]
+		"guidePages": ["react-website-auth"],
+		"hidden": true
 	},
 	"ts#react-website#runtime-config": {
 		"factory": "./src/ts/react-website/runtime-config/generator",
@@ -19218,7 +19250,8 @@ var generators$1 = {
 		"factory": "./src/smithy/ts/api/generator",
 		"schema": "./src/smithy/ts/api/schema.json",
 		"description": "Create an API using Smithy and the Smithy TypeScript Server SDK",
-		"metric": "g26"
+		"metric": "g26",
+		"hidden": true
 	},
 	"ts#agent": {
 		"factory": "./src/ts/agent/generator",
@@ -19261,12 +19294,24 @@ var generators$1 = {
 		"metric": "g29",
 		"hidden": true
 	},
+	"ts#api": {
+		"factory": "./src/ts/api/generator",
+		"schema": "./src/ts/api/schema.json",
+		"description": "Create a TypeScript API",
+		"metric": "g46",
+		"guidePages": [
+			"ts-api",
+			"trpc",
+			"ts-smithy-api"
+		]
+	},
 	"ts#trpc-api": {
 		"factory": "./src/trpc/backend/generator",
 		"schema": "./src/trpc/backend/schema.json",
 		"description": "creates a trpc backend",
 		"metric": "g9",
-		"guidePages": ["trpc"]
+		"guidePages": ["trpc"],
+		"hidden": true
 	},
 	"ts#trpc-api#react-connection": {
 		"factory": "./src/trpc/react/generator",

package/docs/guides/astro-docs.mdx

@@ -1,7 +1,9 @@
 ---
 title: Astro Docs
 description: Reference documentation for an Astro + Starlight documentation site
-generator: ts#astro-docs
+when:
+  framework:
+    - astro
 ---
 import { FileTree } from '@astrojs/starlight/components';
 import RunGenerator from '@components/run-generator.astro';
@@ -23,11 +25,11 @@ By default it also scaffolds an automated translation pipeline powered by a
 
 You can generate a new Astro docs site in two ways:
 
-<RunGenerator generator="ts#astro-docs" />
+<RunGenerator generator="ts#docs" />
 
 ### Options
 
-<GeneratorParameters generator="ts#astro-docs" />
+<GeneratorParameters generator="ts#docs" />
 
 ## Generator Output
 

package/docs/guides/connection/react-agui.mdx

@@ -21,9 +21,9 @@ Nx Plugin for AWS provides a generator to connect a React website to an Agent th
 
 Before using this generator, ensure you have:
 
-1. A React website (generated using the <Link path="guides/react-website">`ts#react-website` generator</Link>)
+1. A React website (generated using the <Link path="guides/react-website">`ts#website` generator</Link>)
 2. A TypeScript or Python Agent with `protocol=AG-UI` (generated using the <Link path="guides/ts-agent">`ts#agent`</Link> or <Link path="guides/py-agent">`py#agent`</Link> generator)
-3. For deployed agents, Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link>
+3. For deployed agents, Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>
 
 ## Usage
 

package/docs/guides/connection/react-fastapi.mdx

@@ -22,7 +22,7 @@ Before using this generator, ensure your React application has:
 
 1. A `main.tsx` file that renders your application
 2. A working FastAPI backend (generated using the FastAPI generator)
-3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link> if connecting an API which uses Cognito or IAM auth
+3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link> if connecting an API which uses Cognito or IAM auth
 
 <details>
 <summary>Example of required `main.tsx` structure</summary>

package/docs/guides/connection/react-py-agent.mdx

@@ -23,9 +23,9 @@ If your Python Agent was generated with `protocol=AG-UI`, the connection generat
 
 Before using this generator, ensure you have:
 
-1. A React website (generated using the <Link path="guides/react-website">`ts#react-website` generator</Link>)
+1. A React website (generated using the <Link path="guides/react-website">`ts#website` generator</Link>)
 2. A Python Agent with `protocol=HTTP` (generated using the <Link path="guides/py-agent">`py#agent` generator</Link>)
-3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link>
+3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>
 
 ## Usage
 

package/docs/guides/connection/react-smithy.mdx

@@ -22,7 +22,7 @@ Before using this generator, ensure your React application has:
 
 1. A `main.tsx` file that renders your application
 2. A working Smithy TypeScript API backend (generated using the <Link path="/guides/ts-smithy-api">`ts#smithy-api` generator</Link>)
-3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link> if connecting an API which uses Cognito or IAM auth
+3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link> if connecting an API which uses Cognito or IAM auth
 
 <details>
 <summary>Example of required `main.tsx` structure</summary>

package/docs/guides/connection/react-trpc.mdx

@@ -19,7 +19,7 @@ Before using this generator, ensure your React application has:
 1. A `main.tsx` file that renders your application
 2. An `<App/>` JSX element where the tRPC provider will be automatically injected
 3. A working tRPC API (generated using the tRPC API generator)
-4. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link> if connecting an API which uses Cognito or IAM auth
+4. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link> if connecting an API which uses Cognito or IAM auth
 
 <details>
 <summary>Example of required `main.tsx` structure</summary>

package/docs/guides/connection/react-ts-agent.mdx

@@ -18,9 +18,9 @@ Nx Plugin for AWS provides a generator to quickly integrate your <Link path="gui
 
 Before using this generator, ensure you have:
 
-1. A React website (generated using the <Link path="guides/react-website">`ts#react-website` generator</Link>)
+1. A React website (generated using the <Link path="guides/react-website">`ts#website` generator</Link>)
 2. A TypeScript Agent (generated using the <Link path="guides/ts-agent">`ts#agent` generator</Link>)
-3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link>
+3. Cognito Auth added via the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>
 
 ## Usage
 

package/docs/guides/docs.mdx

@@ -0,0 +1,21 @@
+---
+title: Documentation Site
+description: Reference documentation for the ts#docs generator
+generator: ts#docs
+---
+import Astro from '@astrojs/react';
+import { CardGrid } from '@astrojs/starlight/components';
+import FrameworkCard from '@components/framework-card.astro';
+
+This generator creates a documentation site for your project. Use the `framework` option to select which documentation framework to use.
+
+## Frameworks
+
+<CardGrid>
+  <FrameworkCard
+    title="Astro + Starlight"
+    description="Documentation site powered by Astro and the Starlight docs theme with localisation, snippets, blog, and automated translation."
+    href={`/nx-plugin-for-aws/${Astro.currentLocale || 'en'}/guides/astro-docs`}
+    logo="astro"
+  />
+</CardGrid>

package/docs/guides/fastapi.mdx

@@ -2,6 +2,8 @@
 title: FastAPI
 description: Reference documentation for FastAPI
 generator: py#fast-api
+when:
+  framework: [fastapi]
 ---
 
 import { FileTree, Tabs, TabItem } from '@astrojs/starlight/components';
@@ -273,7 +275,7 @@ export class ExampleStack extends Stack {
 }
 ```
 
-The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link>
+The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>
 :::
 </OptionFilter>
 

package/docs/guides/py-api.mdx

@@ -0,0 +1,22 @@
+---
+title: Python API
+description: Reference documentation for the Python API generator
+generator: py#api
+---
+import Astro from '@astrojs/react';
+import { CardGrid } from '@astrojs/starlight/components';
+import GeneratorParameters from '@components/generator-parameters.astro';
+import FrameworkCard from '@components/framework-card.astro';
+
+The Python API generator creates a new API project with your choice of framework. It currently supports [FastAPI](https://fastapi.tiangolo.com/) for building modern, high-performance Python APIs.
+
+## Frameworks
+
+<CardGrid>
+  <FrameworkCard
+    title="FastAPI"
+    description="A modern Python web framework for building APIs with automatic OpenAPI documentation, request validation, and async support."
+    href={`/nx-plugin-for-aws/${Astro.currentLocale || 'en'}/guides/fastapi`}
+    logo="fastapi"
+  />
+</CardGrid>

package/docs/guides/react-website-auth.mdx

@@ -1,7 +1,7 @@
 ---
 title: React Website Authentication
 description: Reference documentation for React Website Authentication
-generator: ts#react-website#auth
+generator: ts#website#auth
 ---
 import { FileTree } from '@astrojs/starlight/components';
 import Link from '@components/link.astro';
@@ -21,11 +21,11 @@ This generator configures the CDK or Terraform infrastructure to create a Cognit
 
 You can add authentication to your React website in two ways:
 
-<RunGenerator generator="ts#react-website#auth" />
+<RunGenerator generator="ts#website#auth" />
 
 ### Options
 
-<GeneratorParameters generator="ts#react-website#auth" />
+<GeneratorParameters generator="ts#website#auth" />
 
 ## Generator Output
 

package/docs/guides/react-website.mdx

@@ -2,6 +2,9 @@
 title: React Website
 description: Reference documentation for a React Website
 generator: ts#react-website
+when:
+  framework:
+    - react
 ---
 import { FileTree, Steps } from '@astrojs/starlight/components';
 import Link from '@components/link.astro';
@@ -27,11 +30,11 @@ The default `uxProvider` is [Cloudscape](http://cloudscape.design/). You can als
 
 You can generate a new React Website in two ways:
 
-<RunGenerator generator="ts#react-website" />
+<RunGenerator generator="ts#website" />
 
 ### Options
 
-<GeneratorParameters generator="ts#react-website" />
+<GeneratorParameters generator="ts#website" />
 
 ## Generator Output
 
@@ -321,7 +324,7 @@ This makes the first React website you generate the default `dev` target for the
 :::
 
 :::warning[Mock Authentication]
-When run in this mode and no `runtime-config.json` is present, if you have configured Cognito Authentication (via the <Link path="/guides/react-website-auth">`ts#react-website#auth` generator</Link>), login will be skipped and requests to your local servers will not include authentication headers.
+When run in this mode and no `runtime-config.json` is present, if you have configured Cognito Authentication (via the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>), login will be skipped and requests to your local servers will not include authentication headers.
 
 To enable login and authentication for `serve-local`, deploy your infrastructure and load runtime config.
 :::

package/docs/guides/trpc.mdx

@@ -2,6 +2,8 @@
 title: tRPC
 description: Reference documentation for tRPC
 generator: ts#trpc-api
+when:
+  framework: [trpc]
 ---
 import { FileTree, Tabs, TabItem } from '@astrojs/starlight/components';
 import Link from '@components/link.astro';
@@ -587,7 +589,7 @@ export class ExampleStack extends Stack {
 }
 ```
 
-The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link>.
+The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>.
 </OptionFilter>
 
 This sets up your API infrastructure, including an AWS API Gateway REST or HTTP API, AWS Lambda functions for business logic, and authentication based on your chosen `auth` method.

package/docs/guides/ts-api.mdx

@@ -0,0 +1,28 @@
+---
+title: TypeScript API
+description: Reference documentation for the TypeScript API generator
+generator: ts#api
+---
+import Astro from '@astrojs/react';
+import { CardGrid } from '@astrojs/starlight/components';
+import GeneratorParameters from '@components/generator-parameters.astro';
+import FrameworkCard from '@components/framework-card.astro';
+
+The TypeScript API generator creates a new API project with your choice of framework. It supports [tRPC](https://trpc.io/) for end-to-end type-safe APIs and [Smithy](https://smithy.io/) for model-driven API development.
+
+## Frameworks
+
+<CardGrid>
+  <FrameworkCard
+    title="tRPC"
+    description="End-to-end type-safe APIs with TypeScript. Ideal when your frontend and backend share a TypeScript codebase."
+    href={`/nx-plugin-for-aws/${Astro.currentLocale || 'en'}/guides/trpc`}
+    logo="trpc"
+  />
+  <FrameworkCard
+    title="Smithy"
+    description="Model-driven API development using an interface definition language. Ideal for APIs consumed by multiple languages."
+    href={`/nx-plugin-for-aws/${Astro.currentLocale || 'en'}/guides/ts-smithy-api`}
+    logo="smithy"
+  />
+</CardGrid>

package/docs/guides/ts-smithy-api.mdx

@@ -2,6 +2,8 @@
 title: Smithy TypeScript API
 description: Reference documentation for Smithy TypeScript API
 generator: ts#smithy-api
+when:
+  framework: [smithy]
 ---
 
 import { FileTree } from '@astrojs/starlight/components';
@@ -479,7 +481,7 @@ export class ExampleStack extends Stack {
 }
 ```
 
-The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#react-website-auth` generator</Link>
+The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>
 :::
 </OptionFilter>
 

package/docs/guides/website.mdx

@@ -0,0 +1,21 @@
+---
+title: Website
+description: Reference documentation for the ts#website generator
+generator: ts#website
+---
+import Astro from '@astrojs/react';
+import { CardGrid } from '@astrojs/starlight/components';
+import FrameworkCard from '@components/framework-card.astro';
+
+This generator creates a website for your project. Use the `framework` option to select which frontend framework to use.
+
+## Frameworks
+
+<CardGrid>
+  <FrameworkCard
+    title="React"
+    description="React website with Vite, TanStack Router, and AWS CDK or Terraform infrastructure for static hosting on S3 + CloudFront."
+    href={`/nx-plugin-for-aws/${Astro.currentLocale || 'en'}/guides/react-website`}
+    logo="react"
+  />
+</CardGrid>

package/docs/snippets/agent/bedrock-deployment.mdx

@@ -144,7 +144,7 @@ export class ExampleStack extends Stack {
 }
 ```
 
-The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#react-website#auth` generator</Link>, or you can create your own CDK `UserPool` and `UserPoolClient`.
+The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>, or you can create your own CDK `UserPool` and `UserPoolClient`.
 </Fragment>
 <Fragment slot="terraform">
 The generated module accepts `user_pool_id` and `user_pool_client_ids` variables for Cognito authentication:

package/docs/snippets/api/cors-configuration-cdk-note.mdx

@@ -21,5 +21,5 @@ export class ExampleStack extends Stack {
 }
 ```
 
-The `MyWebsite` construct can be generated using the <Link path="/guides/react-website">`ts#react-website` generator</Link>
+The `MyWebsite` construct can be generated using the <Link path="/guides/react-website">`ts#website` generator</Link>
 :::

package/docs/snippets/api/cors-configuration-terraform-note.mdx

@@ -24,5 +24,5 @@ module "my_api" {
   }
 }
 ```
-The `MyWebsite` construct can be generated using the <Link path="/guides/react-website">`ts#react-website` generator</Link>
+The `MyWebsite` construct can be generated using the <Link path="/guides/react-website">`ts#website` generator</Link>
 :::

package/docs/snippets/mcp/bedrock-deployment.mdx

@@ -139,7 +139,7 @@ export class ExampleStack extends Stack {
 }
 ```
 
-The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#react-website#auth` generator</Link>, or you can create your own CDK `UserPool` and `UserPoolClient`.
+The `UserIdentity` construct can be generated using the <Link path="/guides/react-website-auth">`ts#website#auth` generator</Link>, or you can create your own CDK `UserPool` and `UserPoolClient`.
 </Fragment>
 <Fragment slot="terraform">
 The generated module accepts `user_pool_id` and `user_pool_client_ids` variables for Cognito authentication:

package/generators.json

@@ -67,12 +67,20 @@
       "metric": "g20",
       "hidden": true
     },
+    "py#api": {
+      "factory": "./src/py/api/generator",
+      "schema": "./src/py/api/schema.json",
+      "description": "Create a Python API",
+      "metric": "g45",
+      "guidePages": ["py-api", "fastapi"]
+    },
     "py#fast-api": {
       "factory": "./src/py/fast-api/generator",
       "schema": "./src/py/fast-api/schema.json",
       "description": "Generates a FastAPI Python project",
       "metric": "g3",
-      "guidePages": ["fastapi"]
+      "guidePages": ["fastapi"],
+      "hidden": true
     },
     "py#fast-api#react-connection": {
       "factory": "./src/py/fast-api/react/generator",
@@ -142,12 +150,20 @@
       "metric": "g23",
       "guidePages": ["terraform-project"]
     },
+    "ts#docs": {
+      "factory": "./src/ts/docs/generator",
+      "schema": "./src/ts/docs/schema.json",
+      "description": "Generates a documentation site",
+      "metric": "g43",
+      "guidePages": ["docs", "astro-docs"]
+    },
     "ts#astro-docs": {
       "factory": "./src/ts/astro-docs/generator",
       "schema": "./src/ts/astro-docs/schema.json",
       "description": "Generates an Astro + Starlight documentation site with localisation, snippets, blog, and optional automated documentation translation",
       "metric": "g37",
-      "guidePages": ["astro-docs"]
+      "guidePages": ["astro-docs"],
+      "hidden": true
     },
     "ts#infra": {
       "factory": "./src/infra/app/generator",
@@ -188,19 +204,35 @@
       "metric": "g1",
       "guidePages": ["typescript-project"]
     },
+    "ts#website": {
+      "factory": "./src/ts/website/app/generator",
+      "schema": "./src/ts/website/app/schema.json",
+      "description": "Generates a website application",
+      "metric": "g43",
+      "guidePages": ["website", "react-website"]
+    },
+    "ts#website#auth": {
+      "factory": "./src/ts/website/auth/generator",
+      "schema": "./src/ts/website/auth/schema.json",
+      "description": "Adds auth to an existing website",
+      "metric": "g44",
+      "guidePages": ["react-website-auth"]
+    },
     "ts#react-website": {
       "factory": "./src/ts/react-website/app/generator",
       "schema": "./src/ts/react-website/app/schema.json",
       "description": "Generates a React static website",
       "metric": "g5",
-      "guidePages": ["react-website"]
+      "guidePages": ["react-website"],
+      "hidden": true
     },
     "ts#react-website#auth": {
       "factory": "./src/ts/react-website/cognito-auth/generator",
       "schema": "./src/ts/react-website/cognito-auth/schema.json",
       "description": "Adds auth to an existing React website",
       "metric": "g6",
-      "guidePages": ["react-website-auth"]
+      "guidePages": ["react-website-auth"],
+      "hidden": true
     },
     "ts#react-website#runtime-config": {
       "factory": "./src/ts/react-website/runtime-config/generator",
@@ -213,7 +245,8 @@
       "factory": "./src/smithy/ts/api/generator",
       "schema": "./src/smithy/ts/api/schema.json",
       "description": "Create an API using Smithy and the Smithy TypeScript Server SDK",
-      "metric": "g26"
+      "metric": "g26",
+      "hidden": true
     },
     "ts#agent": {
       "factory": "./src/ts/agent/generator",
@@ -256,12 +289,20 @@
       "metric": "g29",
       "hidden": true
     },
+    "ts#api": {
+      "factory": "./src/ts/api/generator",
+      "schema": "./src/ts/api/schema.json",
+      "description": "Create a TypeScript API",
+      "metric": "g46",
+      "guidePages": ["ts-api", "trpc", "ts-smithy-api"]
+    },
     "ts#trpc-api": {
       "factory": "./src/trpc/backend/generator",
       "schema": "./src/trpc/backend/schema.json",
       "description": "creates a trpc backend",
       "metric": "g9",
-      "guidePages": ["trpc"]
+      "guidePages": ["trpc"],
+      "hidden": true
     },
     "ts#trpc-api#react-connection": {
       "factory": "./src/trpc/react/generator",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws/nx-plugin-mcp",
-  "version": "0.121.0",
+  "version": "1.0.0-rc.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/awslabs/nx-plugin-for-aws.git",

package/src/py/api/schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "py#api",
+  "title": "py#api",
+  "description": "Create a Python API",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Name of the API project to generate",
+      "x-priority": "important",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like your API to have? i.e: MyApi"
+    },
+    "framework": {
+      "type": "string",
+      "description": "The API framework to use.",
+      "default": "fastapi",
+      "enum": ["fastapi"],
+      "x-prompt": {
+        "message": "Which API framework would you like to use?",
+        "type": "list",
+        "items": [
+          {
+            "value": "fastapi",
+            "label": "FastAPI (modern Python web framework)"
+          }
+        ],
+        "default": "fastapi"
+      },
+      "x-priority": "important"
+    },
+    "computeType": {
+      "type": "string",
+      "description": "The type of compute to use to deploy this API. Choose between ServerlessApiGatewayRestApi (default) or ServerlessApiGatewayHttpApi.",
+      "default": "ServerlessApiGatewayRestApi",
+      "enum": ["ServerlessApiGatewayRestApi", "ServerlessApiGatewayHttpApi"],
+      "x-prompt": "What compute type would you like to deploy your API with?",
+      "x-priority": "important"
+    },
+    "integrationPattern": {
+      "type": "string",
+      "description": "How API Gateway integrations are generated for the API. Choose between isolated (default) and shared.",
+      "default": "isolated",
+      "enum": ["isolated", "shared"],
+      "x-priority": "important",
+      "x-prompt": {
+        "message": "How would you like to map integrations to your API operations?",
+        "type": "list",
+        "items": [
+          {
+            "value": "isolated",
+            "label": "isolated (one integration per operation)"
+          },
+          {
+            "value": "shared",
+            "label": "shared (single default integration with optional overrides)"
+          }
+        ],
+        "default": "isolated"
+      }
+    },
+    "auth": {
+      "type": "string",
+      "description": "The method used to authenticate with your API. Choose between IAM (default), Cognito or Custom.",
+      "default": "IAM",
+      "enum": ["IAM", "Cognito", "Custom"],
+      "x-prompt": "How would you like users to authenticate with your API?",
+      "x-priority": "important"
+    },
+    "directory": {
+      "type": "string",
+      "description": "The directory to store the application in.",
+      "default": "packages",
+      "x-prompt": "Which directory do you want to create the project in?",
+      "x-priority": "important"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. By default this is the project name.",
+      "x-prompt": "Which sub directory do you want to create the project in? (By default this is the project name)"
+    },
+    "iacProvider": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["Inherit", "CDK", "Terraform"],
+      "x-priority": "important",
+      "default": "Inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: Inherit)"
+    },
+    "moduleName": {
+      "type": "string",
+      "description": "Python module name"
+    }
+  },
+  "required": ["name"]
+}

package/src/ts/api/schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "ts#api",
+  "title": "ts#api",
+  "description": "Create a TypeScript API",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the API (required). Used to generate class names and file paths.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like your API to have? i.e: MyApi"
+    },
+    "framework": {
+      "type": "string",
+      "description": "The API framework to use.",
+      "default": "trpc",
+      "enum": ["trpc", "smithy"],
+      "x-prompt": {
+        "message": "Which API framework would you like to use?",
+        "type": "list",
+        "items": [
+          {
+            "value": "trpc",
+            "label": "tRPC (end-to-end type-safe APIs with TypeScript)"
+          },
+          {
+            "value": "smithy",
+            "label": "Smithy (model-driven API development)"
+          }
+        ],
+        "default": "trpc"
+      },
+      "x-priority": "important"
+    },
+    "namespace": {
+      "type": "string",
+      "description": "The namespace for the Smithy API (only applicable for the smithy framework). Defaults to your monorepo scope",
+      "x-prompt": "What namespace would you like your API to have? i.e: com.example"
+    },
+    "computeType": {
+      "type": "string",
+      "description": "The type of compute to use to deploy this API.",
+      "default": "ServerlessApiGatewayRestApi",
+      "enum": ["ServerlessApiGatewayRestApi", "ServerlessApiGatewayHttpApi"],
+      "x-prompt": "What compute type would you like to deploy your API with?",
+      "x-priority": "important"
+    },
+    "integrationPattern": {
+      "type": "string",
+      "description": "How API Gateway integrations are generated for the API. Choose between isolated (default) and shared.",
+      "default": "isolated",
+      "enum": ["isolated", "shared"],
+      "x-priority": "important",
+      "x-prompt": {
+        "message": "How would you like to map integrations to your API operations?",
+        "type": "list",
+        "items": [
+          {
+            "value": "isolated",
+            "label": "isolated (one integration per operation)"
+          },
+          {
+            "value": "shared",
+            "label": "shared (single default integration with optional overrides)"
+          }
+        ],
+        "default": "isolated"
+      }
+    },
+    "auth": {
+      "type": "string",
+      "description": "The method used to authenticate with your API. Choose between IAM (default), Cognito or Custom.",
+      "default": "IAM",
+      "enum": ["IAM", "Cognito", "Custom"],
+      "x-prompt": "How would you like users to authenticate with your API?",
+      "x-priority": "important"
+    },
+    "directory": {
+      "description": "The directory to store the application in.",
+      "type": "string",
+      "alias": "dir",
+      "x-priority": "important",
+      "default": "packages",
+      "x-prompt": "What directory would you like to store your application in?"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. By default this is the project name.",
+      "x-prompt": "Which sub directory do you want to create the project in? (By default this is the project name)"
+    },
+    "iacProvider": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["Inherit", "CDK", "Terraform"],
+      "x-priority": "important",
+      "default": "Inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: Inherit)"
+    }
+  },
+  "required": ["name"]
+}

package/src/ts/docs/schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "ts#docs",
+  "title": "Create a documentation site",
+  "description": "Generates a documentation site. Use the `framework` option to select the underlying docs framework.",
+  "examples": [
+    {
+      "command": "nx g ts#docs",
+      "description": "Generate a docs site using Astro (default framework)"
+    },
+    {
+      "command": "nx g ts#docs --framework=astro --noTranslation",
+      "description": "Generate an Astro docs site without the automated translation pipeline"
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "The name of the docs project.",
+      "type": "string",
+      "default": "docs",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the docs project?",
+      "pattern": "^[a-zA-Z][^:]*$"
+    },
+    "directory": {
+      "description": "The parent directory the docs project is placed in.",
+      "type": "string",
+      "alias": "dir",
+      "x-priority": "important",
+      "default": ".",
+      "x-prompt": "Which parent directory would you like to place the docs project in?"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the docs project is placed in. Defaults to the kebab-case project name.",
+      "x-prompt": "Which sub directory should the docs project be created in? (default: kebab-case of the name)"
+    },
+    "framework": {
+      "description": "The documentation framework to use.",
+      "type": "string",
+      "enum": ["astro"],
+      "default": "astro",
+      "x-priority": "important",
+      "x-prompt": "Which documentation framework would you like to use?"
+    },
+    "noTranslation": {
+      "description": "Opt out of the automated documentation translation pipeline (Strands Agent on Amazon Bedrock + a `translate` project target).",
+      "type": "boolean",
+      "default": false,
+      "x-prompt": "Would you like to opt out of automated documentation translation?"
+    },
+    "noBlog": {
+      "description": "Opt out of the `starlight-blog` plugin and the sample blog post.",
+      "type": "boolean",
+      "default": false,
+      "x-prompt": "Would you like to opt out of the blog?"
+    },
+    "skipInstall": {
+      "description": "Skip installing dependencies after the generator runs.",
+      "type": "boolean",
+      "default": false
+    }
+  },
+  "required": ["name"]
+}

package/src/ts/website/app/schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "Website",
+  "title": "Create a Website",
+  "description": "Create a website application for Nx.",
+  "examples": [
+    {
+      "command": "nx g app myapp --directory=myorg",
+      "description": "Generate `apps/myorg/myapp` and `apps/myorg/myapp-e2e`"
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "name": {
+      "description": "The name of the application.",
+      "type": "string",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the application?",
+      "pattern": "^[a-zA-Z][^:]*$"
+    },
+    "framework": {
+      "type": "string",
+      "description": "The frontend framework to use.",
+      "enum": ["react"],
+      "default": "react",
+      "x-priority": "important",
+      "x-prompt": "Which frontend framework would you like to use?"
+    },
+    "directory": {
+      "description": "The directory of the new application.",
+      "type": "string",
+      "alias": "dir",
+      "x-priority": "important",
+      "default": "packages",
+      "x-prompt": "What directory would you like to store your application in?"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. By default this is the project name.",
+      "x-prompt": "Which sub directory do you want to create the project in? (By default this is the project name)"
+    },
+    "uxProvider": {
+      "type": "string",
+      "description": "The preferred UX provider.",
+      "enum": ["None", "Cloudscape", "Shadcn"],
+      "x-priority": "important",
+      "default": "Cloudscape",
+      "x-prompt": {
+        "message": "Which UX provider should we scaffold for this app?",
+        "type": "list",
+        "items": [
+          {
+            "value": "None",
+            "label": "None (plain React/Vite without a UI kit)"
+          },
+          {
+            "value": "Cloudscape",
+            "label": "Cloudscape (AWS-first components with ready-made layouts)"
+          },
+          {
+            "value": "Shadcn",
+            "label": "Shadcn (shared UI library under packages/common/shadcn)"
+          }
+        ],
+        "default": "Cloudscape"
+      }
+    },
+    "enableTailwind": {
+      "description": "Enable TailwindCSS for utility-first styling.",
+      "type": "boolean",
+      "default": true,
+      "x-priority": "important",
+      "x-prompt": "Would you like to enable TailwindCSS for additional styling capabilities?"
+    },
+    "enableTanstackRouter": {
+      "description": "Enable Tanstack router for type-safe routing.",
+      "type": "boolean",
+      "default": true,
+      "x-priority": "important",
+      "x-prompt": "Would you like to enable Tanstack Router for type-safe routing?"
+    },
+    "iacProvider": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["Inherit", "CDK", "Terraform"],
+      "x-priority": "important",
+      "default": "Inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: Inherit)"
+    }
+  },
+  "required": ["name"],
+  "examplesFile": "../../../docs/application-examples.md"
+}

package/src/ts/website/auth/schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "cli": "nx",
+  "$id": "Website Auth",
+  "title": "Website Auth",
+  "description": "Adds auth to an existing website.",
+  "examples": [
+    {
+      "command": "nx g @aws/nx-plugin:ts#website#auth --project=my-website",
+      "description": "Add Cognito auth to an existing website"
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "project": {
+      "description": "The root directory of the website.",
+      "type": "string",
+      "alias": "dir",
+      "x-priority": "important",
+      "x-prompt": "the root directory for your website.",
+      "x-dropdown": "projects"
+    },
+    "cognitoDomain": {
+      "description": "The cognito domain prefix to use. If omitted, a value is derived from the npm scope and website project name.",
+      "type": "string",
+      "x-priority": "important",
+      "x-prompt": "the cognito domain prefix to use i.e: https://{{cognitoDomain}}-123456789.auth.ap-southeast-2.amazoncognito.com (leave blank to derive from scope and project name)"
+    },
+    "allowSignup": {
+      "description": "Whether to allow self-signup",
+      "type": "boolean",
+      "default": false,
+      "x-prompt": "Enable self signup?",
+      "x-priority": "important"
+    },
+    "iacProvider": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["Inherit", "CDK", "Terraform"],
+      "x-priority": "important",
+      "default": "Inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: Inherit)"
+    }
+  },
+  "required": ["project"]
+}