fix(node): node application generator sets up docker correctly

Documentation instructs users to run `npx nx init` and `npx nx connect`,
which may use cached outdated versions of
Nx.

## Expected Behavior

Documentation now uses `npx nx@latest` to ensure users always get the
latest version, preventing issues from outdated
cached versions.

Updated 27 command occurrences across 23 documentation files:
- `npx nx init` → `npx nx@latest init`
- `npx nx connect` → `npx nx@latest connect`
- `npx nx connect-to-nx-cloud` → `npx nx@latest connect-to-nx-cloud`

## Related Issue(s)

Fixes #

.cargo/config.toml

@@ -1,5 +1,5 @@
 [build]
-target-dir = 'build/target'
+target-dir = 'dist/target'
 
 [target.x86_64-unknown-linux-musl]
 rustflags = [

.claude/commands/commit.md

@@ -0,0 +1,47 @@
+# Commit Command
+
+## Description
+
+Create a git commit following Nx repository standards and validation requirements.
+
+## Usage
+
+```bash
+/commit [message]
+```
+
+## What this command does:
+
+1. **Pre-commit validation**: Runs the full validation suite (`pnpm nx prepush`) to ensure code quality
+2. **Formatting**: Automatically formats changed files with Prettier
+3. **Testing**: Runs tests on affected projects to validate changes
+4. **Commit creation**: Creates a well-formed commit with proper message formatting (without co-author attribution)
+5. **Status reporting**: Provides clear feedback on the commit process
+
+## Workflow:
+
+1. Format any modified files with Prettier
+2. Run the prepush validation suite
+3. If validation passes, stage relevant changes
+4. Create commit with descriptive message
+5. Provide summary of what was committed
+
+## Commit Message Format:
+
+- Use conventional commit format when appropriate
+- Include scope (e.g., `feat(core):`, `fix(angular):`, `docs(nx):`)
+- Keep first line under 72 characters
+- Include detailed description if needed
+
+## Examples:
+
+- `/commit "feat(core): add new project graph visualization"`
+- `/commit "fix(react): resolve build issues with webpack config"`
+- `/commit "docs(nx): update getting started guide"`
+
+## Validation Requirements:
+
+- All tests must pass
+- Code must be properly formatted
+- No linting errors
+- E2E tests for affected areas should pass

.claude/commands/gh-issue-plan.md

@@ -0,0 +1,155 @@
+# GitHub Issue Planning and Resolution
+
+This command provides guidance for both automated and manual GitHub issue workflows.
+
+## Automated Workflow (GitHub Actions)
+
+The automated workflow consists of two phases:
+
+### Phase 1: Planning (`@claude plan` or `claude:plan` label)
+
+- Claude analyzes the issue and creates a detailed implementation plan
+- Plan is posted as a comment on the issue
+- Issue is labeled with `claude:planned`
+
+### Phase 2: Implementation (`@claude implement` or `claude:implement` label)
+
+- Claude implements the solution based on the plan
+- Runs validation tests and creates a feature branch
+- Suggests opening a PR with proper formatting
+
+## Planning Phase Template
+
+When creating a plan (either automated or manual), include these sections:
+
+### Problem Analysis
+
+- Root cause identification
+- Impact assessment
+- Related components or systems affected
+
+### Proposed Solution
+
+- High-level approach
+- Alternative solutions considered
+- Trade-offs and rationale
+
+### Implementation Details
+
+- Files that need to be modified
+- Key changes required
+- Dependencies or prerequisites
+
+### Testing Strategy
+
+- Unit tests to add/modify
+- Integration tests needed
+- E2E test considerations
+
+### Validation Steps
+
+```bash
+# Test specific affected projects
+nx run-many -t test,build,lint -p PROJECT_NAME
+
+# Test all affected projects
+nx affected -t build,test,lint
+
+# Run affected e2e tests
+nx affected -t e2e-local
+
+# Format code
+npx nx prettier -- FILES
+
+# Final validation
+pnpm nx prepush
+```
+
+### Risks and Considerations
+
+- Breaking changes
+- Performance implications
+- Migration requirements
+
+## Manual Workflow
+
+When working on a GitHub issue manually, follow this systematic approach:
+
+## 1. Get Issue Details
+
+```bash
+# Get issue details using GitHub CLI (replace ISSUE_NUMBER with actual number)
+gh issue view ISSUE_NUMBER
+```
+
+When cloning reproduction repos, please clone within `./tmp/claude/repro-ISSUE_NUMBER`
+
+## 2. Analyze the Plan
+
+- Look for a plan or implementation details in the issue description
+- Check comments for additional context or clarification
+- Identify affected projects and components
+
+## 3. Implement the Solution
+
+- Follow the plan outlined in the issue
+- Make focused changes that address the specific problem
+- Ensure code follows existing patterns and conventions
+
+## 4. Run Full Validation
+
+```bash
+# Test specific affected projects first
+nx run-many -t test,build,lint -p PROJECT_NAME
+
+# Test all affected projects
+nx affected -t build,test,lint
+
+# Run affected e2e tests
+nx affected -t e2e-local
+
+# Final pre-push validation
+pnpm nx prepush
+```
+
+## 5. Submit Pull Request
+
+- Create a descriptive PR title that references the issue
+- Include "Fixes #ISSUE_NUMBER" in the PR description
+- Provide a clear summary of changes made
+- Request appropriate reviewers
+
+## Pull Request Template
+
+When creating a pull request, follow the template found in `.github/PULL_REQUEST_TEMPLATE.md`. The template includes:
+
+### Required Sections
+
+1. **Current Behavior**: Describe the behavior we have today
+2. **Expected Behavior**: Describe the behavior we should expect with the changes in this PR
+3. **Related Issue(s)**: Link the issue being fixed so it gets closed when the PR is merged
+
+### Template Format
+
+```markdown
+## Current Behavior
+
+<!-- This is the behavior we have today -->
+
+## Expected Behavior
+
+<!-- This is the behavior we should expect with the changes in this PR -->
+
+## Related Issue(s)
+
+<!-- Please link the issue being fixed so it gets closed when this is merged. -->
+
+Fixes #ISSUE_NUMBER
+```
+
+### Guidelines
+
+- Ensure your commit message follows the conventional commit format (use `pnpm commit`)
+- Read the submission guidelines in CONTRIBUTING.md before posting
+- For complex changes, you can request a dedicated Nx release by mentioning the Nx team
+- Always link the related issue using "Fixes #ISSUE_NUMBER" to automatically close it when merged

.claude/commands/issue-workflow-guide.md

@@ -0,0 +1,30 @@
+# Claude Issue Workflow Usage Guide
+
+## Quick Start
+
+## Expected Outputs
+
+### Planning Phase
+
+- Detailed analysis comment posted to issue
+- Implementation plan with steps and file changes
+- Testing strategy and validation steps
+- Risk assessment
+
+### Implementation Phase
+
+- Code changes made according to plan
+- Tests run and validated
+- Feature branch created: `fix/issue-{number}`
+- PR suggestion with proper title format
+
+## Manual Override
+
+If you need to work on an issue manually, use the `/gh-issue-plan` command for structured guidance following the same workflow patterns.
+
+## Troubleshooting
+
+- Ensure you're on the authorized users list
+- Check that the issue has sufficient detail for analysis
+- For implementation, ensure a plan comment exists from the planning phase
+- If workflows fail, check the Actions tab for detailed logs

.claude/settings.json

@@ -0,0 +1,34 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(find:*)",
+      "Bash(ls:*)",
+      "Bash(mkdir:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:www.typescriptlang.org)",
+      "Bash(git log:*)",
+      "Bash(gh issue list:*)",
+      "Bash(gh issue view:*)",
+      "Bash(npx prettier:*)",
+      "Bash(nx prepush:*)",
+      "Bash(pnpm commit:*)",
+      "Bash(rg:*)",
+      "mcp__nx__nx_docs",
+      "mcp__nx__nx_workspace",
+      "mcp__nx__nx_project_details",
+      "Bash(nx show projects:*)",
+      "Bash(nx run-many:*)",
+      "Bash(nx run:*)",
+      "Bash(nx affected:*)",
+      "Bash(nx lint:*)",
+      "Bash(nx test:*)",
+      "Bash(nx build:*)",
+      "Bash(nx documentation:*)"
+    ],
+    "deny": []
+  },
+  "enableAllProjectMcpServers": true,
+  "env": {
+    "BASH_MAX_TIMEOUT_MS": "1800000"
+  }
+}

.cursor/mcp.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "nx-mcp": {
+      "url": "http://localhost:9470/mcp"
+    }
+  }
+}

.gitattributes

@@ -7,3 +7,5 @@
 # These are Windows script files and should use crlf
 *.bat           text eol=crlf
 
+# Exclude files from Graphite reviews
+docs/generated/* linguist-generated=true

.github/workflows/ci.yml

@@ -4,12 +4,14 @@ on:
   push:
     branches:
       - master
+      - '[0-9]+.[0-9]+.x'
   pull_request:
     branches:
       - "**"
 
 env:
   NX_CLOUD_ACCESS_TOKEN: ${{ secrets.NX_CLOUD_ACCESS_TOKEN }}
+  PNPM_HOME: ~/.pnpm
 
 jobs:
   main-linux:
@@ -57,13 +59,26 @@ jobs:
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
-      - name: Install project dependencies
-        run: |
-          pnpm install --frozen-lockfile
-          pnpm playwright install --with-deps
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Cache Rust toolchain and cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
 
       - name: Install Rust
         uses: dtolnay/rust-toolchain@stable
@@ -74,6 +89,14 @@ jobs:
           distribution: temurin
           java-version: 17
 
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Install project dependencies
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm playwright install --with-deps
+
       - name: Check Documentation
         run: pnpm nx documentation
         timeout-minutes: 20
@@ -94,7 +117,7 @@ jobs:
           pnpm nx run-many -t check-imports check-commit check-lock-files check-codeowners --parallel=1 --no-dte &
           pids+=($!)
 
-          pnpm nx affected --targets=lint,test,build,e2e,e2e-ci,format-native &
+          pnpm nx affected --targets=lint,test,build,e2e,e2e-ci,format-native,lint-native &
           pids+=($!)
 
           for pid in "${pids[@]}"; do
@@ -143,10 +166,100 @@ jobs:
 
       - name: Configure Detox Environment, Install applesimutils
         run: |
-          HOMEBREW_NO_AUTO_UPDATE=1 brew tap wix/brew >/dev/null
-          HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null
-          xcrun simctl shutdown all && xcrun simctl erase all
-        timeout-minutes: 20
+          # Ensure Xcode command line tools are installed and configured
+          xcode-select --print-path || sudo xcode-select --reset
+          sudo xcode-select -s /Applications/Xcode.app
+          
+          # Install or update applesimutils with error handling
+          if ! brew list applesimutils &>/dev/null; then
+            echo "Installing applesimutils..."
+            HOMEBREW_NO_AUTO_UPDATE=1 brew tap wix/brew >/dev/null
+            HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null || {
+              echo "Failed to install applesimutils, retrying with update..."
+              brew update
+              HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils
+            }
+          else
+            echo "Updating applesimutils..."
+            HOMEBREW_NO_AUTO_UPDATE=1 brew upgrade applesimutils || true
+          fi
+          
+          # Verify applesimutils installation
+          applesimutils --version || (echo "applesimutils installation failed" && exit 1)
+          
+          # Configure environment for M-series Mac
+          echo "DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer" >> $GITHUB_ENV
+          echo "PLATFORM_NAME=iOS Simulator" >> $GITHUB_ENV
+          
+          # Set additional environment variables for better debugging
+          echo "DETOX_DISABLE_TELEMETRY=1" >> $GITHUB_ENV
+          echo "DETOX_LOG_LEVEL=trace" >> $GITHUB_ENV
+          
+          # Verify Xcode installation
+          xcodebuild -version
+          
+          # List available simulators
+          xcrun simctl list devices available
+        timeout-minutes: 10
+        continue-on-error: false
+  
+      - name: Reset iOS Simulators
+        id: reset-simulators
+        run: |
+          echo "Resetting iOS Simulators..."
+          
+          # Kill simulator processes
+          sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+          killall "Simulator" 2>/dev/null || true
+          killall "iOS Simulator" 2>/dev/null || true
+          
+          # Wait for processes to terminate
+          sleep 3
+          
+          # Shutdown and erase all simulators (ignore failures)
+          xcrun simctl shutdown all 2>/dev/null || true
+          sleep 5
+          xcrun simctl erase all 2>/dev/null || true
+          
+          # If erase failed, try the nuclear option
+          if xcrun simctl list devices | grep -q "Booted" 2>/dev/null; then
+            echo "Standard reset failed, using nuclear option..."
+            rm -rf ~/Library/Developer/CoreSimulator/Devices/* 2>/dev/null || true
+            launchctl remove com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+            sleep 3
+          fi
+          
+          # Clean up additional directories
+          rm -rf ~/Library/Developer/CoreSimulator/Caches/* 2>/dev/null || true
+          rm -rf ~/Library/Logs/CoreSimulator/* 2>/dev/null || true
+          rm -rf ~/Library/Developer/Xcode/DerivedData/* 2>/dev/null || true
+          
+          echo "Simulator reset completed"
+        timeout-minutes: 5
+        continue-on-error: true
+
+      - name: Verify Simulator Reset
+        if: ${{ steps.reset-simulators.outcome == 'success' }}
+        run: |
+          # Verify CoreSimulator service restarted
+          pgrep -fl "CoreSimulator" || (echo "CoreSimulator service not running" && exit 1)
+          
+          # Check simulator list is clean
+          xcrun simctl list devices
+          
+          # Verify simulator runtime paths exist and are writable
+          test -d ~/Library/Developer/CoreSimulator/Devices || (echo "Simulator devices directory missing" && exit 1)
+          touch ~/Library/Developer/CoreSimulator/Devices/test || (echo "Simulator devices directory not writable" && exit 1)
+          rm ~/Library/Developer/CoreSimulator/Devices/test
+        timeout-minutes: 5
+
+      - name: Diagnose Simulator Reset Failure
+        if: ${{ steps.reset-simulators.outcome == 'failure' }}
+        run: |
+          echo "Simulator reset failed. Collecting diagnostic information..."
+          xcrun simctl list
+          echo "Checking simulator logs..."
+          ls -la ~/Library/Logs/CoreSimulator/ || echo "No simulator logs found"
 
       - name: Save Homebrew Cache
         uses: actions/cache@v4
@@ -159,17 +272,35 @@ jobs:
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Cache Rust toolchain and cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
       - name: Install project dependencies
         run: |
           pnpm install --frozen-lockfile
           pnpm playwright install --with-deps
 
-      - name: Install Rust
-        uses: dtolnay/rust-toolchain@stable
-
       - name: Set SHAs
         uses: nrwl/nx-set-shas@v4
         with:

.github/workflows/claude.yml

@@ -0,0 +1,93 @@
+name: Claude Code
+
+env:
+  PNPM_HOME: ~/.pnpm
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      contains(fromJson('["AgentEnder", "barbados-clemens", "Cammisuli", "Coly010", "FrozenPandaz", "isaacplmann", "JamesHenry", "jaysoo", "leosvelperez", "mandarini", "MaxKless", "meeroslav", "nartc", "ndcunningham", "philipjfulcher", "vsavkin", "xiongemi"]'), github.actor) &&
+      ((github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+       (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+       (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+       (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude'))))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
+      actions: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 250
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ca-certificates lsof libvips-dev libglib2.0-dev libgirepository1.0-dev
+
+      - name: Install Chrome
+        uses: browser-actions/setup-chrome@v1
+
+      - uses: pnpm/action-setup@v4
+        name: Install pnpm
+        with:
+          version: 10.11.1
+          run_install: false
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - name: Cache cargo
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            .cargo-cache
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Setup Java
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 17
+
+      - name: Setup Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Install project dependencies
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm playwright install --with-deps
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@beta
+        timeout-minutes: 90
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          allowed_tools: "Bash,Edit,Read,Write,Glob,Grep,LS,MultiEdit,NotebookRead,NotebookEdit"
+

.github/workflows/e2e-matrix.yml

@@ -19,12 +19,14 @@ jobs:
   preinstall:
     if: ${{ github.repository_owner == 'nrwl' }}
     runs-on: ${{ matrix.os }}
+    timeout-minutes: 20
     strategy:
       matrix:
         os:
           - ubuntu-latest
           - macos-latest
-          - windows-latest
+          # - windows-latest Windows fails to build gradle wrapper which always runs when we build nx.
+          ## https://staging.nx.app/runs/LgD4vxGn8w?utm_source=pull-request&utm_medium=comment
         node_version:
           - 20
           - 22
@@ -35,9 +37,9 @@ jobs:
             node_version: 22
           # - os: macos-latest
           #   node_version: 23
-          - os: windows-latest
-            node_version: 22
-          # - os: windows-latest
+          # - os: windows-latest TODO (emily): Windows fails to build gradle wrapper which always runs when we build nx. Re-enable when we fix this.
+            # node_version: 22
+          # - os: windows-latest TODO (emily): Windows fails to build gradle wrapper which always runs when we build nx. Re-enable when we fix this.
           #   node_version: 23
 
     name: Cache install (${{ matrix.os }}, node v${{ matrix.node_version }})
@@ -45,12 +47,13 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
         with:
-          fetch-depth: 1
+          fetch-depth: 0
+          filter: tree:0
 
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
       - name: Set node
@@ -59,13 +62,17 @@ jobs:
           node-version: ${{ matrix.node_version }}
           cache: 'pnpm'
 
-      - name: Cache node_modules
-        id: cache-modules
+      - name: Get pnpm store directory
+        id: pnpm-cache
+        run: echo "path=$(pnpm store path)" >> $GITHUB_OUTPUT
+
+      - name: Cache pnpm store
         uses: actions/cache@v4
         with:
-          lookup-only: true
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ matrix.node_version }}-${{ hashFiles('pnpm-lock.yaml') }}
+          path: ${{ steps.pnpm-cache.outputs.path }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
 
       - name: Ensure Python setuptools Installed on Macos
         if: ${{ matrix.os == 'macos-latest' }}
@@ -73,7 +80,6 @@ jobs:
         run: brew install python-setuptools
 
       - name: Install packages
-        if: steps.cache-modules.outputs.cache-hit != 'true'
         run: pnpm install --frozen-lockfile
 
       - name: Homebrew cache directory path
@@ -106,6 +112,7 @@ jobs:
   prepare-matrix:
     name: Prepare matrix combinations
     if: ${{ github.repository_owner == 'nrwl' }}
+    timeout-minutes: 5
     runs-on: ubuntu-latest
     outputs:
       matrix: ${{ steps.process-json.outputs.MATRIX }}
@@ -113,7 +120,8 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
         with:
-          fetch-depth: 1
+          fetch-depth: 0
+          filter: tree:0
 
       - name: Process matrix data
         id: process-json
@@ -128,6 +136,7 @@ jobs:
     permissions:
       contents: read
     runs-on: ${{ matrix.os }}
+    timeout-minutes: 200     # <- cap each job to 200 minutes
     strategy:
       matrix: ${{fromJson(needs.prepare-matrix.outputs.matrix)}} # Load matrix from previous job
       fail-fast: false
@@ -137,7 +146,8 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
         with:
-          fetch-depth: 1
+          fetch-depth: 0
+          filter: tree:0
 
       - name: Prepare dir for output
         run: mkdir -p outputs
@@ -145,7 +155,7 @@ jobs:
       - uses: pnpm/action-setup@v4
         name: Install pnpm
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
       - name: Use Node.js ${{ matrix.node_version }}
@@ -154,12 +164,22 @@ jobs:
           node-version: ${{ matrix.node_version }}
           cache: 'pnpm'
 
-      - name: Cache node_modules
-        id: cache-modules
-        uses: actions/cache@v4
+      - name: Install Rust
+        if: ${{ matrix.os != 'windows-latest' }}
+        run: |
+          curl --proto '=https' --tlsv1.3 https://sh.rustup.rs -sSf | sh -s -- -y
+          source "$HOME/.cargo/env"
+          rustup toolchain install 1.70.0
+
+      - name: Load Cargo Env
+        if: ${{ matrix.os != 'windows-latest' }}
+        run: echo "PATH=$HOME/.cargo/bin:$PATH" >> $GITHUB_ENV
+  
+      - name: Install bun
+        if: ${{ matrix.os != 'windows-latest' }}
+        uses: oven-sh/setup-bun@v1
         with:
-          path: '**/node_modules'
-          key: ${{ runner.os }}-modules-${{ matrix.node_version }}-${{ hashFiles('pnpm-lock.yaml') }}
+          bun-version: latest
 
       - name: Install packages
         run: pnpm install --frozen-lockfile
@@ -201,26 +221,116 @@ jobs:
         if: steps.cache-cypress.outputs.cache-hit != 'true'
         run: npx cypress install
 
-      - name: Install applesimutils, reset ios simulators
+      - name: Configure Detox Environment, Install applesimutils
         if: ${{ matrix.os == 'macos-latest' }}
         run: |
-          HOMEBREW_NO_AUTO_UPDATE=1 brew tap wix/brew >/dev/null
-          HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null
-          xcrun simctl shutdown all && xcrun simctl erase all
+          # Ensure Xcode command line tools are installed and configured
+          xcode-select --print-path || sudo xcode-select --reset
+          sudo xcode-select -s /Applications/Xcode.app
+          
+          # Install or update applesimutils with error handling
+          if ! brew list applesimutils &>/dev/null; then
+            echo "Installing applesimutils..."
+            HOMEBREW_NO_AUTO_UPDATE=1 brew tap wix/brew >/dev/null
+            HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils >/dev/null || {
+              echo "Failed to install applesimutils, retrying with update..."
+              brew update
+              HOMEBREW_NO_AUTO_UPDATE=1 brew install applesimutils
+            }
+          else
+            echo "Updating applesimutils..."
+            HOMEBREW_NO_AUTO_UPDATE=1 brew upgrade applesimutils || true
+          fi
+          
+          # Verify applesimutils installation
+          applesimutils --version || (echo "applesimutils installation failed" && exit 1)
+          
+          # Configure environment for M-series Mac
+          echo "DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer" >> $GITHUB_ENV
+          echo "PLATFORM_NAME=iOS Simulator" >> $GITHUB_ENV
+          
+          # Set additional environment variables for better debugging
+          echo "DETOX_DISABLE_TELEMETRY=1" >> $GITHUB_ENV
+          echo "DETOX_LOG_LEVEL=trace" >> $GITHUB_ENV
+          
+          # Verify Xcode installation
+          xcodebuild -version
+          
+        timeout-minutes: 10
+        continue-on-error: false
+
+      - name: Reset iOS Simulators
+        if: ${{ matrix.os == 'macos-latest' }}
+        id: reset-simulators
+        run: |
+          echo "Resetting iOS Simulators..."
+          
+          # Kill simulator processes
+          sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+          killall "Simulator" 2>/dev/null || true
+          killall "iOS Simulator" 2>/dev/null || true
+          
+          # Wait for processes to terminate
+          sleep 3
+          
+          # Shutdown and erase all simulators (ignore failures)
+          xcrun simctl shutdown all 2>/dev/null || true
+          sleep 5
+          xcrun simctl erase all 2>/dev/null || true
+          
+          # If erase failed, try the nuclear option
+          if xcrun simctl list devices | grep -q "Booted" 2>/dev/null; then
+            echo "Standard reset failed, using nuclear option..."
+            rm -rf ~/Library/Developer/CoreSimulator/Devices/* 2>/dev/null || true
+            launchctl remove com.apple.CoreSimulator.CoreSimulatorService 2>/dev/null || true
+            sleep 3
+          fi
+          
+          # Clean up additional directories
+          rm -rf ~/Library/Developer/CoreSimulator/Caches/* 2>/dev/null || true
+          rm -rf ~/Library/Logs/CoreSimulator/* 2>/dev/null || true
+          rm -rf ~/Library/Developer/Xcode/DerivedData/* 2>/dev/null || true
+          
+          echo "Simulator reset completed"
+        timeout-minutes: 5
+        continue-on-error: true
+
+      - name: Verify Simulator Reset
+        if: ${{ matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success' }}
+        run: |
+          # Verify CoreSimulator service restarted
+          pgrep -fl "CoreSimulator" || (echo "CoreSimulator service not running" && exit 1)
+          
+          # Verify simulator runtime paths exist and are writable
+          test -d ~/Library/Developer/CoreSimulator/Devices || (echo "Simulator devices directory missing" && exit 1)
+          touch ~/Library/Developer/CoreSimulator/Devices/test || (echo "Simulator devices directory not writable" && exit 1)
+          rm ~/Library/Developer/CoreSimulator/Devices/test
+        timeout-minutes: 5
+
+      - name: Diagnose Simulator Reset Failure
+        if: ${{ matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'failure' }}
+        run: |
+          echo "Simulator reset failed. Collecting diagnostic information..."
+          xcrun simctl list
+          echo "Checking simulator logs..."
+          ls -la ~/Library/Logs/CoreSimulator/ || echo "No simulator logs found"
 
       - name: Configure git metadata (needed for lerna smoke tests)
+        if: ${{ (matrix.os != 'macos-latest') || (matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success') }}
         run: |
           git config --global user.email test@test.com
           git config --global user.name "Test Test"
 
       - name: Set starting timestamp
+        if: ${{ (matrix.os != 'macos-latest') || (matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success') }}
         id: before-e2e
         shell: bash
         run: |
           echo "timestamp=$(date +%s)" >> $GITHUB_OUTPUT
 
-      - name: Run e2e tests
-        id: e2e-run
+      - name: Run e2e tests with pnpm (Linux/Windows)
+        id: e2e-run-pnpm
+        if: ${{ matrix.os != 'macos-latest' }}
         run: pnpm nx run ${{ matrix.project }}:e2e-local
         shell: bash
         timeout-minutes: ${{ matrix.os_timeout }}
@@ -237,6 +347,33 @@ jobs:
           SELECTED_PM: ${{ matrix.package_manager }}
           npm_config_registry: http://localhost:4872
           YARN_REGISTRY: http://localhost:4872
+          CI: true
+  
+      - name: Run e2e tests with npm (macOS)
+        id: e2e-run-npm
+        if: ${{ matrix.os == 'macos-latest' && steps.reset-simulators.outcome == 'success' }}
+        run: |
+          # Run the tests
+          if [[ "${{ matrix.project }}" == "e2e-detox" ]] || [[ "${{ matrix.project }}" == "e2e-react-native" ]] || [[ "${{ matrix.project }}" == "e2e-expo" ]]; then
+            NX_E2E_VERBOSE_DEBUG=1 pnpm nx run ${{ matrix.project }}:e2e-macos-local
+          else
+            NX_E2E_VERBOSE_DEBUG=1 pnpm nx run ${{ matrix.project }}:e2e-local
+          fi
+        
+        env:
+          NX_E2E_CI_CACHE_KEY: e2e-gha-${{ matrix.os }}-${{ matrix.node_version }}-${{ matrix.package_manager }}
+          NX_PERF_LOGGING: 'false'
+          NX_CI_EXECUTION_ENV: 'macos'
+          NX_E2E_VERBOSE_LOGGING: 'true'
+          NX_NATIVE_LOGGING: 'false'
+          NX_E2E_RUN_E2E: 'true'
+          NX_E2E_SKIP_CLEANUP: 'true'
+          NODE_OPTIONS: --max_old_space_size=8192
+          SELECTED_PM: 'npm'
+          npm_config_registry: http://localhost:4872
+          YARN_REGISTRY: http://localhost:4872
+          DEVELOPER_DIR: '/Applications/Xcode.app/Contents/Developer'
+          CI: true
 
       - name: Save matrix config in file
         if: ${{ always() }}
@@ -246,9 +383,13 @@ jobs:
           before=${{ steps.before-e2e.outputs.timestamp }}
           now=$(date +%s)
           delta=$(($now - $before))
+          
+          # Determine the outcome based on which step ran
+          outcome="${{ matrix.os == 'macos-latest' && steps.e2e-run-npm.outcome || steps.e2e-run-pnpm.outcome }}"
+          
           matrix=$((
             echo '${{ toJSON(matrix) }}'
-          ) | jq --argjson delta $delta -c '. + { "status": "${{ steps.e2e-run.outcome}}", "duration": $delta }')
+          ) | jq --argjson delta $delta -c '. + { "status": "'"$outcome"'", "duration": $delta }')
           echo "$matrix" > 'outputs/matrix.json'
 
       - name: Upload matrix config
@@ -268,15 +409,23 @@ jobs:
           sudo: ${{ matrix.os != 'windows-latest' }} # disable sudo for windows debugging
 
   process-result:
-    if: ${{ always() && github.repository_owner == 'nrwl' }}
+    if: ${{ always() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
     runs-on: ubuntu-latest
     needs: e2e
+    timeout-minutes: 10
     outputs:
-      message: ${{ steps.process-json.outputs.SLACK_MESSAGE }}
-      proj-duration: ${{ steps.process-json.outputs.SLACK_PROJ_DURATION }}
-      pm-duration: ${{ steps.process-json.outputs.SLACK_PM_DURATION }}
-      codeowners: ${{ steps.process-json.outputs.CODEOWNERS }}
+      message: ${{ steps.process-json.outputs.slack_message }}
+      proj_duration: ${{ steps.process-json.outputs.slack_proj_duration }}
+      pm_duration: ${{ steps.process-json.outputs.slack_pm_duration }}
+      codeowners: ${{ steps.process-json.outputs.codeowners }}
+      has_golden_failures: ${{ steps.process-json.outputs.has_golden_failures }}
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          filter: tree:0
+
       - name: Prepare dir for output
         run: mkdir -p outputs
 
@@ -288,172 +437,45 @@ jobs:
       - name: Join and stringify matrix configs
         id: combine-json
         run: |
-          combined=$((jq -s . outputs/*/matrix.json) | jq tostring)
+          combined=$(jq -sc . outputs/*/matrix.json)
           echo "combined=$combined" >> $GITHUB_OUTPUT
 
-      - name: Make slack outputs
+      - name: Process results with TypeScript script
         id: process-json
-        uses: actions/github-script@v7
-        env:
-          GITHUB_TOKEN: ${{ github.token }}
-        with:
-          script: |
-            const combined = JSON.parse(${{ steps.combine-json.outputs.combined }});
-            const failedProjects = combined.filter(c => c.status === 'failure').sort((a, b) => a.project.localeCompare(b.project));
-
-            // codeowners
-            const codeowners = new Set();
-            failedProjects.forEach(c => {
-              codeowners.add(c.codeowners);
-            });
-            core.setOutput('CODEOWNERS', Array.from(codeowners).join(','));
-
-            function trimSpace(res) {
-              return res.split('\n').map((l) => l.trim()).join('\n');
-            }
-
-            // failed message
-            let lastProject;
-            let result = `
-              \`\`\`
-              | Failed project                 | PM   | OS    | Node |
-              |--------------------------------|------|-------|------|`;
-            failedProjects.forEach(matrix => {
-              const project = matrix.project !== lastProject ? matrix.project : '...';
-              result += `\n| ${project.padEnd(30)} | ${matrix.package_manager.padEnd(4)} | ${matrix.os_name} | v${matrix.node_version}  |`
-              lastProject = matrix.project;
-            });
-            result += `\`\`\``;
-            core.setOutput('SLACK_MESSAGE', trimSpace(result));
-            console.log(trimSpace(result));
-
-            function humanizeDuration(num) {
-              let res = '';
-              const hours = Math.floor(num / 3600);
-              if (hours) {
-                res += `${hours}h `;
-              }
-              const mins = Math.floor((num % 3600) / 60);
-              if (mins) {
-                res += `${mins}m `;
-              }
-              const sec = num % 60;
-              if (sec) {
-                res += `${sec}s`
-              }
-              return res;
-            }
-
-            // duration message
-            const timeReport = {};
-            const pmReport = {
-              npm: 0,
-              yarn: 0,
-              pnpm: 0
-            };
-            const macosProjects = ['e2e-detox', 'e2e-expo', 'e2e-react-native'];
-            combined.forEach((matrix) => {
-              if (matrix.os_name === 'Linux' && matrix.node_version === 20) {
-                pmReport[matrix.package_manager] += matrix.duration;
-              }
-              if (matrix.os_name === 'Linux' || macosProjects.includes(matrix.project)) {
-                if (timeReport[matrix.project]) {
-                  if (matrix.duration > timeReport[matrix.project].max) {
-                    timeReport[matrix.project].max = matrix.duration;
-                    timeReport[
-                      matrix.project
-                    ].maxEnv = `${matrix.os_name}, ${matrix.package_manager}`;
-                  }
-                  if (matrix.duration < timeReport[matrix.project].min) {
-                    timeReport[matrix.project].min = matrix.duration;
-                    timeReport[
-                      matrix.project
-                    ].minEnv = `${matrix.os_name}, ${matrix.package_manager}`;
-                  }
-                } else {
-                  timeReport[matrix.project] = {
-                    min: matrix.duration,
-                    max: matrix.duration,
-                    minEnv: `${matrix.os_name}, ${matrix.package_manager}`,
-                    maxEnv: `${matrix.os_name}, ${matrix.package_manager}`,
-                  };
-                }
-              }
-            });
-
-            // project time report
-            let resultPkg = `
-                \`\`\`
-                | Project                        | Time                      |
-                |--------------------------------|---------------------------|`;
-            function mapProjectTime(proj, section) {
-              let res = '';
-              res += `${humanizeDuration(timeReport[proj][section])}`;
-              res += ` (${timeReport[proj][section + 'Env']})`
-              return res;
-            }
-            function durationIcon(proj, section) {
-              if (timeReport[proj][section] < 12 * 60) {
-                return `${section} ✅`;
-              }
-              if (timeReport[proj][section] < 15 * 60) {
-                return `${section} ❗`;
-              }
-              return `${section} ❌`;
-            }
-            Object.keys(timeReport).forEach(proj => {
-              resultPkg += `\n| ${proj.padEnd(30)} |                           |`;
-              resultPkg += `\n| ${durationIcon(proj, 'min').padStart(29)} | ${mapProjectTime(proj, 'min').padEnd(25)} |`;
-              resultPkg += `\n| ${durationIcon(proj, 'max').padStart(29)} | ${mapProjectTime(proj, 'max').padEnd(25)} |`;
-            });
-            resultPkg += `\`\`\``;
-            core.setOutput('SLACK_PROJ_DURATION', trimSpace(resultPkg));
-
-            // Print project duration report inline to allow reviewing on manual runs (when no slack message will be sent)
-            console.log(trimSpace(resultPkg));
-
-            let resultPm = `
-                \`\`\`
-                | PM   | Total time  |
-                |------|-------------|`;
-            Object.keys(pmReport).forEach(pm => {
-              resultPm += `\n| ${pm.padEnd(4)} | ${humanizeDuration(pmReport[pm]).padEnd(11)} |`
-            });
-            resultPm += `\`\`\``;
-            core.setOutput('SLACK_PM_DURATION', trimSpace(resultPm));
-
-            // Print package manager duration report inline to allow reviewing on manual runs (when no slack message will be sent)
-            console.log(trimSpace(resultPm));
+        run: |
+          echo '${{ steps.combine-json.outputs.combined }}' | npx tsx .github/workflows/nightly/process-result.ts
 
   report-failure:
-    if: ${{ failure() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
+    if: ${{ always() && needs.process-result.outputs.has_golden_failures == 'true' && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
     needs: process-result
     runs-on: ubuntu-latest
     name: Report failure
+    timeout-minutes: 10
     steps:
       - name: Send notification
         uses: ravsamhq/notify-slack-action@v2
         with:
           status: 'failure'
-          message_format: '{emoji} Workflow has {status_message} ${{ needs.process-result.outputs.message }}'
-          notification_title: '{workflow}'
+          message_format: '${{ needs.process-result.outputs.message }}'
+          notification_title: 'Golden Test Failure'
           footer: '<{run_url}|View Run> / Last commit <{commit_url}|{commit_sha}>'
           mention_groups: ${{ needs.process-result.outputs.codeowners }}
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}
 
   report-success:
-    if: ${{ success() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
-    needs: e2e
+    if: ${{ always() && needs.process-result.outputs.has_golden_failures == 'false' && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
+    needs: process-result
     runs-on: ubuntu-latest
     name: Report status
+    timeout-minutes: 10
     steps:
       - name: Send notification
         uses: ravsamhq/notify-slack-action@v2
         with:
-          status: ${{ needs.e2e.result }}
-          message_format: '{emoji} Workflow has {status_message}'
-          notification_title: '{workflow}'
+          status: 'success'
+          message_format: '${{ needs.process-result.outputs.message }}'
+          notification_title: '✅ Golden Tests: All Passed!'
           footer: '<{run_url}|View Run> / Last commit <{commit_url}|{commit_sha}>'
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}
@@ -462,14 +484,15 @@ jobs:
     if: ${{ always() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
     needs: process-result
     runs-on: ubuntu-latest
+    timeout-minutes: 10
     name: Report duration per package manager
     steps:
       - name: Send notification
         uses: ravsamhq/notify-slack-action@v2
         with:
           status: 'skipped'
-          message_format: '${{ needs.process-result.outputs.pm-duration }}'
-          notification_title: 'Total duration per package manager (ubuntu only)'
+          message_format: '${{ needs.process-result.outputs.pm_duration }}'
+          notification_title: '⌛ Total duration per package manager (ubuntu only)'
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}
 
@@ -477,13 +500,14 @@ jobs:
     if: ${{ always() && github.repository_owner == 'nrwl' && github.event_name != 'workflow_dispatch' }}
     needs: process-result
     runs-on: ubuntu-latest
-    name: Report duration per package manager
+    timeout-minutes: 10
+    name: Report duration per project
     steps:
       - name: Send notification
         uses: ravsamhq/notify-slack-action@v2
         with:
           status: 'skipped'
-          message_format: '${{ needs.process-result.outputs.proj-duration }}'
-          notification_title: 'E2E Project duration stats'
+          message_format: '${{ needs.process-result.outputs.proj_duration }}'
+          notification_title: '⌛ E2E Project duration stats'
         env:
           SLACK_WEBHOOK_URL: ${{ secrets.ACTION_MONITORING_SLACK }}

.github/workflows/generate-embeddings.yml

@@ -25,7 +25,7 @@ jobs:
         uses: pnpm/action-setup@v4
         id: pnpm-install
         with:
-          version: 9.8.0
+          version: 10.11.1
           run_install: false
 
       - name: Get pnpm store directory

.github/workflows/issue-notifier.yml

@@ -20,7 +20,7 @@ jobs:
 
       - uses: pnpm/action-setup@v4
         with:
-          version: 9.8.0
+          version: 10.11.1
 
       - name: Use Node.js ${{ matrix.node_version }}
         uses: actions/setup-node@v3

.github/workflows/nightly/process-matrix.ts

@@ -1,6 +1,7 @@
 type MatrixDataProject = {
   name: string,
   codeowners: string,
+  is_golden?: boolean, // true if this is a golden project, false otherwise
 };
 
 type MatrixDataOS = {
@@ -19,58 +20,62 @@ type MatrixData = {
   setup: MatrixDataOS[],
 }
 
-// TODO: Extract Slack groups into named groups for easier maintenance
-const matrixData: MatrixData = {
-  coreProjects: [
-    { name: 'e2e-lerna-smoke-tests', codeowners: 'S04TNCVEETS' },
-    { name: 'e2e-js', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-nx-init', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-nx', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-release', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-workspace-create', codeowners: 'S04SYHYKGNP' }
-  ],
-  projects: [
-    { name: 'e2e-angular', codeowners: 'S04SS457V38' },
-    { name: 'e2e-cypress', codeowners: 'S04T16BTJJY' },
-    { name: 'e2e-detox', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-esbuild', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-expo', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-gradle', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-jest', codeowners: 'S04T16BTJJY' },
-    { name: 'e2e-eslint', codeowners: 'S04SYJGKSCT' },
-    { name: 'e2e-next', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-node', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-plugin', codeowners: 'S04SYHYKGNP' },
-    { name: 'e2e-react', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-react-native', codeowners: 'S04TNCNJG5N' },
-    { name: 'e2e-web', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-rollup', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-storybook', codeowners: 'S04SVQ8H0G5' },
-    { name: 'e2e-playwright', codeowners: 'S04SVQ8H0G5' },
-    { name: 'e2e-remix', codeowners: 'S04SVQ8H0G5' },
-    { name: 'e2e-rspack', codeowners: 'S04SJ6HHP0X' },
-    { name: 'e2e-vite', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-vue', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-nuxt', codeowners: 'S04SJ6PL98X' },
-    { name: 'e2e-webpack', codeowners: 'S04SJ6PL98X' }
-  ],
-  nodeTLS: 20,
-  setup: [
-    { os: 'ubuntu-latest', os_name: 'Linux', os_timeout: 60, package_managers: ['npm', 'pnpm', 'yarn'], node_versions: ['20.19.0', "22.12.0"], excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo'] },
-    { os: 'macos-latest', os_name: 'MacOS', os_timeout: 90, package_managers: ['npm'], node_versions: ['20.19.0'] },
-    { os: 'windows-latest', os_name: 'WinOS', os_timeout: 180, package_managers: ['npm'], node_versions: ['20.19.0'], excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo'] }
-  ]
-};
-
-const matrix: Array<{
+export type MatrixItem = {
   project: string,
   codeowners: string,
   node_version: number | string,
   package_manager: string,
   os: string,
   os_name: string,
-  os_timeout: number
-}> = [];
+  os_timeout: number,
+  is_golden?: boolean,
+};
+
+// TODO: Extract Slack groups into named groups for easier maintenance
+const matrixData: MatrixData = {
+  coreProjects: [
+    { name: 'e2e-lerna-smoke-tests', codeowners: 'S04TNCVEETS', is_golden: true },
+    { name: 'e2e-js', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-nx-init', codeowners: 'S04SYHYKGNP', is_golden: true },
+    { name: 'e2e-nx', codeowners: 'S04SYHYKGNP' },
+    { name: 'e2e-release', codeowners: 'S04SYHYKGNP'},
+    { name: 'e2e-workspace-create', codeowners: 'S04SYHYKGNP' },
+  ],
+  projects: [
+    { name: 'e2e-cypress', codeowners: 'S04T16BTJJY', is_golden: true },
+    { name: 'e2e-detox', codeowners: 'S04TNCNJG5N' , is_golden: true},
+    { name: 'e2e-esbuild', codeowners: 'S04SJ6HHP0X' , is_golden: true},
+    { name: 'e2e-gradle', codeowners: 'S04TNCNJG5N' , is_golden: true},
+    { name: 'e2e-eslint', codeowners: 'S04SYJGKSCT', is_golden: true },
+    { name: 'e2e-node', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-playwright', codeowners: 'S04SVQ8H0G5', is_golden: true },
+    { name: 'e2e-remix', codeowners: 'S04SVQ8H0G5' , is_golden: true},
+    { name: 'e2e-rspack', codeowners: 'S04SJ6HHP0X', is_golden: true },
+    { name: 'e2e-vite', codeowners: 'S04SJ6PL98X' , is_golden: true},
+    { name: 'e2e-vue', codeowners: 'S04SJ6PL98X' , is_golden: true},
+    { name: 'e2e-web', codeowners: 'S04SJ6PL98X', is_golden: true },
+    { name: 'e2e-webpack', codeowners: 'S04SJ6PL98X', is_golden: true },
+    { name: 'e2e-jest', codeowners: 'S04T16BTJJY', is_golden: true },
+    { name: 'e2e-angular', codeowners: 'S04SS457V38' },
+    { name: 'e2e-expo', codeowners: 'S04TNCNJG5N' },
+    { name: 'e2e-next', codeowners: 'S04TNCNJG5N' },
+    { name: 'e2e-plugin', codeowners: 'S04SYHYKGNP' },
+    { name: 'e2e-react', codeowners: 'S04TNCNJG5N' },
+    { name: 'e2e-react-native', codeowners: 'S04TNCNJG5N' },
+    { name: 'e2e-rollup', codeowners: 'S04SJ6PL98X' },
+    { name: 'e2e-storybook', codeowners: 'S04SVQ8H0G5' },
+    { name: 'e2e-nuxt', codeowners: 'S04SJ6PL98X' }
+  ],
+  nodeTLS: 20,
+  setup: [
+    { os: 'ubuntu-latest', os_name: 'Linux', os_timeout: 60, package_managers: ['npm', 'pnpm', 'yarn'], node_versions: ['20.19.0', "22.12.0"], excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo'] },
+    { os: 'macos-latest', os_name: 'MacOS', os_timeout: 90, package_managers: ['npm'], node_versions: ['20.19.0'] },
+    // TODO (emily): Fix Windows support as gradle fails when running nx build https://staging.nx.app/runs/LgD4vxGn8w?utm_source=pull-request&utm_medium=comment
+    // { os: 'windows-latest', os_name: 'WinOS', os_timeout: 180, package_managers: ['npm'], node_versions: ['20.19.0'], excluded: ['e2e-detox', 'e2e-react-native', 'e2e-expo'] }
+  ]
+};
+
+const matrix: Array<MatrixItem> = [];
 
 function addMatrixCombo(project: MatrixDataProject, nodeVersion: number | string, pm: number, os: number) {
   matrix.push({
@@ -81,6 +86,7 @@ function addMatrixCombo(project: MatrixDataProject, nodeVersion: number | string
     os: matrixData.setup[os].os,
     os_name: matrixData.setup[os].os_name,
     os_timeout: matrixData.setup[os].os_timeout,
+    is_golden: !!project.is_golden, // Mark golden projects as true, others as false
   });
 }
 

.github/workflows/nightly/process-result.ts

@@ -0,0 +1,197 @@
+import * as fs from 'fs';
+import { MatrixItem } from './process-matrix';
+
+interface MatrixResult extends MatrixItem {
+  status: 'success' | 'failure' | 'cancelled';
+  duration: number;
+}
+
+interface ProcessedResults {
+  codeowners: string;
+  slack_message: string;
+  slack_proj_duration: string;
+  slack_pm_duration: string;
+  has_golden_failures: string;
+}
+
+function trimSpace(res: string): string {
+  return res.split('\n').map((l) => l.trim()).join('\n');
+}
+
+function humanizeDuration(num: number): string {
+  let res = '';
+  const hours = Math.floor(num / 3600);
+  if (hours) res += `${hours}h `;
+  const mins = Math.floor((num % 3600) / 60);
+  if (mins) res += `${mins}m `;
+  const sec = num % 60;
+  if (sec) res += `${sec}s`;
+  return res;
+}
+
+function processResults(combined: MatrixResult[]): ProcessedResults {
+  const failedProjects = combined.filter(c => c.status === 'failure' || c.status === 'cancelled').sort((a, b) => a.project.localeCompare(b.project));
+  const failedGoldenProjects = failedProjects.filter(c => c.is_golden);
+  const hasGoldenFailures = failedGoldenProjects.length > 0;
+  const codeowners = new Set<string>();
+  failedGoldenProjects.forEach(c => codeowners.add(c.codeowners));
+
+  let result = '';
+
+  const allGoldenProjects = combined.filter(c => c.is_golden);
+  const uniqueGoldenProjects = new Set(allGoldenProjects.map(c => c.project));
+  const uniqueFailedGoldenProjects = new Set(failedGoldenProjects.map(c => c.project));
+  const goldenPassingCount = uniqueGoldenProjects.size - uniqueFailedGoldenProjects.size;
+  const goldenFailingCount = uniqueFailedGoldenProjects.size;
+
+  const allOtherProjects = combined.filter(c => !c.is_golden);
+  const uniqueOtherProjects = new Set(allOtherProjects.map(c => c.project));
+  const failedRegularProjects = failedProjects.filter(c => !c.is_golden);
+  const uniqueFailedOtherProjects = new Set(failedRegularProjects.map(c => c.project));
+  const otherPassingCount = uniqueOtherProjects.size - uniqueFailedOtherProjects.size;
+  const otherFailingCount = uniqueFailedOtherProjects.size;
+
+  result += `\n🌟 *Golden Projects*`;
+  result += `\n✅ Passing: ${goldenPassingCount}`;
+  result += `\n❌ Failing: ${goldenFailingCount}`;
+
+  if (failedGoldenProjects.length > 0) {
+    result += `\n\n🚨 *Failed Golden Projects*\n\`\`\``;
+    result += `\n| Failed project                 |`;
+    result += `\n|--------------------------------|`;
+    let lastProject: string | undefined;
+    failedGoldenProjects.forEach(matrix => {
+      const project = matrix.project !== lastProject ? matrix.project : '';
+      if (project) {
+        result += `\n| ${project.padEnd(30)} |`;
+        lastProject = matrix.project;
+      }
+    });
+    result += `\n\`\`\``;
+  }
+
+  result += `\n\n🔧 *Other Projects*`;
+  result += `\n✅ Passing: ${otherPassingCount}`;
+  result += `\n❌ Failing: ${otherFailingCount}`;
+
+  // Failed Other Projects Table (if any)
+  if (failedRegularProjects.length > 0) {
+    result += `\n\n⚠️ *Failed Other Projects*\n\`\`\``;
+    result += `\n| Failed project                 |`;
+    result += `\n|--------------------------------|`;
+    let lastProject: string | undefined;
+    failedRegularProjects.forEach(matrix => {
+      const project = matrix.project !== lastProject ? matrix.project : '';
+      if (project) {
+        result += `\n| ${project.padEnd(30)} |`;
+        lastProject = matrix.project;
+      }
+    });
+    result += `\n\`\`\``;
+  }
+
+  if (failedProjects.length === 0) {
+    result = '🎉 *No test failures detected!* All systems green! 🟢';
+  }
+
+  const timeReport: Record<string, { min: number; max: number; minEnv: string; maxEnv: string }> = {};
+  const pmReport = { npm: 0, yarn: 0, pnpm: 0 };
+  const macosProjects = ['e2e-detox', 'e2e-expo', 'e2e-react-native'];
+
+  combined.forEach(matrix => {
+    const nodeVersion = parseInt(matrix.node_version.toString());
+    if (matrix.os_name === 'Linux' && nodeVersion === 20 && matrix.package_manager in pmReport) {
+      pmReport[matrix.package_manager as keyof typeof pmReport] += matrix.duration;
+    }
+    if (matrix.os_name === 'Linux' || macosProjects.includes(matrix.project)) {
+      if (timeReport[matrix.project]) {
+        if (matrix.duration > timeReport[matrix.project].max) {
+          timeReport[matrix.project].max = matrix.duration;
+          timeReport[matrix.project].maxEnv = `${matrix.os_name}, ${matrix.package_manager}`;
+        }
+        if (matrix.duration < timeReport[matrix.project].min) {
+          timeReport[matrix.project].min = matrix.duration;
+          timeReport[matrix.project].minEnv = `${matrix.os_name}, ${matrix.package_manager}`;
+        }
+      } else {
+        timeReport[matrix.project] = {
+          min: matrix.duration,
+          max: matrix.duration,
+          minEnv: `${matrix.os_name}, ${matrix.package_manager}`,
+          maxEnv: `${matrix.os_name}, ${matrix.package_manager}`,
+        };
+      }
+    }
+  });
+
+  let resultPkg = `
+    \`\`\`
+    | Project                        | Time                      |
+    |--------------------------------|---------------------------|`;
+
+  function mapProjectTime(proj: string, section: 'min' | 'max'): string {
+    return `${humanizeDuration(timeReport[proj][section])} (${timeReport[proj][`${section}Env`]})`;
+  }
+
+  function durationIcon(proj: string, section: 'min' | 'max'): string {
+    const duration = timeReport[proj][section];
+    if (duration < 12 * 60) return `${section} ✅`;
+    if (duration < 15 * 60) return `${section} ❗`;
+    return `${section} ❌`;
+  }
+
+  Object.keys(timeReport).forEach(proj => {
+    resultPkg += `\n| ${proj.padEnd(30)} |                           |`;
+    resultPkg += `\n| ${durationIcon(proj, 'min').padStart(29)} | ${mapProjectTime(proj, 'min').padEnd(25)} |`;
+    resultPkg += `\n| ${durationIcon(proj, 'max').padStart(29)} | ${mapProjectTime(proj, 'max').padEnd(25)} |`;
+  });
+  resultPkg += `\`\`\``;
+
+  let resultPm = `
+    \`\`\`
+    | PM   | Total time  |
+    |------|-------------|`;
+  Object.keys(pmReport).forEach(pm => {
+    resultPm += `\n| ${pm.padEnd(4)} | ${humanizeDuration(pmReport[pm as keyof typeof pmReport]).padEnd(11)} |`;
+  });
+  resultPm += `\`\`\``;
+
+  return {
+    codeowners: Array.from(codeowners).join(','),
+    slack_message: trimSpace(result),
+    slack_proj_duration: trimSpace(resultPkg),
+    slack_pm_duration: trimSpace(resultPm),
+    has_golden_failures: hasGoldenFailures.toString(),
+  };
+}
+
+function setOutput(key: string, value: string) {
+  const outputPath = process.env.GITHUB_OUTPUT;
+  if (!outputPath) {
+    console.warn(`GITHUB_OUTPUT not set. Skipping output for "${key}".`);
+    return;
+  }
+
+  if (value.includes('\n')) {
+    const delimiter = `EOF_${key}_${Date.now()}`;
+    fs.appendFileSync(outputPath, `${key}<<${delimiter}\n${value}\n${delimiter}\n`);
+  } else {
+    fs.appendFileSync(outputPath, `${key}=${value}\n`);
+  }
+}
+
+try {
+  const combinedInput = process.argv[2]
+    ? process.argv[2]
+    : fs.readFileSync(0, 'utf-8').trim();
+
+  const combined: MatrixResult[] = JSON.parse(combinedInput);
+  const results = processResults(combined);
+
+  Object.entries(results).forEach(([key, value]) => {
+    setOutput(key, value);
+  });
+} catch (error) {
+  console.error('Error processing results:', error);
+  process.exit(1);
+}

.github/workflows/npm-audit.yml

@@ -18,7 +18,7 @@ jobs:
 
       - uses: pnpm/action-setup@v4
         with:
-          version: 9.8.0 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
+          version: 10.11.1 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
 
       - name: Run a security audit
         run: pnpm dlx audit-ci --critical --report-type summary

.github/workflows/publish.yml

@@ -21,8 +21,8 @@ env:
   DEBUG: napi:*
   NX_RUN_GROUP: ${{ github.run_id }}-${{ github.run_attempt }}
   CYPRESS_INSTALL_BINARY: 0
-  NODE_VERSION: 20.19.0
-  PNPM_VERSION: 9.8.0 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
+  NODE_VERSION: 22.16.0
+  PNPM_VERSION: 10.11.1 # Aligned with root package.json (pnpm/action-setup will helpfully error if out of sync)
 
 jobs:
   # We first need to determine the version we are releasing, and if we need a custom repo or ref to use for the git checkout in subsequent steps.
@@ -123,9 +123,13 @@ jobs:
         settings:
           - host: macos-13
             target: x86_64-apple-darwin
+            setup: |-
+              rustup target add aarch64-apple-darwin
             build: |
               pnpm nx run-many --target=build-native -- --target=x86_64-apple-darwin
           - host: windows-latest
+            setup: |-
+              rustup target add aarch64-pc-windows-msvc
             build: pnpm nx run-many --target=build-native -- --target=x86_64-pc-windows-msvc
             target: x86_64-pc-windows-msvc
           # Windows 32bit (not needed)
@@ -136,23 +140,54 @@ jobs:
           - host: ubuntu-latest
             target: x86_64-unknown-linux-gnu
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-debian
-            build: |-
-              set -e &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
+            build: |
+              set -e
+              apt-get update
+
+              curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+              apt-get install -y nodejs=22.16.0-1nodesource1
+            
+              export PATH="/usr/local/bin:$PATH"
+              node --version
+              npm --version
+            
+              npm i -g pnpm@${PNPM_VERSION} --force
+              pnpm --version
+            
+              pnpm install --frozen-lockfile
+              rustup target add x86_64-unknown-linux-gnu
               pnpm nx run-many --verbose --target=build-native -- --target=x86_64-unknown-linux-gnu
           - host: ubuntu-latest
             target: x86_64-unknown-linux-musl
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-alpine
-            build: |-
-              set -e &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
-              pnpm nx run-many --verbose --target=build-native -- --target=x86_64-unknown-linux-musl
+            build: |
+              bash -c "
+                set -e
+                echo 'https://dl-cdn.alpinelinux.org/alpine/edge/community' >> /etc/apk/repositories
+                apk add --no-cache curl xz
+
+                curl -fsSL https://unofficial-builds.nodejs.org/download/release/v22.16.0/node-v22.16.0-linux-x64-musl.tar.xz -o node.tar.xz
+                tar -xJf node.tar.xz
+                mv node-v22.16.0-linux-x64-musl /usr/local/node
+            
+                export PATH=\"/usr/local/node/bin:\$PATH\"
+            
+                echo Node: \$(node -v)
+                echo NPM: \$(npm -v)
+            
+                # Install PNPM
+                npm i -g pnpm@${PNPM_VERSION} --force
+                pnpm --version
+            
+                # Install deps and run native build
+                pnpm install --frozen-lockfile
+                rustup target add x86_64-unknown-linux-musl
+                pnpm nx run-many --verbose --target=build-native -- --target=x86_64-unknown-linux-musl
+              "
           - host: macos-13
             target: aarch64-apple-darwin
+            setup: |-
+              rustup target add aarch64-apple-darwin
             build: |
               sudo rm -Rf /Library/Developer/CommandLineTools/SDKs/*;
               export CC=$(xcrun -f clang);
@@ -163,17 +198,29 @@ jobs:
           - host: ubuntu-latest
             target: aarch64-unknown-linux-gnu
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-debian-aarch64
-            build: |-
-              set -e &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
+            build: |
+              set -e
+              apt-get update
+            
+              curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
+              apt-get install -y nodejs=22.16.0-1nodesource1
+            
+              export PATH="/usr/local/bin:$PATH"
+              node --version
+              npm --version
+            
+              npm i -g pnpm@${PNPM_VERSION} --force
+              pnpm --version
+            
+              pnpm install --frozen-lockfile
+              rustup target add aarch64-unknown-linux-gnu
               pnpm nx run-many --verbose --target=build-native -- --target=aarch64-unknown-linux-gnu
           - host: ubuntu-latest
             target: armv7-unknown-linux-gnueabihf
             setup: |
               sudo apt-get update
               sudo apt-get install gcc-arm-linux-gnueabihf -y
+              rustup target add armv7-unknown-linux-gnueabihf
             build: |
               CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER=/usr/bin/arm-linux-gnueabihf-gcc pnpm nx run-many --target=build-native -- --target=armv7-unknown-linux-gnueabihf
           # Android (not needed)
@@ -188,17 +235,36 @@ jobs:
           - host: ubuntu-latest
             target: aarch64-unknown-linux-musl
             docker: ghcr.io/napi-rs/napi-rs/nodejs-rust:lts-alpine
-            build: |-
-              set -e &&
-              rustup target add aarch64-unknown-linux-musl &&
-              npm i -g pnpm@9.8.0 --force &&
-              pnpm --version &&
-              pnpm install --frozen-lockfile &&
-              pnpm nx run-many --verbose --target=build-native -- --target=aarch64-unknown-linux-musl
+            build: |
+              bash -c "
+                set -e
+                echo 'https://dl-cdn.alpinelinux.org/alpine/edge/community' >> /etc/apk/repositories
+                apk add --no-cache curl xz
+            
+                curl -fsSL https://unofficial-builds.nodejs.org/download/release/v22.16.0/node-v22.16.0-linux-x64-musl.tar.xz -o node.tar.xz
+                tar -xJf node.tar.xz
+                mv node-v22.16.0-linux-x64-musl /usr/local/node
+            
+                export PATH=\"/usr/local/node/bin:\$PATH\"
+            
+                echo Node: \$(node -v)
+                echo NPM: \$(npm -v)
+            
+                # Install PNPM
+                npm i -g pnpm@${PNPM_VERSION} --force
+                pnpm --version
+            
+                # Install deps and run native build
+                pnpm install --frozen-lockfile
+                rustup target add aarch64-unknown-linux-musl  
+                pnpm nx run-many --verbose --target=build-native -- --target=aarch64-unknown-linux-musl  
+              "
           - host: windows-latest
             target: aarch64-pc-windows-msvc
+            setup: |-
+              rustup target add aarch64-pc-windows-msvc
             build: pnpm nx run-many --target=build-native -- --target=aarch64-pc-windows-msvc
-    name: stable - ${{ matrix.settings.target }} - node@18
+    name: stable - ${{ matrix.settings.target }} - node@22.16.0
     runs-on: ${{ matrix.settings.host }}
     steps:
       - uses: actions/checkout@v4
@@ -282,8 +348,8 @@ jobs:
         with:
           name: bindings-${{ matrix.settings.target }}
           path: |
-            packages/**/*.node
-            packages/**/*.wasm
+            packages/nx/src/native/*.node
+            packages/nx/src/native/*.wasm
           if-no-files-found: error
 
   build-freebsd:
@@ -306,17 +372,18 @@ jobs:
           RUSTUP_IO_THREADS: 1
           NX_PREFER_TS_NODE: true
           PLAYWRIGHT_BROWSERS_PATH: 0
+          NODE_VERSION: 22.16.0
         with:
           operating_system: freebsd
           version: '14.0'
           architecture: x86-64
-          environment_variables: DEBUG RUSTUP_IO_THREADS CI NX_PREFER_TS_NODE PLAYWRIGHT_BROWSERS_PATH
+          environment_variables: DEBUG RUSTUP_IO_THREADS CI NX_PREFER_TS_NODE PLAYWRIGHT_BROWSERS_PATH NODE_VERSION
           shell: bash
           run: |
             env
             whoami
             sudo pkg install -y -f node libnghttp2 www/npm git
-            sudo npm install --location=global --ignore-scripts pnpm@9.8.0
+            sudo npm install --location=global --ignore-scripts pnpm@10.11.1
             curl https://sh.rustup.rs -sSf --output rustup.sh
             sh rustup.sh -y --profile minimal --default-toolchain stable
             source "$HOME/.cargo/env"
@@ -331,8 +398,11 @@ jobs:
             whoami
             env
             freebsd-version
+            echo "Installing dependencies"
             pnpm install --frozen-lockfile --ignore-scripts
+            echo "Building FreeBSD bindings"
             pnpm nx run-many --verbose --outputStyle stream --target=build-native -- --target=x86_64-unknown-freebsd
+            echo "Cleaning up"
             pnpm nx reset
             rm -rf node_modules
             rm -rf dist
@@ -344,7 +414,8 @@ jobs:
         uses: actions/upload-artifact@v4
         with:
           name: bindings-freebsd
-          path: packages/**/*.node
+          path: |
+            packages/nx/src/native/*.node
           if-no-files-found: error
 
   publish:
@@ -403,6 +474,7 @@ jobs:
           VERSION: ${{ needs.resolve-required-data.outputs.version }}
           DRY_RUN: ${{ needs.resolve-required-data.outputs.dry_run_flag }}
           PUBLISH_BRANCH: ${{ needs.resolve-required-data.outputs.publish_branch }}
+          NX_VERBOSE_LOGGING: true
         run: |
           echo ""
           # Create and check out the publish branch

.gitignore

@@ -2,7 +2,6 @@ node_modules
 /.idea
 /.fleet
 /.vscode
-/.cursor
 dist
 /build
 /coverage
@@ -36,6 +35,7 @@ CHANGELOG.md
 .next
 out
 
+
 # Angular Cache
 .angular
 
@@ -72,3 +72,40 @@ storybook-static
 # Ignore Gradle project-specific cache directory
 .gradle
 .kotlin
+
+.claude/settings.local.json
+
+.cursor/rules/nx-rules.mdc
+.cursor/mcp.json
+.github/instructions/nx.instructions.md
+
+# Added by Claude Task Master
+# Logs
+logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+dev-debug.log
+# Dependency directories
+node_modules/
+# Environment variables
+.env
+# Editor directories and files
+.idea
+.vscode
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+.specstory/**
+.cursorindexingignore
+# OS specific
+# Task files
+tasks.json
+tasks/
+
+# Upstream docs local configuration (machine-specific)
+.upstreamdocs.local.json
+
+astro-docs/.netlify

.husky/pre-push

@@ -1,5 +1 @@
-pnpm check-lock-files
-pnpm check-commit
-pnpm documentation
-pnpm pretty-quick --check
-pnpm nx format-native nx
+pnpm nx prepush --parallel 8 --tuiAutoExit 0

.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "nx": {
+      "command": "pnpm",
+      "args": ["nx-mcp"],
+      "env": {}
+    }
+  }
+}

.nx/workflows/dynamic-changesets.yaml

@@ -9,6 +9,7 @@ assignment-rules:
       - agent: linux-extra-large
         parallelism: 1
 
+  # These projects should not need to be isolated.
   - projects:
       - nx-dev
     targets:
@@ -16,6 +17,14 @@ assignment-rules:
     run-on:
       - agent: linux-extra-large
         parallelism: 1
+  - projects:
+      - angular
+      - react
+    targets:
+      - test
+    run-on:
+      - agent: linux-extra-large
+        parallelism: 1
 
   - targets:
       - lint

.pnpmrc

@@ -0,0 +1,13 @@
+# Enable pre/post-install which are disabled by default. Installing peer deps which is also disabled by default
+auto-install-peers=true
+enable-pre-post-scripts=true
+
+# Enable lifecycle scripts for specific packages that require them (like post-install)
+enable-scripts=@napi-rs/canvas,sharp,@swc/core,@swc/cli,@swc-node/register,esbuild
+
+# Compatibility
+strict-peer-dependencies=false
+lockfile-version-strict=false
+
+# Consistency across environments
+use-node-version=20.19.0 

.prettierignore

@@ -51,3 +51,6 @@ CODEOWNERS
 /.nx/workflows/dynamic-changesets.yaml
 _files
 _solution
+
+# this file uses TS import attributes which the current prettier version does not support
+tools/documentation/create-embeddings/src/main.mts

.upstreamdocs.json

@@ -0,0 +1,10 @@
+{
+  "include": ["apps/**/*", "libs/**/*", "packages/**/*"],
+  "exclude": [
+    "**/*.spec.*",
+    "**/test/**/*",
+    "**/__tests__/**/*",
+    "**/*.test.*",
+    "node_modules/**/*"
+  ]
+}

.verdaccio/config.yml

@@ -5,7 +5,7 @@ auth:
   htpasswd:
     file: ./htpasswd
 
-max_body_size: 15mb
+max_body_size: 20mb
 
 # a list of other known repositories we can talk to
 uplinks:

CLAUDE.md

@@ -0,0 +1,184 @@
+When responding to queries about this repository:
+
+1. Use the `nx_workspace` mcp tool for understanding the workspace architecture when appropriate
+2. When working in projects, use the `nx_project` mcp tool to analyze and understand the specific project structure and
+   dependencies
+3. Suggest relevant commands from the "Essential Commands" section when applicable
+4. Highlight Nx's focus on monorepos and its key features like smart task execution, code generation, and project graph
+   analysis
+5. Mention the plugin ecosystem and support for various frameworks when relevant
+6. Emphasize the importance of running the full validation suite before committing changes
+
+Always strive to provide accurate, helpful responses that align with the best practices and workflows described in this
+file.
+
+## GitHub Issue Response Mode
+
+When responding to GitHub issues, determine your approach based on how the request is phrased:
+
+### Plan-First Mode (Default)
+
+Use this approach when users ask you to:
+
+- "analyze", "investigate", "assess", "review", "examine", or "plan"
+- Or when the request is ambiguous
+
+In this mode:
+
+1. Provide a detailed analysis of the issue
+2. Create a comprehensive implementation plan
+3. Break down the solution into clear steps
+4. Then please post the plan as a comment on the issue
+
+### Immediate Implementation Mode
+
+Use this approach when users ask you to:
+
+- "fix", "implement", "solve", "build", "create", "update", or "add"
+- Or when they explicitly request immediate action
+
+In this mode:
+
+1. Analyze the issue quickly
+2. Implement the complete solution immediately
+3. Make all necessary code changes. Please make multiple commits so that the changes are easier to review.
+4. Run appropriate tests and validation
+5. If the tests, are not passing, please fix the issues and continue doing this up to 3 more times until the tests pass
+6. Once the tests pass, push a branch and then suggest opening a PR which has a description of the changes made, and
+   that
+   it make sure that it explicitly says "Fixes #ISSUE_NUMBER" to automatically close the issue when the PR is merged.
+
+## Avoid making changes to generated files
+
+Files under `generated` directories are generated based on a different source file and should not be modified directly.
+Find the underlying source and modify that instead.
+
+## Essential Commands
+
+### Code Formatting
+
+After code changes are made, please make sure to format the files with prettier via `npx prettier -- FILE_NAME`
+
+### Pre-push Validation
+
+```bash
+# Full validation suite - run before committing
+nx prepush
+```
+
+If the prepush validation suite fails, please fix the issues before proceeding with your work. This ensures that all
+code adheres to the project's standards and passes all tests. DO NOT make a new commit to fix these issues. Instead,
+amend the current commit.
+
+### Testing Changes
+
+After code changes are made, first test the specific project where the changes were made:
+
+```bash
+nx run-many -t test,build,lint -p PROJECT_NAME
+```
+
+After verifying the individual project, validate that the changes in projects which have been affected:
+
+```bash
+# Test only affected projects (recommended for development)
+nx affected -t build,test,lint
+```
+
+As the last step, run the e2e tests to fully ensure that changes are valid:
+
+```bash
+# Run affected e2e tests (recommended for development)
+nx affected -t e2e-local
+```
+
+## Fixing GitHub Issues
+
+When working on a GitHub issue, follow this systematic approach:
+
+### 1. Get Issue Details
+
+```bash
+# Get issue details using GitHub CLI (replace ISSUE_NUMBER with actual number)
+gh issue view ISSUE_NUMBER
+
+# View multiple issues efficiently in one command
+gh issue list --limit 50 --json number,title,state,labels,assignees,updatedAt,body --jq '.[] | select(.number == 123 or .number == 456 or .number == 789)'
+
+# Or filter by specific criteria to get multiple related issues
+gh issue list --label "bug" --state "open" --json number,title,body,labels --jq '.[]'
+gh issue list --assignee "@me" --json number,title,body,state --jq '.[]'
+```
+
+**Tip**: Instead of running `gh issue view` multiple times, use `gh issue list` with JSON output and filtering to gather
+information about multiple issues in a single command. This is much more efficient than viewing issues one at a time.
+
+**Always provide clickable links**: When discussing GitHub issues or PRs, always include the full GitHub URL so the user
+can easily open them in their browser. For example:
+
+- Issue #12345: https://github.com/nrwl/nx/issues/12345
+- PR #67890: https://github.com/nrwl/nx/pull/67890
+
+When cloning reproduction repos, please clone within `./tmp/claude/repro-ISSUE_NUMBER`
+
+### 2. Analyze the Plan
+
+- Look for a plan or implementation details in the issue description
+- Check comments for additional context or clarification
+- Identify affected projects and components
+
+### 3. Implement the Solution
+
+- Follow the plan outlined in the issue
+- Make focused changes that address the specific problem
+- Ensure code follows existing patterns and conventions
+
+### 4. Run Full Validation
+
+Use the testing workflow from the "Essential Commands" section.
+
+### 5. Submit Pull Request
+
+- Create a descriptive PR title that references the issue
+- **Always fill in the PR template** - don't leave it empty
+- Include "Fixes #ISSUE_NUMBER" in the PR description
+- Provide a clear summary of changes made
+- Request appropriate reviewers
+
+## Pull Request Template
+
+**IMPORTANT**: When creating a pull request, you MUST fill in the template found in `.github/PULL_REQUEST_TEMPLATE.md`.
+Do not leave the template sections empty. The template includes:
+
+### Required Sections
+
+1. **Current Behavior**: Describe the behavior we have today
+2. **Expected Behavior**: Describe the behavior we should expect with the changes in this PR
+3. **Related Issue(s)**: Link the issue being fixed so it gets closed when the PR is merged
+
+### Template Format
+
+```markdown
+## Current Behavior
+
+<!-- This is the behavior we have today -->
+
+## Expected Behavior
+
+<!-- This is the behavior we should expect with the changes in this PR -->
+
+## Related Issue(s)
+
+<!-- Please link the issue being fixed so it gets closed when this is merged. -->
+
+Fixes #ISSUE_NUMBER
+```
+
+### Guidelines
+
+- Ensure your commit message follows the conventional commit format (use `pnpm commit`)
+  - Use `fix:`, `feat:`, `chore:`, etc. as appropriate types.
+  - Scope is **required** for all commits. Possible scopes are listed in `scripts/commitizen.js`.
+- Read the submission guidelines in CONTRIBUTING.md before posting
+- For complex changes, you can request a dedicated Nx release by mentioning the Nx team
+- Always link the related issue using "Fixes #ISSUE_NUMBER" to automatically close it when merged

CODEOWNERS

@@ -6,7 +6,7 @@
 /tools/**/* @FrozenPandaz @vsavkin @AgentEnder @jaysoo @JamesHenry
 package.json @nrwl/nx-core-reviewers
 pnpm-lock.yaml @nrwl/nx-core-reviewers
-rust-toolchain @nrwl/nx-native-reviewers
+rust-toolchain.toml @nrwl/nx-native-reviewers
 
 # Docs Site + Graph
 /docs @nrwl/nx-docs-reviewers
@@ -137,6 +137,9 @@ rust-toolchain @nrwl/nx-native-reviewers
 /packages/storybook/** @nrwl/nx-storybook-reviewers
 /e2e/storybook/** @nrwl/nx-storybook-reviewers
 
+# Docker
+/packages/docker/** @nrwl/nx-core-reviewers @Coly010
+
 ## Devkit
 /docs/generated/devkit/** @nrwl/nx-devkit-reviewers @nrwl/nx-docs-reviewers
 /docs/generated/packages/devkit/** @nrwl/nx-devkit-reviewers @nrwl/nx-docs-reviewers
@@ -174,7 +177,7 @@ rust-toolchain @nrwl/nx-native-reviewers
 
 # Misc
 /e2e/lerna-smoke-tests/** @vsavkin @JamesHenry
-/e2e/utils/** @meeroslav @nrwl/nx-testing-tools-reviewers @vsavkin @mandarini
+/e2e/utils/** @meeroslav @nrwl/nx-testing-tools-reviewers @vsavkin
 /community @nrwl/nx-docs-reviewers
 /CONTRIBUTING.md @FrozenPandaz @isaacplmann
 /CODE_OF_CONDUCT.md @FrozenPandaz @isaacplmann
@@ -191,6 +194,11 @@ rust-toolchain @nrwl/nx-native-reviewers
 /.husky/** @nrwl/nx-pipelines-reviewers
 /packages/workspace/src/generators/ci-workflow/** @nrwl/nx-pipelines-reviewers
 
+# Claude AI Integration
+CLAUDE.md @FrozenPandaz
+.claude/** @FrozenPandaz
+.mcp.json @FrozenPandaz
+
 # Global Files
 project.json @FrozenPandaz @vsavkin
 jest.config.ts @nrwl/nx-testing-tools-reviewers @FrozenPandaz

CONTRIBUTING.md

@@ -27,14 +27,25 @@ can [submit a Pull Request](https://github.com/nrwl/nx/blob/master/CONTRIBUTING.
 
 Source code and documentation are included in the top-level folders listed below.
 
-- `docs` - Markdown and configuration files for documentation including tutorials, guides for each supported platform,
-  and API docs.
-- `e2e` - E2E tests.
 - `packages` - Source code for Nx packages such as Angular, React, Web, NestJS, Next and others including generators and
   executors (or builders).
+- `e2e` - E2E tests for the Nx packages
+- `graph` - Source code for the Nx Graph application which shows the project graph, task graph, project details, and more in the browser.
+- `docs` - Markdown and configuration files for documentation including tutorials, guides for each supported platform,
+  and API docs.
+- `nx-dev` - Source code for the Nx documentation site which displays the markdown in `docs` and more.
+- `tools` - Workspace-specific tooling and plugins
 - `scripts` - Miscellaneous scripts for project tasks such as building documentation, testing, and code formatting.
 - `tmp` - Folder used by e2e tests. If you are a WebStorm user, make sure to mark this folder as excluded.
 
+## Technologies
+
+This repo contains a mix of different technologies, including:
+
+- **Rust**: The core of Nx is written in Rust, which provides performance and safety.
+- **TypeScript**: The primary language for Nx packages and the Nx DevKit.
+- **Kotlin**: Used for the Gradle and Java plugins.
+
 ## Development Workstation Setup
 
 If you are using `VSCode`, and provided you have [Docker](https://docker.com) installed on your machine, then you can leverage [Dev Containers](https://containers.dev) through this [VSCode extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers), to easily setup your development environment, with everything needed to contribute to Nx, already installed (namely `NodeJS`, `Yarn`, `Rust`, `Cargo`, plus some useful extensions like `Nx Console`).
@@ -374,6 +385,57 @@ To simplify and automate the process of committing with this format,
 **Nx is a [Commitizen](https://github.com/commitizen/cz-cli) friendly repository**, just do `git add` and
 execute `pnpm commit`.
 
+##### Using the Interactive Commit Tool
+
+Instead of `git commit`, use:
+
+```bash
+pnpm commit
+```
+
+This will launch an interactive prompt that will:
+
+1. Ask you to select the type of change (feat, fix, docs, cleanup, chore)
+2. Let you choose the appropriate scope from the predefined list
+3. Guide you through writing a clear, descriptive commit message
+4. Ensure your commit follows the conventional commit format
+
+##### Available Commit Types
+
+- **feat**: A new feature
+- **fix**: A bug fix
+- **docs**: Documentation only changes
+- **cleanup**: A code change that neither fixes a bug nor adds a feature
+- **chore**: Other changes that don't modify src or test files
+
+##### Available Scopes
+
+The repository includes many predefined scopes. Use the one which is most specific to the changes being committed
+
+- **core**: anything Nx core specific
+- **angular**: anything Angular specific
+- **react**: anything React specific
+- **nextjs**: anything Next specific
+- **node**: anything Node specific
+- **devkit**: devkit-related changes
+- **graph**: anything graph app specific
+- **testing**: anything testing specific (e.g. jest or cypress)
+- **misc**: misc stuff
+- **repo**: anything related to managing the repo itself
+- **nx-dev**: anything related to docs infrastructure
+
+For the complete list of available scopes, see `/scripts/commitizen.js`.
+
+##### Example Commits
+
+```bash
+feat(core): add new project graph visualization
+fix(angular): resolve build issues with standalone components
+docs(misc): update contributing guidelines
+chore(repo): bump dependencies
+cleanup(devkit): refactor utility functions for better readability
+```
+
 #### PR releases
 
 If you are working on a particularly complex change or feature addition, you can request a dedicated Nx release for the associated pull request branch. Mention someone from the Nx team or the `@nrwl/nx-pipelines-reviewers` and they will confirm if the PR warrants its own release for testing purposes, and generate it for you if appropriate.

README.md

@@ -1,7 +1,7 @@
 <p style="text-align: center;">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-dark.svg">
-    <img alt="Nx - Smart Monorepos · Fast CI" src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-light.svg" width="100%">
+    <img alt="Nx - Smart Repos · Fast Builds" src="https://raw.githubusercontent.com/nrwl/nx/master/images/nx-light.svg" width="100%">
   </picture>
 </p>
 
@@ -19,9 +19,9 @@
 
 <hr>
 
-# Smart Monorepos · Fast CI
+# Smart Repos · Fast Builds
 
-Build system, optimized for monorepos, with AI-powered architectural awareness and advanced CI capabilities.
+An AI-first build platform that connects everything from your editor to CI. Helping you deliver fast, without breaking things.
 
 Create a new Nx workspace with
 
@@ -35,7 +35,7 @@ npx create-nx-workspace
 npx nx init
 ```
 
-to add Nx to your existing workspace to get faster task scheduling, caching and more. More [in the docs](https://nx.dev/getting-started/intro#try-nx-yourself).
+to add Nx to your existing workspace to get faster task scheduling, caching and more. More [in the docs](https://nx.dev/getting-started/intro).
 
 ## Learn about CI with Nx Cloud
 
@@ -58,7 +58,7 @@ Learn more in the [Nx CI docs &raquo;](https://nx.dev/ci/intro?utm_source=nxrepo
 - [Our Twitter/X](https://x.com/nxdevtools)
 
 <p style="text-align: center;"><a href="https://www.youtube.com/@nxdevtools/videos" target="_blank" rel="noreferrer"><img src="./images/nx-courses-and-videos.svg" 
-width="100%" alt="Nx - Smart Monorepos · Fast CI"></a></p>
+width="100%" alt="Nx - Smart Repos · Fast Builds"></a></p>
 
 ## Want to help?
 
@@ -82,17 +82,17 @@ help you get started.
 | ![James Henry](https://avatars.githubusercontent.com/u/900523?s=160&v=4) | ![Jon Cammisuli](https://avatars2.githubusercontent.com/u/4332460?s=160) | ![Isaac Mann](https://avatars1.githubusercontent.com/u/861504?s=160) | ![Juri Strumpflohner](https://avatars1.githubusercontent.com/u/542458?s=160) |
 | [JamesHenry](https://github.com/JamesHenry)                              | [cammisuli](https://github.com/cammisuli)                                | [isaacplmann](https://github.com/isaacplmann)                        | [juristr](https://github.com/juristr)                                        |
 
-| Philip Fulcher                                                            | Caleb Ukle                                                            | Katerina Skroumpelou                                                            | Colum Ferry                                                            |
-| ------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| ![Philip Fulcher](https://avatars1.githubusercontent.com/u/1536471?s=160) | ![Caleb Ukle](https://avatars.githubusercontent.com/u/23272162?s=160) | ![Katerina Skroumpelou](https://avatars0.githubusercontent.com/u/6603745?s=160) | ![Colum Ferry](https://avatars.githubusercontent.com/u/12140467?s=160) |
-| [philipjfulcher](https://github.com/philipjfulcher)                       | [barbados-clemens](https://github.com/barbados-clemens)               | [mandarini](https://github.com/mandarini)                                       | [Coly010](https://github.com/Coly010)                                  |
+| Philip Fulcher                                                            | Caleb Ukle                                                            | Colum Ferry                                                            | Emily Xiong                                                            |
+| ------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| ![Philip Fulcher](https://avatars1.githubusercontent.com/u/1536471?s=160) | ![Caleb Ukle](https://avatars.githubusercontent.com/u/23272162?s=160) | ![Colum Ferry](https://avatars.githubusercontent.com/u/12140467?s=160) | ![Emily Xiong](https://avatars.githubusercontent.com/u/16211801?s=160) |
+| [philipjfulcher](https://github.com/philipjfulcher)                       | [barbados-clemens](https://github.com/barbados-clemens)               | [Coly010](https://github.com/Coly010)                                  | [xiongemi](https://github.com/xiongemi)                                |
 
-| Emily Xiong                                                            | Miroslav Jonaš                                                          | Leosvel Pérez Espinosa                                                            | Zachary DeRose                                                           |
-| ---------------------------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
-| ![Emily Xiong](https://avatars.githubusercontent.com/u/16211801?s=160) | ![Miroslav Jonaš](https://avatars.githubusercontent.com/u/881612?s=160) | ![Leosvel Pérez Espinosa](https://avatars.githubusercontent.com/u/12051310?s=160) | ![Zachary DeRose](https://avatars.githubusercontent.com/u/3788405?s=160) |
-| [xiongemi](https://github.com/xiongemi)                                | [meeroslav](https://github.com/meeroslav)                               | [leosvelperez](https://github.com/leosvelperez)                                   | [ZackDeRose](https://github.com/ZackDeRose)                              |
+| Miroslav Jonaš                                                          | Leosvel Pérez Espinosa                                                            | Zachary DeRose                                                           | Craigory Coppola                                                           |
+| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
+| ![Miroslav Jonaš](https://avatars.githubusercontent.com/u/881612?s=160) | ![Leosvel Pérez Espinosa](https://avatars.githubusercontent.com/u/12051310?s=160) | ![Zachary DeRose](https://avatars.githubusercontent.com/u/3788405?s=160) | ![Craigory Coppola](https://avatars.githubusercontent.com/u/6933928?s=160) |
+| [meeroslav](https://github.com/meeroslav)                               | [leosvelperez](https://github.com/leosvelperez)                                   | [ZackDeRose](https://github.com/ZackDeRose)                              | [AgentEnder](https://github.com/AgentEnder)                                |
 
-| Craigory Coppola                                                           | Chau Tran                                                            | Nicholas Cunningham                                                          | Max Kless                                                            |
-| -------------------------------------------------------------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| ![Craigory Coppola](https://avatars.githubusercontent.com/u/6933928?s=160) | ![Chau Tran](https://avatars.githubusercontent.com/u/25516557?s=160) | ![Nicholas Cunningham](https://avatars.githubusercontent.com/u/338948?s=160) | ![Max Kless](https://avatars.githubusercontent.com/u/34165455?s=160) |
-| [AgentEnder](https://github.com/AgentEnder)                                | [nartc](https://github.com/nartc)                                    | [ndcunningham](https://github.com/ndcunningham)                              | [MaxKless](https://github.com/MaxKless)                              |
+| Chau Tran                                                            | Nicholas Cunningham                                                          | Max Kless                                                            |
+| -------------------------------------------------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| ![Chau Tran](https://avatars.githubusercontent.com/u/25516557?s=160) | ![Nicholas Cunningham](https://avatars.githubusercontent.com/u/338948?s=160) | ![Max Kless](https://avatars.githubusercontent.com/u/34165455?s=160) |
+| [nartc](https://github.com/nartc)                                    | [ndcunningham](https://github.com/ndcunningham)                              | [MaxKless](https://github.com/MaxKless)                              |

astro-docs/.gitignore

@@ -0,0 +1,24 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# Local Netlify folder
+.netlify

astro-docs/README.md

@@ -0,0 +1,54 @@
+# Starlight Starter Kit: Basics
+
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+
+```
+pnpm create astro@latest -- --template starlight
+```
+
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
+[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
+[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics)
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs)
+
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
+
+## 🚀 Project Structure
+
+Inside of your Astro + Starlight project, you'll see the following folders and files:
+
+```
+.
+├── public/
+├── src/
+│   ├── assets/
+│   ├── content/
+│   │   ├── docs/
+│   └── content.config.ts
+├── astro.config.mjs
+├── package.json
+└── tsconfig.json
+```
+
+Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
+
+Images can be added to `src/assets/` and embedded in Markdown with a relative link.
+
+Static assets, like favicons, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                | Action                                           |
+| :--------------------- | :----------------------------------------------- |
+| `pnpm install`         | Installs dependencies                            |
+| `pnpm dev`             | Starts local dev server at `localhost:4321`      |
+| `pnpm build`           | Build your production site to `./dist/`          |
+| `pnpm preview`         | Preview your build locally, before deploying     |
+| `pnpm astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `pnpm astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).

astro-docs/astro.config.mjs

@@ -0,0 +1,99 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+import { sectionSidebarPlugin } from './src/plugins/section-sidebar.plugin';
+import netlify from '@astrojs/netlify';
+import linkValidator from 'starlight-links-validator';
+import react from '@astrojs/react';
+import markdoc from '@astrojs/markdoc';
+import tailwindcss from '@tailwindcss/vite';
+
+// https://astro.build/config
+export default defineConfig({
+  vite: { plugins: [tailwindcss()] },
+  site: 'https://docs.nx.dev',
+  adapter: netlify(),
+  integrations: [
+    markdoc(),
+    starlight({
+      title: 'Nx',
+      tagline:
+        'An AI-first build platform that connects everything from your editor to CI. Helping you deliver fast, without breaking things.',
+      customCss: ['./src/styles/global.css'],
+      favicon: '/favicon.svg',
+      logo: {
+        src: './src/assets/nx/Nx-light.png',
+        replacesTitle: true,
+      },
+      plugins: [
+        // linkValidator(),
+        sectionSidebarPlugin(),
+      ],
+      routeMiddleware: ['./src/plugins/banner.middleware.ts'],
+      markdown: {
+        // this breaks the renderMarkdown function in the plugin loader due to starlight path normalization
+        // as to _why_ it has to normalize a path?
+        // idk just working around the issue for now but we'll want to have linked headers so will need to fix
+        headingLinks: false,
+      },
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/nrwl/nx' },
+        {
+          icon: 'youtube',
+          label: 'YouTube',
+          href: 'https://www.youtube.com/@NxDevtools?utm_source=nx.dev',
+        },
+        {
+          icon: 'x.com',
+          label: 'X',
+          href: 'https://x.com/NxDevTools?utm_source=nx.dev',
+        },
+        {
+          icon: 'discord',
+          label: 'Discord',
+          href: 'https://go.nx.dev/community',
+        },
+      ],
+      editLink: {
+        baseUrl: 'https://github.com/nrwl/nx/tree/main/',
+      },
+      sidebar: [
+        {
+          label: 'Getting Started',
+          autogenerate: { directory: 'getting-started' },
+        },
+        {
+          label: 'Guides',
+          autogenerate: { directory: 'guides' },
+        },
+        {
+          label: 'Concepts',
+          autogenerate: { directory: 'concepts' },
+        },
+        {
+          label: 'References',
+          collapsed: true,
+          items: [
+            // have to use link bc slug is mapped to the /docs/ folder but we need the astro component in the pages/ dir
+            { label: 'Nx CLI', link: 'api/nx-cli' },
+            { label: 'Nx Cloud CLI', slug: 'api/nx-cloud-cli' },
+            { label: 'create-nx-workspace', link: 'api/create-nx-workspace' },
+            {
+              label: 'devkit',
+              collapsed: true,
+              items: [
+                { label: 'Overview', link: 'api/plugins/devkit/' },
+                {
+                  label: 'Ng CLI Adapter',
+                  link: 'api/plugins/devkit/ngcli_adapter',
+                },
+              ],
+            },
+            // plugins are autogenerated from the Nx repository via the sidebar plugin
+          ],
+        },
+      ],
+    }),
+    react(),
+  ],
+});

astro-docs/markdoc.config.mjs

@@ -0,0 +1,29 @@
+import { defineMarkdocConfig, component } from '@astrojs/markdoc/config';
+import starlightMarkdoc from '@astrojs/starlight-markdoc';
+
+export default defineMarkdocConfig({
+  extends: [starlightMarkdoc()],
+  tags: {
+    youtube: {
+      render: component('./src/components/Youtube.astro'),
+      attributes: {
+        src: {
+          type: 'String',
+          required: true,
+        },
+        title: {
+          type: 'String',
+          required: true,
+        },
+        width: {
+          type: 'String',
+          default: '100%',
+        },
+        caption: {
+          type: 'String',
+          required: false,
+        },
+      },
+    },
+  },
+});

astro-docs/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "astro-docs",
+  "version": "0.0.1",
+  "private": true,
+  "dependencies": {
+    "@astrojs/check": "^0.7.0",
+    "@astrojs/markdoc": "^0.15.0",
+    "@astrojs/netlify": "^6.4.0",
+    "@astrojs/react": "^4.3.0",
+    "@astrojs/starlight": "0.34.6",
+    "@astrojs/starlight-markdoc": "^0.4.0",
+    "@astrojs/starlight-tailwind": "^4.0.1",
+    "@nx/nx-dev-ui-icons": "workspace:*",
+    "@nx/nx-dev-ui-markdoc": "workspace:*",
+    "@tailwindcss/vite": "^4.1.11",
+    "astro": "^5.10.1",
+    "tailwindcss": "4.1.11"
+  }
+}

astro-docs/project.json

@@ -0,0 +1,37 @@
+{
+  "name": "astro-docs",
+  "targets": {
+    "comment": "package.json#scripts runs in the project root directory with astro assumes is where the node_modules is. which fails. so run the scripts in project.json#targets with --root command instead",
+    "serve": {
+      "continuous": true,
+      "dependsOn": [
+        {
+          "projects": ["devkit", "create-nx-workspace"],
+          "target": "build"
+        }
+      ],
+      "command": "astro dev",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    },
+    "build": {
+      "dependsOn": [
+        {
+          "projects": ["devkit", "create-nx-workspace"],
+          "target": "build"
+        }
+      ],
+      "command": "astro build",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    },
+    "astro": {
+      "command": "astro",
+      "options": {
+        "cwd": "astro-docs"
+      }
+    }
+  }
+}

astro-docs/public/favicon.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Nx</title><path d="M11.987 14.138l-3.132 4.923-5.193-8.427-.012 8.822H0V4.544h3.691l5.247 8.833.005-3.998 3.044 4.759zm.601-5.761c.024-.048 0-3.784.008-3.833h-3.65c.002.059-.005 3.776-.003 3.833h3.645zm5.634 4.134a2.061 2.061 0 0 0-1.969 1.336 1.963 1.963 0 0 1 2.343-.739c.396.161.917.422 1.33.283a2.1 2.1 0 0 0-1.704-.88zm3.39 1.061c-.375-.13-.8-.277-1.109-.681-.06-.08-.116-.17-.176-.265a2.143 2.143 0 0 0-.533-.642c-.294-.216-.68-.322-1.18-.322a2.482 2.482 0 0 0-2.294 1.536 2.325 2.325 0 0 1 4.002.388.75.75 0 0 0 .836.334c.493-.105.46.36 1.203.518v-.133c-.003-.446-.246-.55-.75-.733zm2.024 1.266a.723.723 0 0 0 .347-.638c-.01-2.957-2.41-5.487-5.37-5.487a5.364 5.364 0 0 0-4.487 2.418c-.01-.026-1.522-2.39-1.538-2.418H8.943l3.463 5.423-3.379 5.32h3.54l1.54-2.366 1.568 2.366h3.541l-3.21-5.052a.7.7 0 0 1-.084-.32 2.69 2.69 0 0 1 2.69-2.691h.001c1.488 0 1.736.89 2.057 1.308.634.826 1.9.464 1.9 1.541a.707.707 0 0 0 1.066.596zm.35.133c-.173.372-.56.338-.755.639-.176.271.114.412.114.412s.337.156.538-.311c.104-.231.14-.488.103-.74z"/></svg>

astro-docs/public/img/nx.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Nx</title><path d="M11.987 14.138l-3.132 4.923-5.193-8.427-.012 8.822H0V4.544h3.691l5.247 8.833.005-3.998 3.044 4.759zm.601-5.761c.024-.048 0-3.784.008-3.833h-3.65c.002.059-.005 3.776-.003 3.833h3.645zm5.634 4.134a2.061 2.061 0 0 0-1.969 1.336 1.963 1.963 0 0 1 2.343-.739c.396.161.917.422 1.33.283a2.1 2.1 0 0 0-1.704-.88zm3.39 1.061c-.375-.13-.8-.277-1.109-.681-.06-.08-.116-.17-.176-.265a2.143 2.143 0 0 0-.533-.642c-.294-.216-.68-.322-1.18-.322a2.482 2.482 0 0 0-2.294 1.536 2.325 2.325 0 0 1 4.002.388.75.75 0 0 0 .836.334c.493-.105.46.36 1.203.518v-.133c-.003-.446-.246-.55-.75-.733zm2.024 1.266a.723.723 0 0 0 .347-.638c-.01-2.957-2.41-5.487-5.37-5.487a5.364 5.364 0 0 0-4.487 2.418c-.01-.026-1.522-2.39-1.538-2.418H8.943l3.463 5.423-3.379 5.32h3.54l1.54-2.366 1.568 2.366h3.541l-3.21-5.052a.7.7 0 0 1-.084-.32 2.69 2.69 0 0 1 2.69-2.691h.001c1.488 0 1.736.89 2.057 1.308.634.826 1.9.464 1.9 1.541a.707.707 0 0 0 1.066.596zm.35.133c-.173.372-.56.338-.755.639-.176.271.114.412.114.412s.337.156.538-.311c.104-.231.14-.488.103-.74z"/></svg>

astro-docs/public/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://<YOUR SITE>/sitemap-index.xml

astro-docs/src/assets/nx-cloud/nx_cloud-dark.svg

@@ -0,0 +1,3 @@
+<svg width="508" height="508" viewBox="0 0 508 508" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M404 179V141.5C404 120.8 387.2 104 366.5 104H141.5C120.8 104 104 120.8 104 141.5V366.5C104 387.2 120.8 404 141.5 404H179M404 179C362.6 179 329 212.6 329 254C329 295.4 295.4 329 254 329C212.6 329 179 362.6 179 404M404 179V365.364C404 386.691 386.691 404 365.364 404L179 404" stroke="#0A1A2D" stroke-width="36"/>
+</svg>

astro-docs/src/assets/nx-cloud/nx_cloud-light.svg

@@ -0,0 +1,3 @@
+<svg width="508" height="508" viewBox="0 0 508 508" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M404 179V141.5C404 120.8 387.2 104 366.5 104H141.5C120.8 104 104 120.8 104 141.5V366.5C104 387.2 120.8 404 141.5 404H179M404 179C362.6 179 329 212.6 329 254C329 295.4 295.4 329 254 329C212.6 329 179 362.6 179 404M404 179V365.364C404 386.691 386.691 404 365.364 404L179 404" stroke="white" stroke-width="36"/>
+</svg>

astro-docs/src/assets/nx-cloud/nx_cloud_wtitle-dark.svg

@@ -0,0 +1,17 @@
+<svg width="172" height="39" viewBox="0 0 172 39" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_301_3)">
+<path d="M69.6733 9.27841V29.642H66.8494L56.4985 14.7074H56.3096V29.642H53.2372V9.27841H56.0809L66.4417 24.233H66.6306V9.27841H69.6733Z" fill="#0F172A"/>
+<path d="M76.2631 14.3693L79.6338 20.3153L83.0344 14.3693H86.2858L81.523 22.0057L86.3256 29.642H83.0742L79.6338 23.9347L76.2034 29.642H72.9421L77.6949 22.0057L73.0017 14.3693H76.2631Z" fill="#0F172A"/>
+<path d="M113.901 15.9006H110.798C110.679 15.2377 110.457 14.6544 110.132 14.1506C109.807 13.6468 109.41 13.2192 108.939 12.8679C108.468 12.5166 107.941 12.2514 107.358 12.0724C106.781 11.8935 106.168 11.804 105.518 11.804C104.345 11.804 103.294 12.099 102.366 12.6889C101.445 13.2789 100.716 14.1439 100.179 15.2841C99.6486 16.4242 99.3835 17.8163 99.3835 19.4602C99.3835 21.1174 99.6486 22.5161 100.179 23.6562C100.716 24.7964 101.448 25.6581 102.376 26.2415C103.304 26.8248 104.348 27.1165 105.508 27.1165C106.151 27.1165 106.761 27.0303 107.338 26.858C107.921 26.679 108.448 26.4171 108.919 26.0724C109.39 25.7277 109.787 25.3068 110.112 24.8097C110.444 24.3059 110.672 23.7292 110.798 23.0795L113.901 23.0895C113.735 24.0904 113.413 25.0118 112.936 25.8537C112.465 26.6889 111.859 27.4115 111.116 28.0213C110.381 28.6245 109.539 29.0919 108.591 29.4233C107.643 29.7547 106.609 29.9205 105.489 29.9205C103.725 29.9205 102.154 29.5028 100.776 28.6676C99.3967 27.8258 98.3096 26.6226 97.5142 25.0582C96.7253 23.4938 96.3309 21.6278 96.3309 19.4602C96.3309 17.286 96.7287 15.42 97.5241 13.8622C98.3196 12.2978 99.4067 11.098 100.785 10.2628C102.164 9.42093 103.732 9 105.489 9C106.569 9 107.577 9.15578 108.511 9.46733C109.453 9.77225 110.298 10.223 111.047 10.8196C111.796 11.4096 112.416 12.1321 112.906 12.9872C113.397 13.8357 113.728 14.8068 113.901 15.9006Z" fill="#0F172A"/>
+<path d="M120.311 9.27841V29.642H117.338V9.27841H120.311Z" fill="#0F172A"/>
+<path d="M130.744 29.9503C129.312 29.9503 128.063 29.6222 126.996 28.9659C125.928 28.3097 125.1 27.3916 124.51 26.2116C123.92 25.0317 123.625 23.6529 123.625 22.0753C123.625 20.491 123.92 19.1056 124.51 17.919C125.1 16.7325 125.928 15.8111 126.996 15.1548C128.063 14.4986 129.312 14.1705 130.744 14.1705C132.176 14.1705 133.426 14.4986 134.493 15.1548C135.56 15.8111 136.389 16.7325 136.979 17.919C137.569 19.1056 137.864 20.491 137.864 22.0753C137.864 23.6529 137.569 25.0317 136.979 26.2116C136.389 27.3916 135.56 28.3097 134.493 28.9659C133.426 29.6222 132.176 29.9503 130.744 29.9503ZM130.754 27.4545C131.682 27.4545 132.451 27.2093 133.061 26.7188C133.671 26.2282 134.122 25.5753 134.413 24.7599C134.712 23.9446 134.861 23.0464 134.861 22.0653C134.861 21.0909 134.712 20.196 134.413 19.3807C134.122 18.5587 133.671 17.8991 133.061 17.402C132.451 16.9048 131.682 16.6562 130.754 16.6562C129.82 16.6562 129.044 16.9048 128.428 17.402C127.818 17.8991 127.364 18.5587 127.065 19.3807C126.774 20.196 126.628 21.0909 126.628 22.0653C126.628 23.0464 126.774 23.9446 127.065 24.7599C127.364 25.5753 127.818 26.2282 128.428 26.7188C129.044 27.2093 129.82 27.4545 130.754 27.4545Z" fill="#0F172A"/>
+<path d="M150.857 23.3082V14.3693H153.84V29.642H150.917V26.9972H150.757C150.406 27.8125 149.843 28.492 149.067 29.0355C148.298 29.5724 147.34 29.8409 146.194 29.8409C145.212 29.8409 144.344 29.6255 143.588 29.1946C142.839 28.7571 142.249 28.1108 141.819 27.2557C141.394 26.4006 141.182 25.3433 141.182 24.0838V14.3693H144.155V23.7259C144.155 24.7666 144.444 25.5952 145.02 26.2116C145.597 26.8281 146.346 27.1364 147.267 27.1364C147.824 27.1364 148.378 26.9972 148.928 26.7188C149.485 26.4403 149.945 26.0194 150.31 25.456C150.681 24.8925 150.863 24.1766 150.857 23.3082Z" fill="#0F172A"/>
+<path d="M163.552 29.9403C162.319 29.9403 161.218 29.6255 160.251 28.9957C159.29 28.3594 158.534 27.4545 157.984 26.2812C157.44 25.1013 157.168 23.6861 157.168 22.0355C157.168 20.3849 157.443 18.973 157.994 17.7997C158.55 16.6264 159.313 15.7282 160.281 15.1051C161.248 14.482 162.345 14.1705 163.572 14.1705C164.52 14.1705 165.282 14.3295 165.859 14.6477C166.442 14.9593 166.893 15.3239 167.211 15.7415C167.536 16.1591 167.788 16.527 167.967 16.8452H168.146V9.27841H171.119V29.642H168.215V27.2656H167.967C167.788 27.5904 167.529 27.9616 167.191 28.3793C166.86 28.7969 166.402 29.1615 165.819 29.473C165.236 29.7846 164.48 29.9403 163.552 29.9403ZM164.208 27.4048C165.063 27.4048 165.786 27.1795 166.376 26.7287C166.972 26.2713 167.423 25.6383 167.728 24.8295C168.04 24.0208 168.195 23.0795 168.195 22.0057C168.195 20.9451 168.043 20.017 167.738 19.2216C167.433 18.4261 166.986 17.8063 166.396 17.3622C165.806 16.9181 165.076 16.696 164.208 16.696C163.313 16.696 162.567 16.928 161.971 17.392C161.374 17.8561 160.924 18.4891 160.619 19.2912C160.32 20.0933 160.171 20.9981 160.171 22.0057C160.171 23.0265 160.324 23.9446 160.629 24.7599C160.933 25.5753 161.384 26.2216 161.981 26.6989C162.584 27.1695 163.326 27.4048 164.208 27.4048Z" fill="#0F172A"/>
+<path d="M36.7916 10.5417V6.16669C36.7916 3.75169 34.8316 1.79169 32.4166 1.79169H6.16663C3.75163 1.79169 1.79163 3.75169 1.79163 6.16669V32.4167C1.79163 34.8317 3.75163 36.7917 6.16663 36.7917H10.5416M36.7916 10.5417C31.9616 10.5417 28.0416 14.4617 28.0416 19.2917C28.0416 24.1217 24.1216 28.0417 19.2916 28.0417C14.4616 28.0417 10.5416 31.9617 10.5416 36.7917M36.7916 10.5417V32.2841C36.7916 34.7723 34.7722 36.7917 32.2841 36.7917L10.5416 36.7917" stroke="#0F172A" stroke-width="3"/>
+</g>
+<defs>
+<clipPath id="clip0_301_3">
+<rect width="172" height="39" fill="white" transform="matrix(-1 0 0 1 172 0)"/>
+</clipPath>
+</defs>
+</svg>

astro-docs/src/assets/nx-cloud/nx_cloud_wtitle-light.svg

@@ -0,0 +1,17 @@
+<svg width="172" height="39" viewBox="0 0 172 39" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_403_2)">
+<path d="M69.6733 9.27841V29.642H66.8494L56.4985 14.7074H56.3096V29.642H53.2372V9.27841H56.0809L66.4417 24.233H66.6306V9.27841H69.6733Z" fill="white"/>
+<path d="M76.2631 14.3693L79.6338 20.3153L83.0344 14.3693H86.2858L81.523 22.0057L86.3256 29.642H83.0742L79.6338 23.9347L76.2034 29.642H72.9421L77.6949 22.0057L73.0017 14.3693H76.2631Z" fill="white"/>
+<path d="M113.901 15.9006H110.798C110.679 15.2377 110.457 14.6544 110.132 14.1506C109.807 13.6468 109.41 13.2192 108.939 12.8679C108.468 12.5166 107.941 12.2514 107.358 12.0724C106.781 11.8935 106.168 11.804 105.518 11.804C104.345 11.804 103.294 12.099 102.366 12.6889C101.445 13.2789 100.716 14.1439 100.179 15.2841C99.6486 16.4242 99.3835 17.8163 99.3835 19.4602C99.3835 21.1174 99.6486 22.5161 100.179 23.6562C100.716 24.7964 101.448 25.6581 102.376 26.2415C103.304 26.8248 104.348 27.1165 105.508 27.1165C106.151 27.1165 106.761 27.0303 107.338 26.858C107.921 26.679 108.448 26.4171 108.919 26.0724C109.39 25.7277 109.787 25.3068 110.112 24.8097C110.444 24.3059 110.672 23.7292 110.798 23.0795L113.901 23.0895C113.735 24.0904 113.413 25.0118 112.936 25.8537C112.465 26.6889 111.859 27.4115 111.116 28.0213C110.381 28.6245 109.539 29.0919 108.591 29.4233C107.643 29.7547 106.609 29.9205 105.489 29.9205C103.725 29.9205 102.154 29.5028 100.776 28.6676C99.3967 27.8258 98.3096 26.6226 97.5142 25.0582C96.7253 23.4938 96.3309 21.6278 96.3309 19.4602C96.3309 17.286 96.7287 15.42 97.5241 13.8622C98.3196 12.2978 99.4067 11.098 100.785 10.2628C102.164 9.42093 103.732 9 105.489 9C106.569 9 107.577 9.15578 108.511 9.46733C109.453 9.77225 110.298 10.223 111.047 10.8196C111.796 11.4096 112.416 12.1321 112.906 12.9872C113.397 13.8357 113.728 14.8068 113.901 15.9006Z" fill="white"/>
+<path d="M120.311 9.27841V29.642H117.338V9.27841H120.311Z" fill="white"/>
+<path d="M130.744 29.9503C129.312 29.9503 128.063 29.6222 126.996 28.9659C125.928 28.3097 125.1 27.3916 124.51 26.2116C123.92 25.0317 123.625 23.6529 123.625 22.0753C123.625 20.491 123.92 19.1056 124.51 17.919C125.1 16.7325 125.928 15.8111 126.996 15.1548C128.063 14.4986 129.312 14.1705 130.744 14.1705C132.176 14.1705 133.426 14.4986 134.493 15.1548C135.56 15.8111 136.389 16.7325 136.979 17.919C137.569 19.1056 137.864 20.491 137.864 22.0753C137.864 23.6529 137.569 25.0317 136.979 26.2116C136.389 27.3916 135.56 28.3097 134.493 28.9659C133.426 29.6222 132.176 29.9503 130.744 29.9503ZM130.754 27.4545C131.682 27.4545 132.451 27.2093 133.061 26.7188C133.671 26.2282 134.122 25.5753 134.413 24.7599C134.712 23.9446 134.861 23.0464 134.861 22.0653C134.861 21.0909 134.712 20.196 134.413 19.3807C134.122 18.5587 133.671 17.8991 133.061 17.402C132.451 16.9048 131.682 16.6562 130.754 16.6562C129.82 16.6562 129.044 16.9048 128.428 17.402C127.818 17.8991 127.364 18.5587 127.065 19.3807C126.774 20.196 126.628 21.0909 126.628 22.0653C126.628 23.0464 126.774 23.9446 127.065 24.7599C127.364 25.5753 127.818 26.2282 128.428 26.7188C129.044 27.2093 129.82 27.4545 130.754 27.4545Z" fill="white"/>
+<path d="M150.857 23.3082V14.3693H153.84V29.642H150.917V26.9972H150.757C150.406 27.8125 149.843 28.492 149.067 29.0355C148.298 29.5724 147.34 29.8409 146.194 29.8409C145.212 29.8409 144.344 29.6255 143.588 29.1946C142.839 28.7571 142.249 28.1108 141.819 27.2557C141.394 26.4006 141.182 25.3433 141.182 24.0838V14.3693H144.155V23.7259C144.155 24.7666 144.444 25.5952 145.02 26.2116C145.597 26.8281 146.346 27.1364 147.267 27.1364C147.824 27.1364 148.378 26.9972 148.928 26.7188C149.485 26.4403 149.945 26.0194 150.31 25.456C150.681 24.8925 150.863 24.1766 150.857 23.3082Z" fill="white"/>
+<path d="M163.552 29.9403C162.319 29.9403 161.218 29.6255 160.251 28.9957C159.29 28.3594 158.534 27.4545 157.984 26.2812C157.44 25.1013 157.168 23.6861 157.168 22.0355C157.168 20.3849 157.443 18.973 157.994 17.7997C158.55 16.6264 159.313 15.7282 160.281 15.1051C161.248 14.482 162.345 14.1705 163.572 14.1705C164.52 14.1705 165.282 14.3295 165.859 14.6477C166.442 14.9593 166.893 15.3239 167.211 15.7415C167.536 16.1591 167.788 16.527 167.967 16.8452H168.146V9.27841H171.119V29.642H168.215V27.2656H167.967C167.788 27.5904 167.529 27.9616 167.191 28.3793C166.86 28.7969 166.402 29.1615 165.819 29.473C165.236 29.7846 164.48 29.9403 163.552 29.9403ZM164.208 27.4048C165.063 27.4048 165.786 27.1795 166.376 26.7287C166.972 26.2713 167.423 25.6383 167.728 24.8295C168.04 24.0208 168.195 23.0795 168.195 22.0057C168.195 20.9451 168.043 20.017 167.738 19.2216C167.433 18.4261 166.986 17.8063 166.396 17.3622C165.806 16.9181 165.076 16.696 164.208 16.696C163.313 16.696 162.567 16.928 161.971 17.392C161.374 17.8561 160.924 18.4891 160.619 19.2912C160.32 20.0933 160.171 20.9981 160.171 22.0057C160.171 23.0265 160.324 23.9446 160.629 24.7599C160.933 25.5753 161.384 26.2216 161.981 26.6989C162.584 27.1695 163.326 27.4048 164.208 27.4048Z" fill="white"/>
+<path d="M36.7916 10.5417V6.16669C36.7916 3.75169 34.8316 1.79169 32.4166 1.79169H6.16663C3.75163 1.79169 1.79163 3.75169 1.79163 6.16669V32.4167C1.79163 34.8317 3.75163 36.7917 6.16663 36.7917H10.5416M36.7916 10.5417C31.9616 10.5417 28.0416 14.4617 28.0416 19.2917C28.0416 24.1217 24.1216 28.0417 19.2916 28.0417C14.4616 28.0417 10.5416 31.9617 10.5416 36.7917M36.7916 10.5417V32.2841C36.7916 34.7723 34.7722 36.7917 32.2841 36.7917L10.5416 36.7917" stroke="white" stroke-width="3"/>
+</g>
+<defs>
+<clipPath id="clip0_403_2">
+<rect width="172" height="39" fill="white" transform="matrix(-1 0 0 1 172 0)"/>
+</clipPath>
+</defs>
+</svg>

astro-docs/src/assets/nx-console/NxConsole-dark.svg

@@ -0,0 +1,10 @@
+<svg width="344" height="221" viewBox="0 0 344 221" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M43.3535 191.192C40.8271 191.192 38.5414 190.639 36.4963 189.532C34.4752 188.401 32.8872 186.861 31.7323 184.912C30.5774 182.939 30 180.726 30 178.272C30 175.818 30.5774 173.616 31.7323 171.667C32.8872 169.694 34.4872 168.154 36.5324 167.048C38.5775 165.917 40.8632 165.351 43.3896 165.351C45.3625 165.351 47.167 165.688 48.8031 166.362C50.4392 167.011 51.8347 167.986 52.9896 169.285L50.6437 171.559C48.743 169.562 46.373 168.563 43.5339 168.563C41.6572 168.563 39.961 168.984 38.4452 169.827C36.9294 170.669 35.7384 171.836 34.8722 173.327C34.0301 174.795 33.609 176.443 33.609 178.272C33.609 180.1 34.0301 181.76 34.8722 183.252C35.7384 184.72 36.9294 185.875 38.4452 186.717C39.961 187.559 41.6572 187.98 43.5339 187.98C46.349 187.98 48.7189 186.969 50.6437 184.948L52.9896 187.222C51.8347 188.521 50.4272 189.508 48.767 190.182C47.1309 190.855 45.3264 191.192 43.3535 191.192Z" fill="#143055"/>
+<path d="M85.9766 191.192C83.4262 191.192 81.1284 190.639 79.0833 189.532C77.0382 188.401 75.4261 186.849 74.2472 184.876C73.0923 182.903 72.5148 180.702 72.5148 178.272C72.5148 175.842 73.0923 173.64 74.2472 171.667C75.4261 169.694 77.0382 168.154 79.0833 167.048C81.1284 165.917 83.4262 165.351 85.9766 165.351C88.5029 165.351 90.7886 165.917 92.8338 167.048C94.8789 168.154 96.4789 169.694 97.6338 171.667C98.7887 173.616 99.3661 175.818 99.3661 178.272C99.3661 180.726 98.7887 182.939 97.6338 184.912C96.4789 186.861 94.8789 188.401 92.8338 189.532C90.7886 190.639 88.5029 191.192 85.9766 191.192ZM85.9766 187.98C87.8292 187.98 89.4894 187.559 90.957 186.717C92.4488 185.875 93.6157 184.72 94.4578 183.252C95.324 181.76 95.7571 180.1 95.7571 178.272C95.7571 176.443 95.324 174.795 94.4578 173.327C93.6157 171.836 92.4488 170.669 90.957 169.827C89.4894 168.984 87.8292 168.563 85.9766 168.563C84.1239 168.563 82.4397 168.984 80.9239 169.827C79.4322 170.669 78.2532 171.836 77.387 173.327C76.5449 174.795 76.1239 176.443 76.1239 178.272C76.1239 180.1 76.5449 181.76 77.387 183.252C78.2532 184.72 79.4322 185.875 80.9239 186.717C82.4397 187.559 84.1239 187.98 85.9766 187.98Z" fill="#143055"/>
+<path d="M143.571 165.64V190.903H140.612L125.454 172.064V190.903H121.845V165.64H124.804L139.962 184.479V165.64H143.571Z" fill="#143055"/>
+<path d="M175.458 191.192C173.557 191.192 171.717 190.903 169.936 190.326C168.18 189.724 166.796 188.954 165.786 188.016L167.121 185.201C168.084 186.067 169.311 186.777 170.802 187.33C172.318 187.86 173.87 188.124 175.458 188.124C177.551 188.124 179.115 187.776 180.15 187.078C181.184 186.356 181.702 185.406 181.702 184.227C181.702 183.36 181.413 182.663 180.836 182.133C180.282 181.58 179.584 181.159 178.742 180.87C177.924 180.581 176.757 180.257 175.241 179.896C173.341 179.439 171.801 178.981 170.622 178.524C169.467 178.067 168.469 177.369 167.626 176.431C166.808 175.469 166.399 174.181 166.399 172.569C166.399 171.222 166.748 170.007 167.446 168.924C168.168 167.842 169.25 166.975 170.694 166.326C172.138 165.676 173.93 165.351 176.072 165.351C177.563 165.351 179.031 165.544 180.475 165.929C181.918 166.314 183.157 166.867 184.192 167.589L183.001 170.476C181.942 169.802 180.811 169.297 179.608 168.96C178.405 168.599 177.226 168.419 176.072 168.419C174.026 168.419 172.487 168.792 171.452 169.538C170.441 170.284 169.936 171.246 169.936 172.425C169.936 173.291 170.225 174.001 170.802 174.554C171.38 175.084 172.09 175.505 172.932 175.818C173.798 176.106 174.965 176.419 176.432 176.756C178.333 177.213 179.861 177.67 181.016 178.127C182.171 178.584 183.157 179.282 183.975 180.221C184.817 181.159 185.239 182.422 185.239 184.01C185.239 185.333 184.878 186.548 184.156 187.655C183.434 188.738 182.339 189.604 180.872 190.254C179.404 190.879 177.599 191.192 175.458 191.192Z" fill="#143055"/>
+<path d="M218.878 191.192C216.328 191.192 214.03 190.639 211.985 189.532C209.94 188.401 208.328 186.849 207.149 184.876C205.994 182.903 205.416 180.702 205.416 178.272C205.416 175.842 205.994 173.64 207.149 171.667C208.328 169.694 209.94 168.154 211.985 167.048C214.03 165.917 216.328 165.351 218.878 165.351C221.405 165.351 223.69 165.917 225.735 167.048C227.781 168.154 229.381 169.694 230.535 171.667C231.69 173.616 232.268 175.818 232.268 178.272C232.268 180.726 231.69 182.939 230.535 184.912C229.381 186.861 227.781 188.401 225.735 189.532C223.69 190.639 221.405 191.192 218.878 191.192ZM218.878 187.98C220.731 187.98 222.391 187.559 223.859 186.717C225.35 185.875 226.517 184.72 227.359 183.252C228.226 181.76 228.659 180.1 228.659 178.272C228.659 176.443 228.226 174.795 227.359 173.327C226.517 171.836 225.35 170.669 223.859 169.827C222.391 168.984 220.731 168.563 218.878 168.563C217.026 168.563 215.341 168.984 213.826 169.827C212.334 170.669 211.155 171.836 210.289 173.327C209.447 174.795 209.026 176.443 209.026 178.272C209.026 180.1 209.447 181.76 210.289 183.252C211.155 184.72 212.334 185.875 213.826 186.717C215.341 187.559 217.026 187.98 218.878 187.98Z" fill="#143055"/>
+<path d="M254.747 165.64H258.356V187.763H272.034V190.903H254.747V165.64Z" fill="#143055"/>
+<path d="M311.472 187.763V190.903H293.138V165.64H310.966V168.78H296.747V176.539H309.414V179.607H296.747V187.763H311.472Z" fill="#143055"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M54.4936 30H30.2225V127.745H59.4859V79.9321L99.0949 127.745H123.366V30H94.1026V77.8129L54.4936 30ZM33.2301 124.737V33.0075H53.0796L97.1102 86.1577V33.0075H120.358V124.737H100.509L56.4783 71.5873V124.737H33.2301ZM153.172 30H186.673L220.749 78.3213L186.683 127.745H151.648L187.249 78.3219L153.172 30ZM158.973 33.0075L190.942 78.3404L157.521 124.737H185.103L217.083 78.341L185.113 33.0075H158.973ZM243.307 108.196H313.984V127.745H243.307V108.196ZM246.314 111.204V124.737H310.976V111.204H246.314Z" fill="#143055"/>
+</svg>

astro-docs/src/assets/nx-console/NxConsole-light.svg

@@ -0,0 +1,10 @@
+<svg width="344" height="221" viewBox="0 0 344 221" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M43.3535 191.192C40.8271 191.192 38.5414 190.639 36.4963 189.532C34.4752 188.401 32.8872 186.861 31.7323 184.912C30.5774 182.939 30 180.726 30 178.272C30 175.818 30.5774 173.616 31.7323 171.667C32.8872 169.694 34.4872 168.154 36.5324 167.048C38.5775 165.917 40.8632 165.351 43.3896 165.351C45.3625 165.351 47.167 165.688 48.8031 166.362C50.4392 167.011 51.8347 167.986 52.9896 169.285L50.6437 171.559C48.743 169.562 46.373 168.563 43.5339 168.563C41.6572 168.563 39.961 168.984 38.4452 169.827C36.9294 170.669 35.7384 171.836 34.8722 173.327C34.0301 174.795 33.609 176.443 33.609 178.272C33.609 180.1 34.0301 181.76 34.8722 183.252C35.7384 184.72 36.9294 185.875 38.4452 186.717C39.961 187.559 41.6572 187.98 43.5339 187.98C46.349 187.98 48.7189 186.969 50.6437 184.948L52.9896 187.222C51.8347 188.521 50.4272 189.508 48.767 190.182C47.1309 190.855 45.3264 191.192 43.3535 191.192Z" fill="white"/>
+<path d="M85.9766 191.192C83.4262 191.192 81.1284 190.639 79.0833 189.532C77.0382 188.401 75.4261 186.849 74.2472 184.876C73.0923 182.903 72.5148 180.702 72.5148 178.272C72.5148 175.842 73.0923 173.64 74.2472 171.667C75.4261 169.694 77.0382 168.154 79.0833 167.048C81.1284 165.917 83.4262 165.351 85.9766 165.351C88.5029 165.351 90.7886 165.917 92.8338 167.048C94.8789 168.154 96.4789 169.694 97.6338 171.667C98.7887 173.616 99.3661 175.818 99.3661 178.272C99.3661 180.726 98.7887 182.939 97.6338 184.912C96.4789 186.861 94.8789 188.401 92.8338 189.532C90.7886 190.639 88.5029 191.192 85.9766 191.192ZM85.9766 187.98C87.8292 187.98 89.4894 187.559 90.957 186.717C92.4488 185.875 93.6157 184.72 94.4578 183.252C95.324 181.76 95.7571 180.1 95.7571 178.272C95.7571 176.443 95.324 174.795 94.4578 173.327C93.6157 171.836 92.4488 170.669 90.957 169.827C89.4894 168.984 87.8292 168.563 85.9766 168.563C84.1239 168.563 82.4397 168.984 80.9239 169.827C79.4322 170.669 78.2532 171.836 77.387 173.327C76.5449 174.795 76.1239 176.443 76.1239 178.272C76.1239 180.1 76.5449 181.76 77.387 183.252C78.2532 184.72 79.4322 185.875 80.9239 186.717C82.4397 187.559 84.1239 187.98 85.9766 187.98Z" fill="white"/>
+<path d="M143.571 165.64V190.903H140.612L125.454 172.064V190.903H121.845V165.64H124.804L139.962 184.479V165.64H143.571Z" fill="white"/>
+<path d="M175.458 191.192C173.557 191.192 171.717 190.903 169.936 190.326C168.18 189.724 166.796 188.954 165.786 188.016L167.121 185.201C168.084 186.067 169.311 186.777 170.802 187.33C172.318 187.86 173.87 188.124 175.458 188.124C177.551 188.124 179.115 187.776 180.15 187.078C181.184 186.356 181.702 185.406 181.702 184.227C181.702 183.36 181.413 182.663 180.836 182.133C180.282 181.58 179.584 181.159 178.742 180.87C177.924 180.581 176.757 180.257 175.241 179.896C173.341 179.439 171.801 178.981 170.622 178.524C169.467 178.067 168.469 177.369 167.626 176.431C166.808 175.469 166.399 174.181 166.399 172.569C166.399 171.222 166.748 170.007 167.446 168.924C168.168 167.842 169.25 166.975 170.694 166.326C172.138 165.676 173.93 165.351 176.072 165.351C177.563 165.351 179.031 165.544 180.475 165.929C181.918 166.314 183.157 166.867 184.192 167.589L183.001 170.476C181.942 169.802 180.811 169.297 179.608 168.96C178.405 168.599 177.226 168.419 176.072 168.419C174.026 168.419 172.487 168.792 171.452 169.538C170.441 170.284 169.936 171.246 169.936 172.425C169.936 173.291 170.225 174.001 170.802 174.554C171.38 175.084 172.09 175.505 172.932 175.818C173.798 176.106 174.965 176.419 176.432 176.756C178.333 177.213 179.861 177.67 181.016 178.127C182.171 178.584 183.157 179.282 183.975 180.221C184.817 181.159 185.239 182.422 185.239 184.01C185.239 185.333 184.878 186.548 184.156 187.655C183.434 188.738 182.339 189.604 180.872 190.254C179.404 190.879 177.599 191.192 175.458 191.192Z" fill="white"/>
+<path d="M218.878 191.192C216.328 191.192 214.03 190.639 211.985 189.532C209.94 188.401 208.328 186.849 207.149 184.876C205.994 182.903 205.416 180.702 205.416 178.272C205.416 175.842 205.994 173.64 207.149 171.667C208.328 169.694 209.94 168.154 211.985 167.048C214.03 165.917 216.328 165.351 218.878 165.351C221.405 165.351 223.69 165.917 225.735 167.048C227.781 168.154 229.381 169.694 230.535 171.667C231.69 173.616 232.268 175.818 232.268 178.272C232.268 180.726 231.69 182.939 230.535 184.912C229.381 186.861 227.781 188.401 225.735 189.532C223.69 190.639 221.405 191.192 218.878 191.192ZM218.878 187.98C220.731 187.98 222.391 187.559 223.859 186.717C225.35 185.875 226.517 184.72 227.359 183.252C228.226 181.76 228.659 180.1 228.659 178.272C228.659 176.443 228.226 174.795 227.359 173.327C226.517 171.836 225.35 170.669 223.859 169.827C222.391 168.984 220.731 168.563 218.878 168.563C217.026 168.563 215.341 168.984 213.826 169.827C212.334 170.669 211.155 171.836 210.289 173.327C209.447 174.795 209.026 176.443 209.026 178.272C209.026 180.1 209.447 181.76 210.289 183.252C211.155 184.72 212.334 185.875 213.826 186.717C215.341 187.559 217.026 187.98 218.878 187.98Z" fill="white"/>
+<path d="M254.747 165.64H258.356V187.763H272.034V190.903H254.747V165.64Z" fill="white"/>
+<path d="M311.472 187.763V190.903H293.138V165.64H310.966V168.78H296.747V176.539H309.414V179.607H296.747V187.763H311.472Z" fill="white"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M54.4937 30H30.2227V127.745H59.486V79.9321L99.095 127.745H123.366V30H94.1028V77.8129L54.4937 30ZM33.2302 124.737V33.0075H53.0797L97.1103 86.1577V33.0075H120.359V124.737H100.509L56.4785 71.5873V124.737H33.2302ZM153.173 30H186.673L220.749 78.3213L186.683 127.745H151.648L187.249 78.3219L153.173 30ZM158.974 33.0075L190.942 78.3404L157.521 124.737H185.103L217.083 78.341L185.114 33.0075H158.974ZM243.307 108.196H313.984V127.745H243.307V108.196ZM246.314 111.204V124.737H310.976V111.204H246.314Z" fill="white"/>
+</svg>

astro-docs/src/assets/nx-console/NxConsole_Horizontal-dark.svg

@@ -0,0 +1,10 @@
+<svg width="536" height="97" viewBox="0 0 536 97" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M40.9208 30H30V66.6005H43.5953V53.8792L54.1338 66.6005H65.0547V30H51.4593V42.7212L40.9208 30ZM93.7248 30H77.8642L90.6309 48.1037L77.307 66.6005H93.7411L106.491 48.1028L93.7248 30ZM32.8504 63.7501V32.8504H39.5807L54.3097 50.6301V32.8504H62.2043V63.7501H55.4739L40.7449 45.9704V63.7501H32.8504ZM94.1312 48.1212L83.3622 32.8504H92.2471L103.016 48.1214L92.2439 63.7501H82.8731L94.1312 48.1212ZM142 56.2685H114.492V66.6005H142V56.2685ZM117.343 63.7501V59.1189H139.15V63.7501H117.343Z" fill="#143055"/>
+<path d="M186.568 67.2486C182.943 67.2486 179.664 66.4546 176.729 64.8665C173.829 63.2439 171.551 61.0345 169.894 58.2381C168.237 55.4072 167.408 52.2311 167.408 48.7097C167.408 45.1883 168.237 42.0295 169.894 39.2331C171.551 36.4022 173.847 34.1927 176.781 32.6047C179.715 30.9821 182.995 30.1708 186.62 30.1708C189.451 30.1708 192.04 30.6541 194.388 31.6207C196.735 32.5529 198.738 33.9511 200.395 35.8153L197.029 39.0777C194.301 36.2123 190.901 34.7796 186.827 34.7796C184.134 34.7796 181.701 35.3838 179.526 36.5921C177.351 37.8004 175.642 39.4748 174.399 41.6152C173.191 43.7211 172.586 46.0859 172.586 48.7097C172.586 51.3335 173.191 53.7156 174.399 55.856C175.642 57.9619 177.351 59.619 179.526 60.8273C181.701 62.0356 184.134 62.6398 186.827 62.6398C190.866 62.6398 194.267 61.1898 197.029 58.2899L200.395 61.5523C198.738 63.4166 196.718 64.832 194.336 65.7987C191.988 66.7653 189.399 67.2486 186.568 67.2486Z" fill="#143055"/>
+<path d="M236.852 67.2486C233.192 67.2486 229.895 66.4546 226.961 64.8665C224.026 63.2439 221.713 61.0172 220.022 58.1863C218.365 55.3554 217.536 52.1965 217.536 48.7097C217.536 45.2229 218.365 42.064 220.022 39.2331C221.713 36.4022 224.026 34.1927 226.961 32.6047C229.895 30.9821 233.192 30.1708 236.852 30.1708C240.477 30.1708 243.756 30.9821 246.691 32.6047C249.625 34.1927 251.921 36.4022 253.578 39.2331C255.235 42.0295 256.064 45.1883 256.064 48.7097C256.064 52.2311 255.235 55.4072 253.578 58.2381C251.921 61.0345 249.625 63.2439 246.691 64.8665C243.756 66.4546 240.477 67.2486 236.852 67.2486ZM236.852 62.6398C239.51 62.6398 241.892 62.0356 243.998 60.8273C246.138 59.619 247.813 57.9619 249.021 55.856C250.264 53.7156 250.885 51.3335 250.885 48.7097C250.885 46.0859 250.264 43.7211 249.021 41.6152C247.813 39.4748 246.138 37.8004 243.998 36.5921C241.892 35.3838 239.51 34.7796 236.852 34.7796C234.193 34.7796 231.777 35.3838 229.602 36.5921C227.461 37.8004 225.77 39.4748 224.527 41.6152C223.319 43.7211 222.714 46.0859 222.714 48.7097C222.714 51.3335 223.319 53.7156 224.527 55.856C225.77 57.9619 227.461 59.619 229.602 60.8273C231.777 62.0356 234.193 62.6398 236.852 62.6398Z" fill="#143055"/>
+<path d="M308.617 30.5851V66.8344H304.371L282.621 39.8027V66.8344H277.443V30.5851H281.689L303.439 57.6167V30.5851H308.617Z" fill="#143055"/>
+<path d="M343.495 67.2486C340.768 67.2486 338.127 66.8344 335.572 66.0058C333.052 65.1427 331.067 64.038 329.617 62.6916L331.533 58.6524C332.914 59.8952 334.675 60.9136 336.815 61.7077C338.99 62.4672 341.217 62.8469 343.495 62.8469C346.499 62.8469 348.743 62.3463 350.227 61.3452C351.712 60.3095 352.454 58.9458 352.454 57.2542C352.454 56.0113 352.04 55.0102 351.211 54.2507C350.417 53.4566 349.416 52.8525 348.208 52.4382C347.034 52.0239 345.36 51.5579 343.185 51.04C340.457 50.3841 338.248 49.7281 336.556 49.0722C334.899 48.4163 333.466 47.4151 332.258 46.0687C331.084 44.6878 330.497 42.8408 330.497 40.5277C330.497 38.5944 330.998 36.851 331.999 35.2975C333.035 33.7439 334.588 32.5011 336.66 31.569C338.731 30.6368 341.303 30.1708 344.376 30.1708C346.516 30.1708 348.622 30.447 350.693 30.9993C352.765 31.5517 354.543 32.3457 356.027 33.3814L354.318 37.5242C352.799 36.5576 351.177 35.8326 349.451 35.3492C347.724 34.8314 346.033 34.5725 344.376 34.5725C341.441 34.5725 339.232 35.1076 337.747 36.1778C336.297 37.248 335.572 38.6289 335.572 40.3206C335.572 41.5634 335.987 42.5818 336.815 43.3759C337.644 44.1354 338.662 44.7395 339.87 45.1883C341.113 45.6026 342.788 46.0514 344.894 46.5347C347.621 47.1907 349.813 47.8466 351.47 48.5026C353.127 49.1585 354.543 50.1597 355.717 51.5061C356.925 52.8525 357.529 54.6649 357.529 56.9435C357.529 58.8422 357.011 60.5857 355.976 62.1737C354.94 63.7273 353.369 64.9701 351.263 65.9022C349.157 66.7998 346.568 67.2486 343.495 67.2486Z" fill="#143055"/>
+<path d="M394.922 67.2486C391.263 67.2486 387.966 66.4546 385.032 64.8665C382.097 63.2439 379.784 61.0172 378.092 58.1863C376.435 55.3554 375.607 52.1965 375.607 48.7097C375.607 45.2229 376.435 42.064 378.092 39.2331C379.784 36.4022 382.097 34.1927 385.032 32.6047C387.966 30.9821 391.263 30.1708 394.922 30.1708C398.547 30.1708 401.827 30.9821 404.762 32.6047C407.696 34.1927 409.992 36.4022 411.649 39.2331C413.306 42.0295 414.135 45.1883 414.135 48.7097C414.135 52.2311 413.306 55.4072 411.649 58.2381C409.992 61.0345 407.696 63.2439 404.762 64.8665C401.827 66.4546 398.547 67.2486 394.922 67.2486ZM394.922 62.6398C397.581 62.6398 399.963 62.0356 402.069 60.8273C404.209 59.619 405.884 57.9619 407.092 55.856C408.335 53.7156 408.956 51.3335 408.956 48.7097C408.956 46.0859 408.335 43.7211 407.092 41.6152C405.884 39.4748 404.209 37.8004 402.069 36.5921C399.963 35.3838 397.581 34.7796 394.922 34.7796C392.264 34.7796 389.848 35.3838 387.673 36.5921C385.532 37.8004 383.841 39.4748 382.598 41.6152C381.389 43.7211 380.785 46.0859 380.785 48.7097C380.785 51.3335 381.389 53.7156 382.598 55.856C383.841 57.9619 385.532 59.619 387.673 60.8273C389.848 62.0356 392.264 62.6398 394.922 62.6398Z" fill="#143055"/>
+<path d="M435.514 30.5851H440.692V62.3291H460.318V66.8344H435.514V30.5851Z" fill="#143055"/>
+<path d="M506.031 62.3291V66.8344H479.725V30.5851H505.306V35.0903H484.903V46.224H503.08V50.6257H484.903V62.3291H506.031Z" fill="#143055"/>
+</svg>

astro-docs/src/assets/nx-console/NxConsole_Horizontal-light.svg

@@ -0,0 +1,10 @@
+<svg width="536" height="97" viewBox="0 0 536 97" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M40.9208 30H30V66.6005H43.5953V53.8792L54.1338 66.6005H65.0547V30H51.4593V42.7212L40.9208 30ZM93.7248 30H77.8642L90.6309 48.1037L77.307 66.6005H93.7411L106.491 48.1028L93.7248 30ZM32.8504 63.7501V32.8504H39.5807L54.3097 50.6301V32.8504H62.2043V63.7501H55.4739L40.7449 45.9704V63.7501H32.8504ZM94.1312 48.1212L83.3622 32.8504H92.2471L103.016 48.1214L92.2439 63.7501H82.8731L94.1312 48.1212ZM142 56.2685H114.492V66.6005H142V56.2685ZM117.343 63.7501V59.1189H139.15V63.7501H117.343Z" fill="white"/>
+<path d="M186.568 67.2486C182.943 67.2486 179.664 66.4546 176.729 64.8665C173.829 63.2439 171.551 61.0345 169.894 58.2381C168.237 55.4072 167.408 52.2311 167.408 48.7097C167.408 45.1883 168.237 42.0295 169.894 39.2331C171.551 36.4022 173.847 34.1927 176.781 32.6047C179.715 30.9821 182.995 30.1708 186.62 30.1708C189.451 30.1708 192.04 30.6541 194.388 31.6207C196.735 32.5529 198.738 33.9511 200.395 35.8153L197.029 39.0777C194.301 36.2123 190.901 34.7796 186.827 34.7796C184.134 34.7796 181.701 35.3838 179.526 36.5921C177.351 37.8004 175.642 39.4748 174.399 41.6152C173.191 43.7211 172.586 46.0859 172.586 48.7097C172.586 51.3335 173.191 53.7156 174.399 55.856C175.642 57.9619 177.351 59.619 179.526 60.8273C181.701 62.0356 184.134 62.6398 186.827 62.6398C190.866 62.6398 194.267 61.1898 197.029 58.2899L200.395 61.5523C198.738 63.4166 196.718 64.832 194.336 65.7987C191.988 66.7653 189.399 67.2486 186.568 67.2486Z" fill="white"/>
+<path d="M236.852 67.2486C233.192 67.2486 229.895 66.4546 226.961 64.8665C224.026 63.2439 221.713 61.0172 220.022 58.1863C218.365 55.3554 217.536 52.1965 217.536 48.7097C217.536 45.2229 218.365 42.064 220.022 39.2331C221.713 36.4022 224.026 34.1927 226.961 32.6047C229.895 30.9821 233.192 30.1708 236.852 30.1708C240.477 30.1708 243.756 30.9821 246.691 32.6047C249.625 34.1927 251.921 36.4022 253.578 39.2331C255.235 42.0295 256.064 45.1883 256.064 48.7097C256.064 52.2311 255.235 55.4072 253.578 58.2381C251.921 61.0345 249.625 63.2439 246.691 64.8665C243.756 66.4546 240.477 67.2486 236.852 67.2486ZM236.852 62.6398C239.51 62.6398 241.892 62.0356 243.998 60.8273C246.138 59.619 247.813 57.9619 249.021 55.856C250.264 53.7156 250.885 51.3335 250.885 48.7097C250.885 46.0859 250.264 43.7211 249.021 41.6152C247.813 39.4748 246.138 37.8004 243.998 36.5921C241.892 35.3838 239.51 34.7796 236.852 34.7796C234.193 34.7796 231.777 35.3838 229.602 36.5921C227.461 37.8004 225.77 39.4748 224.527 41.6152C223.319 43.7211 222.714 46.0859 222.714 48.7097C222.714 51.3335 223.319 53.7156 224.527 55.856C225.77 57.9619 227.461 59.619 229.602 60.8273C231.777 62.0356 234.193 62.6398 236.852 62.6398Z" fill="white"/>
+<path d="M308.617 30.5851V66.8344H304.371L282.621 39.8027V66.8344H277.443V30.5851H281.689L303.439 57.6167V30.5851H308.617Z" fill="white"/>
+<path d="M343.495 67.2486C340.768 67.2486 338.127 66.8344 335.572 66.0058C333.052 65.1427 331.067 64.038 329.617 62.6916L331.533 58.6524C332.914 59.8952 334.675 60.9136 336.815 61.7077C338.99 62.4672 341.217 62.8469 343.495 62.8469C346.499 62.8469 348.743 62.3463 350.227 61.3452C351.712 60.3095 352.454 58.9458 352.454 57.2542C352.454 56.0113 352.04 55.0102 351.211 54.2507C350.417 53.4566 349.416 52.8525 348.208 52.4382C347.034 52.0239 345.36 51.5579 343.185 51.04C340.457 50.3841 338.248 49.7281 336.556 49.0722C334.899 48.4163 333.466 47.4151 332.258 46.0687C331.084 44.6878 330.497 42.8408 330.497 40.5277C330.497 38.5944 330.998 36.851 331.999 35.2975C333.035 33.7439 334.588 32.5011 336.66 31.569C338.731 30.6368 341.303 30.1708 344.376 30.1708C346.516 30.1708 348.622 30.447 350.693 30.9993C352.765 31.5517 354.543 32.3457 356.027 33.3814L354.318 37.5242C352.799 36.5576 351.177 35.8326 349.451 35.3492C347.724 34.8314 346.033 34.5725 344.376 34.5725C341.441 34.5725 339.232 35.1076 337.747 36.1778C336.297 37.248 335.572 38.6289 335.572 40.3206C335.572 41.5634 335.987 42.5818 336.815 43.3759C337.644 44.1354 338.662 44.7395 339.87 45.1883C341.113 45.6026 342.788 46.0514 344.894 46.5347C347.621 47.1907 349.813 47.8466 351.47 48.5026C353.127 49.1585 354.543 50.1597 355.717 51.5061C356.925 52.8525 357.529 54.6649 357.529 56.9435C357.529 58.8422 357.011 60.5857 355.976 62.1737C354.94 63.7273 353.369 64.9701 351.263 65.9022C349.157 66.7998 346.568 67.2486 343.495 67.2486Z" fill="white"/>
+<path d="M394.922 67.2486C391.263 67.2486 387.966 66.4546 385.032 64.8665C382.097 63.2439 379.784 61.0172 378.092 58.1863C376.435 55.3554 375.607 52.1965 375.607 48.7097C375.607 45.2229 376.435 42.064 378.092 39.2331C379.784 36.4022 382.097 34.1927 385.032 32.6047C387.966 30.9821 391.263 30.1708 394.922 30.1708C398.547 30.1708 401.827 30.9821 404.762 32.6047C407.696 34.1927 409.992 36.4022 411.649 39.2331C413.306 42.0295 414.135 45.1883 414.135 48.7097C414.135 52.2311 413.306 55.4072 411.649 58.2381C409.992 61.0345 407.696 63.2439 404.762 64.8665C401.827 66.4546 398.547 67.2486 394.922 67.2486ZM394.922 62.6398C397.581 62.6398 399.963 62.0356 402.069 60.8273C404.209 59.619 405.884 57.9619 407.092 55.856C408.335 53.7156 408.956 51.3335 408.956 48.7097C408.956 46.0859 408.335 43.7211 407.092 41.6152C405.884 39.4748 404.209 37.8004 402.069 36.5921C399.963 35.3838 397.581 34.7796 394.922 34.7796C392.264 34.7796 389.848 35.3838 387.673 36.5921C385.532 37.8004 383.841 39.4748 382.598 41.6152C381.389 43.7211 380.785 46.0859 380.785 48.7097C380.785 51.3335 381.389 53.7156 382.598 55.856C383.841 57.9619 385.532 59.619 387.673 60.8273C389.848 62.0356 392.264 62.6398 394.922 62.6398Z" fill="white"/>
+<path d="M435.514 30.5851H440.692V62.3291H460.318V66.8344H435.514V30.5851Z" fill="white"/>
+<path d="M506.031 62.3291V66.8344H479.725V30.5851H505.306V35.0903H484.903V46.224H503.08V50.6257H484.903V62.3291H506.031Z" fill="white"/>
+</svg>

astro-docs/src/assets/nx/Nx-dark.svg

@@ -0,0 +1,3 @@
+<svg width="1000" height="1000" viewBox="0 0 1000 1000" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M499.651 555.512L416.132 686.623L277.653 462.192L277.333 697.143H180V300H278.426L418.345 535.244L418.479 428.768L499.651 555.512V555.512ZM515.678 402.082C516.318 400.804 515.678 301.305 515.891 300H418.559C418.612 301.571 418.425 400.564 418.479 402.082H515.678V402.082ZM665.917 512.181C654.556 511.963 643.406 515.267 634.003 521.639C624.6 528.011 617.406 537.137 613.411 547.762C620.029 537.871 629.827 530.531 641.187 526.953C652.546 523.374 664.788 523.772 675.89 528.08C686.45 532.368 700.344 539.319 711.357 535.617C706.19 528.388 699.374 522.491 691.472 518.416C683.57 514.34 674.81 512.203 665.917 512.181V512.181ZM756.316 540.438C746.317 536.976 734.983 533.061 726.743 522.301C725.143 520.17 723.65 517.774 722.05 515.244C718.48 508.669 713.651 502.86 707.837 498.145C699.997 492.393 689.704 489.57 676.37 489.57C663.264 489.573 650.454 493.463 639.563 500.745C628.673 508.028 620.193 518.376 615.197 530.477C621.53 521.672 630.067 514.682 639.954 510.206C649.84 505.73 660.73 503.925 671.535 504.971C682.339 506.017 692.679 509.878 701.52 516.168C710.362 522.457 717.395 530.955 721.917 540.811C724.168 544.503 727.558 547.366 731.578 548.97C735.598 550.574 740.031 550.832 744.21 549.706C757.357 546.909 756.476 559.294 776.29 563.501V559.959C776.21 548.081 769.73 545.312 756.29 540.438H756.316ZM810.289 574.154C813.196 572.389 815.582 569.887 817.207 566.903C818.833 563.919 819.638 560.559 819.543 557.163C819.276 478.411 755.277 411.031 676.344 411.031C652.616 411.011 629.257 416.887 608.369 428.129C587.482 439.37 569.722 455.625 556.691 475.428C556.424 474.736 516.105 411.776 515.678 411.031H418.479L510.825 555.458L420.719 697.143H515.118L556.184 634.131L597.997 697.143H692.424L606.824 562.596C605.406 559.975 604.638 557.052 604.584 554.074C604.581 544.663 606.433 535.344 610.037 526.649C613.64 517.955 618.923 510.054 625.585 503.398C632.246 496.743 640.155 491.464 648.86 487.862C657.565 484.26 666.895 482.406 676.317 482.406H676.344C716.023 482.406 722.637 506.109 731.197 517.241C748.103 539.239 781.863 529.598 781.863 558.282C781.924 561.571 782.846 564.788 784.539 567.611C786.233 570.434 788.637 572.764 791.513 574.37C794.388 575.976 797.635 576.801 800.93 576.763C804.224 576.725 807.451 575.826 810.289 574.154V574.154ZM819.623 577.697C815.009 587.604 804.69 586.698 799.49 594.715C794.796 601.932 802.53 605.687 802.53 605.687C802.53 605.687 811.516 609.842 816.876 597.405C819.649 591.252 820.609 584.408 819.623 577.697V577.697Z" fill="#020617"/>
+</svg>

astro-docs/src/assets/nx/Nx-light.svg

@@ -0,0 +1,3 @@
+<svg width="1000" height="1000" viewBox="0 0 1000 1000" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M499.651 555.512L416.132 686.623L277.653 462.192L277.333 697.143H180V300H278.426L418.345 535.244L418.479 428.768L499.651 555.512V555.512ZM515.678 402.082C516.318 400.804 515.678 301.305 515.891 300H418.559C418.612 301.571 418.425 400.564 418.479 402.082H515.678V402.082ZM665.917 512.181C654.556 511.963 643.406 515.267 634.003 521.639C624.6 528.011 617.406 537.137 613.411 547.762C620.029 537.871 629.827 530.531 641.187 526.952C652.546 523.374 664.788 523.772 675.89 528.08C686.45 532.368 700.344 539.319 711.357 535.617C706.19 528.388 699.374 522.491 691.472 518.416C683.57 514.34 674.81 512.203 665.917 512.181V512.181ZM756.316 540.438C746.317 536.975 734.983 533.06 726.743 522.301C725.143 520.17 723.65 517.773 722.05 515.243C718.48 508.669 713.651 502.86 707.837 498.145C699.997 492.393 689.704 489.57 676.37 489.57C663.264 489.573 650.454 493.463 639.563 500.745C628.673 508.028 620.193 518.376 615.197 530.477C621.53 521.672 630.067 514.682 639.954 510.206C649.84 505.73 660.73 503.925 671.535 504.971C682.339 506.017 692.679 509.878 701.52 516.168C710.362 522.457 717.395 530.955 721.917 540.811C724.168 544.503 727.558 547.366 731.578 548.97C735.598 550.574 740.031 550.832 744.21 549.706C757.357 546.909 756.476 559.293 776.29 563.501V559.959C776.21 548.081 769.73 545.311 756.29 540.438H756.316ZM810.289 574.154C813.196 572.389 815.582 569.887 817.207 566.903C818.833 563.919 819.638 560.559 819.543 557.163C819.276 478.411 755.277 411.031 676.344 411.031C652.616 411.011 629.257 416.887 608.369 428.129C587.482 439.37 569.722 455.625 556.691 475.428C556.424 474.735 516.105 411.776 515.678 411.031H418.479L510.825 555.458L420.719 697.143H515.118L556.184 634.131L597.997 697.143H692.424L606.824 562.596C605.406 559.975 604.638 557.052 604.584 554.073C604.581 544.663 606.433 535.344 610.037 526.649C613.64 517.954 618.923 510.054 625.585 503.398C632.246 496.743 640.155 491.463 648.86 487.861C657.565 484.259 666.895 482.406 676.317 482.406H676.344C716.023 482.406 722.637 506.108 731.197 517.241C748.103 539.239 781.863 529.598 781.863 558.281C781.924 561.571 782.846 564.788 784.539 567.611C786.233 570.434 788.637 572.764 791.513 574.37C794.388 575.976 797.635 576.801 800.93 576.763C804.224 576.725 807.451 575.826 810.289 574.154V574.154ZM819.623 577.696C815.009 587.604 804.69 586.698 799.49 594.715C794.796 601.932 802.53 605.687 802.53 605.687C802.53 605.687 811.516 609.842 816.876 597.404C819.649 591.252 820.609 584.408 819.623 577.696V577.696Z" fill="white"/>
+</svg>

astro-docs/src/assets/nx/connected-tasks.json

@@ -0,0 +1,64 @@
+{
+  "projects": [
+    {
+      "name": "app1",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "app2",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "taskId": "lib:test",
+  "taskGraphs": {
+    "lib:test": {
+      "roots": ["app1:test", "app2:test", "lib:test"],
+      "tasks": {
+        "app1:test": {
+          "id": "app1:test",
+          "target": { "project": "app1", "target": "test" },
+          "projectRoot": "apps/app1",
+          "overrides": {}
+        },
+        "app2:test": {
+          "id": "app2:test",
+          "target": { "project": "app2", "target": "test" },
+          "projectRoot": "apps/app2",
+          "overrides": {}
+        },
+        "lib:test": {
+          "id": "lib:test",
+          "target": { "project": "lib", "target": "test" },
+          "projectRoot": "libs/lib",
+          "overrides": {}
+        }
+      },
+      "dependencies": {
+        "app1:test": ["lib:test"],
+        "app2:test": ["lib:test"]
+      }
+    }
+  }
+}

astro-docs/src/assets/nx/disconnected-tasks.json

@@ -0,0 +1,61 @@
+{
+  "projects": [
+    {
+      "name": "app1",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "app2",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "taskId": "lib:test",
+  "taskGraphs": {
+    "lib:test": {
+      "roots": ["app1:test", "app2:test", "lib:test"],
+      "tasks": {
+        "app1:test": {
+          "id": "app1:test",
+          "target": { "project": "app1", "target": "test" },
+          "projectRoot": "apps/app1",
+          "overrides": {}
+        },
+        "app2:test": {
+          "id": "app2:test",
+          "target": { "project": "app2", "target": "test" },
+          "projectRoot": "apps/app2",
+          "overrides": {}
+        },
+        "lib:test": {
+          "id": "lib:test",
+          "target": { "project": "lib", "target": "test" },
+          "projectRoot": "libs/lib",
+          "overrides": {}
+        }
+      },
+      "dependencies": {}
+    }
+  }
+}

astro-docs/src/assets/nx/single-task.json

@@ -0,0 +1,29 @@
+{
+  "projects": [
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "taskId": "lib:test",
+  "taskGraphs": {
+    "lib:test": {
+      "roots": ["lib:test"],
+      "tasks": {
+        "lib:test": {
+          "id": "lib:test",
+          "target": { "project": "lib", "target": "test" },
+          "projectRoot": "libs/lib",
+          "overrides": {}
+        }
+      },
+      "dependencies": {}
+    }
+  }
+}

astro-docs/src/assets/nx/three-projects.json

@@ -0,0 +1,47 @@
+{
+  "projects": [
+    {
+      "name": "app1",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "app2",
+      "type": "app",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    },
+    {
+      "name": "lib",
+      "type": "lib",
+      "data": {
+        "tags": [],
+        "targets": {
+          "test": {}
+        }
+      }
+    }
+  ],
+  "dependencies": {
+    "app1": [{ "source": "app1", "target": "lib", "type": "static" }],
+    "app2": [{ "source": "app2", "target": "lib", "type": "static" }],
+    "lib": []
+  },
+  "workspaceLayout": {
+    "appsDir": "apps",
+    "libsDir": "libs"
+  },
+  "affectedProjectIds": [],
+  "focus": null,
+  "groupByFolder": false,
+  "exclude": []
+}

astro-docs/src/components/Youtube.astro

@@ -0,0 +1,5 @@
+---
+import { YouTube } from './youtube.component';
+---
+
+<YouTube {...Astro.props} />

astro-docs/src/components/utils/cx.ts

@@ -0,0 +1,11 @@
+import classNames from 'classnames';
+import { twMerge } from 'tailwind-merge';
+
+/**
+ * Small wrapper around classNames and twMerge
+ * It enables conditional and dynamic class usage,
+ * resolves duplications and conflicts for TailwindCSS
+ */
+export function cx(...inputs: classNames.ArgumentArray): string {
+  return twMerge(classNames(inputs));
+}

astro-docs/src/components/youtube.component.tsx

@@ -0,0 +1,151 @@
+import { PlayCircleIcon, PlayIcon } from '@heroicons/react/24/solid';
+import { cx } from './utils/cx';
+
+// TODO(caleb): this came from typedoc ui markdown impl in nx-dev
+type Schema = any;
+
+export const youtube: Schema = {
+  render: 'YouTube',
+  attributes: {
+    src: {
+      type: 'String',
+      required: true,
+    },
+    title: {
+      type: 'String',
+      required: true,
+    },
+    width: {
+      type: 'String',
+      default: '100%',
+    },
+    caption: {
+      // Added caption attribute here
+      type: 'String',
+      required: false, // Not required since it's optional
+    },
+  },
+};
+
+export function computeVideoID(youtubeURL: string): string | undefined {
+  let match;
+
+  // Check for 'https://www.youtube.com/embed/' format
+  match = youtubeURL.match(/youtube\.com\/embed\/([a-zA-Z0-9_-]+)/);
+  if (match && match[1]) {
+    return match[1];
+  }
+
+  // Check for 'https://www.youtube.com/watch?v=' format
+  match = youtubeURL.match(/youtube\.com\/watch\?v=([a-zA-Z0-9_-]+)/);
+  if (match && match[1]) {
+    return match[1];
+  }
+
+  match = youtubeURL.match(/youtube\.com\/live\/([a-zA-Z0-9_-]+)/);
+  if (match && match[1]) {
+    return match[1];
+  }
+
+  // Check for 'https://youtu.be/' format
+  match = youtubeURL.match(/youtu\.be\/([a-zA-Z0-9_-]+)/);
+  if (match && match[1]) {
+    return match[1];
+  }
+
+  return undefined;
+}
+
+export function computeThumbnailURL(youtubeURL: string) {
+  const videoID = computeVideoID(youtubeURL);
+  if (!videoID) {
+    throw new Error(
+      `Could not properly compute the thumbnail URL for ${youtubeURL}`
+    );
+  }
+  return `https://i.ytimg.com/vi_webp/${videoID}/maxresdefault.webp`;
+}
+
+export function computeWatchOnYoutubeURL(youtubeURL: string) {
+  const videoID = computeVideoID(youtubeURL);
+  if (!videoID) {
+    throw new Error(
+      `Could not properly compute the embed URL for ${youtubeURL}`
+    );
+  }
+  return 'https://www.youtube.com/watch?v=' + videoID;
+}
+
+export function computeEmbedURL(youtubeURL: string) {
+  const videoID = computeVideoID(youtubeURL);
+  if (!videoID) {
+    throw new Error(
+      `Could not properly compute the embed URL for ${youtubeURL}`
+    );
+  }
+  return 'https://www.youtube.com/embed/' + videoID;
+}
+
+const youtubeIcon = (
+  <svg
+    fill="currentColor"
+    role="img"
+    viewBox="0 0 24 24"
+    xmlns="http://www.w3.org/2000/svg"
+    className="absolute left-1/2 top-1/2 h-12 w-12 -translate-x-1/2 -translate-y-1/2 transform"
+  >
+    <path d="M23.5 6.19a3.02 3.02 0 0 0-2.12-2.14c-1.88-.5-9.38-.5-9.38-.5s-7.5 0-9.38.5A3.02 3.02 0 0 0 .5 6.19C0 8.07 0 12 0 12s0 3.93.5 5.81a3.02 3.02 0 0 0 2.12 2.14c1.87.5 9.38.5 9.38.5s7.5 0 9.38-.5a3.02 3.02 0 0 0 2.12-2.14C24 15.93 24 12 24 12s0-3.93-.5-5.81zM9.54 15.57V8.43L15.82 12l-6.28 3.57z" />
+  </svg>
+);
+
+export function YouTube(props: {
+  title: string;
+  caption?: string;
+  src: string;
+  width?: string;
+  disableRoundedCorners?: boolean;
+  imageOnly?: boolean;
+}): JSX.Element {
+  return (
+    <div className="text-center">
+      {' '}
+      {/* Center alignment applied to the container */}
+      {props.imageOnly ? (
+        <a
+          href={computeWatchOnYoutubeURL(props.src)}
+          className="relative block !text-inherit"
+        >
+          {youtubeIcon}
+          <img
+            src={computeThumbnailURL(props.src)}
+            alt={props.title}
+            width={props.width || '100%'}
+            className={cx(
+              {
+                'rounded-lg shadow-lg': !props.disableRoundedCorners,
+              },
+              'border-2 border-slate-200 hover:border-slate-500 dark:border-slate-700/40 dark:hover:border-slate-700'
+            )}
+          />
+        </a>
+      ) : (
+        <iframe
+          src={computeEmbedURL(props.src)}
+          title={props.title}
+          width={props.width || '100%'}
+          allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture; fullscreen"
+          loading="lazy"
+          credentialless="true"
+          className={cx({
+            'rounded-lg shadow-lg': !props.disableRoundedCorners,
+          })}
+        />
+      )}
+      {props.caption && (
+        <p className="mx-auto pt-0 text-slate-500 md:w-1/2 dark:text-slate-400">
+          {props.caption}
+        </p>
+      )}
+    </div>
+  );
+}

astro-docs/src/content.config.ts

@@ -0,0 +1,87 @@
+import { defineCollection, z } from 'astro:content';
+import { docsLoader } from '@astrojs/starlight/loaders';
+import { docsSchema } from '@astrojs/starlight/schema';
+import { PluginLoader } from './plugins/plugin.loader';
+import { CliLoader } from './plugins/cli.loader';
+import { DevkitLoader } from './plugins/devkit.loader';
+import { file } from 'astro/loaders';
+import { CnwLoader } from './plugins/cnw.loader.ts';
+
+// Default docs collection handled by Starlight
+const docs = defineCollection({
+  loader: docsLoader(),
+  schema: docsSchema(),
+});
+
+const nxCliDocs = defineCollection({
+  loader: CliLoader(),
+  schema: z.object({
+    title: z.string(),
+    docType: z.literal('cli'),
+  }),
+});
+
+const pluginDocs = defineCollection({
+  loader: PluginLoader(),
+  schema: z.object({
+    title: z.string(),
+    pluginName: z.string(),
+    packageName: z.string(),
+    docType: z.enum(['generators', 'executors', 'migrations']),
+    description: z.string(),
+  }),
+});
+
+const devkitDocs = defineCollection({
+  loader: DevkitLoader(),
+  schema: z.object({
+    title: z.string(),
+    docType: z.enum(['devkit', 'ngcli_adapter']),
+    description: z.string().optional(),
+    category: z.string().optional(),
+    kind: z.string().optional(),
+  }),
+});
+
+const cnwDocs = defineCollection({
+  loader: CnwLoader(),
+  schema: z.object({
+    title: z.string(),
+    docType: z.enum(['cnw']),
+  }),
+});
+
+// general notification collection for showing time based notifications
+//  in app, i.e. webinars, or confs etc.
+// goal is that different pages/parts of the app can query for their specific needs.
+// i.e. show banner for webinar, or show a dynamic sidebars item for a conf signups etc.
+const notifications = defineCollection({
+  loader: file('src/content/notifications.json'),
+  schema: z.object({
+    title: z.string(),
+    description: z.string(),
+    // TODO(caleb): should parse this to a date object
+    date: z.string(),
+    // slug will be dismiss key for the banner
+    slug: z.string(),
+    authors: z.array(z.string()),
+    // these have to contain the tag webinar??
+    type: z.enum(['webinar', 'event', 'release']),
+    cover_image: z.string(),
+    // tbf this can probs be derived if given a full timestamp for `date`
+    time: z.string(),
+    // TODO(caleb); get all possible statues, some of these could be derived such as 'Upcoming' or 'Past - *'
+    //  we just really want to know if something is gated or not etc
+    status: z.enum(['Upcoming', 'Past - Gated']),
+    registrationUrl: z.string(),
+  }),
+});
+
+export const collections = {
+  docs,
+  notifications,
+  'nx-cli-docs': nxCliDocs,
+  'plugin-docs': pluginDocs,
+  'devkit-docs': devkitDocs,
+  'cnw-docs': cnwDocs,
+};

astro-docs/src/content/approved-community-plugins.json

@@ -0,0 +1,537 @@
+[
+  {
+    "name": "@ahryman40k/nx-vitepress",
+    "description": "Nx plugin add vitepress project to your workspace",
+    "url": "https://github.com/Ahryman40k/nx-vitepress/tree/main/packages/nx-vitepress"
+  },
+  {
+    "name": "@klerick/nx-angular-mf",
+    "description": "Custom Angular Builder for Microfrontend Architecture",
+    "url": "https://github.com/klerick/nx-angular-mf"
+  },
+  {
+    "name": "@nightwatch/nx",
+    "description": "The NightwatchJS plugin allows your workspace to use the power of NightwatchJS for E2E and Component Testing on Desktop and Mobile",
+    "url": "https://github.com/nightwatchjs/nightwatch-plugin-nx/"
+  },
+  {
+    "name": "@nxkit/playwright",
+    "description": "The Playwright plugin allows your workspace to use the power of Playwright end-to-end testing",
+    "url": "https://github.com/nxkit/nxkit"
+  },
+  {
+    "name": "qwik-nx",
+    "description": "Get first class support for Qwik inside of Nx monorepos with Qwik optimized custom executors, generators and a vite plugin",
+    "url": "https://github.com/qwikifiers/qwik-nx"
+  },
+  {
+    "name": "@nxkit/style-dictionary",
+    "description": "Nx plugin to generate and build Style Dictionary projects inside your Nx workspace",
+    "url": "https://github.com/nxkit/nxkit"
+  },
+  {
+    "name": "nx-plugin-vite",
+    "description": "Nx plugin integrations with Vite.",
+    "url": "https://nx-plugins.netlify.app/"
+  },
+  {
+    "name": "nx-serverless-cdk",
+    "description": "Create CDK applications and construct libraries. Test and debug infrastructure code and AWS Lambda functions locally.",
+    "url": "https://github.com/castleadmin/nx-plugins/tree/main/nx-serverless-cdk/plugin"
+  },
+  {
+    "name": "@ago-dev/nx-aws-cdk-v2",
+    "description": "An nx plugin for the aws-cdk v2.",
+    "url": "https://github.com/adrian-goe/nx-aws-cdk-v2"
+  },
+  {
+    "name": "@berenddeboer/nx-aws-cdk",
+    "description": "Nx plugin to generate a CDK stack with support for the vitest runner. Supports all CDK commands.",
+    "url": "https://github.com/berenddeboer/nx-plugins/tree/main/packages/nx-aws-cdk"
+  },
+  {
+    "name": "@nx-iac/aws-cdk",
+    "description": "Empowers your Nx workspace with AWS CDK capabilities ⚡",
+    "url": "https://github.com/joelklint/nx-aws-cdk"
+  },
+  {
+    "name": "@routineless/nx-aws-cdk",
+    "description": "Nx plugin to generate and manage aws cdk app and lambdas.",
+    "url": "https://github.com/KozelAnatoliy/routineless/tree/main/packages/nx-aws-cdk"
+  },
+  {
+    "name": "@berenddeboer/nx-sst",
+    "description": "Nx plugin to generate an SST stack and execute all SST commands.",
+    "url": "https://github.com/berenddeboer/nx-plugins/tree/main/packages/nx-sst"
+  },
+  {
+    "name": "@rxap/plugin-localazy",
+    "description": "An Nx plugin for localazy.com upload and download tasks.",
+    "url": "https://gitlab.com/rxap/plugins/-/tree/master/libs/localazy"
+  },
+  {
+    "name": "nx-electron",
+    "description": "An Nx plugin for developing Electron applications",
+    "url": "https://github.com/bennymeg/nx-electron"
+  },
+  {
+    "name": "nx-stylelint",
+    "description": "Nx plugin to use stylelint in a nx workspace",
+    "url": "https://github.com/Phillip9587/nx-stylelint"
+  },
+  {
+    "name": "@nxext/ionic-react",
+    "description": "An Nx plugin for developing Ionic React applications and libraries",
+    "url": "https://github.com/nxext/nx-extensions-ionic/tree/main/packages/ionic-react"
+  },
+  {
+    "name": "@nxext/ionic-angular",
+    "description": "An Nx plugin for developing Ionic Angular applications and libraries",
+    "url": "https://github.com/nxext/nx-extensions-ionic/tree/main/packages/ionic-angular"
+  },
+  {
+    "name": "@nxext/capacitor",
+    "description": "An Nx plugin for developing cross-platform applications using Capacitor",
+    "url": "https://github.com/nxext/nx-extensions/tree/main/packages/capacitor"
+  },
+  {
+    "name": "@angular-architects/ddd",
+    "description": "Nx plugin for structuring a monorepo with domains and layers",
+    "url": "https://github.com/angular-architects/nx-ddd-plugin"
+  },
+  {
+    "name": "@flowaccount/nx-serverless",
+    "description": "Nx plugin for node/angular-universal schematics and deployment builders in an Nx workspace",
+    "url": "https://github.com/flowaccount/nx-plugins"
+  },
+  {
+    "name": "@ns3/nx-serverless",
+    "description": "Nx plugin for node serverless applications in an Nx workspace",
+    "url": "https://github.com/Bielik20/nx-plugins/tree/master/packages/nx-serverless"
+  },
+  {
+    "name": "@ns3/nx-jest-playwright",
+    "description": "Nx plugin to run jest-playwright e2e tests in an Nx workspace",
+    "url": "https://github.com/Bielik20/nx-plugins/tree/master/packages/nx-jest-playwright"
+  },
+  {
+    "name": "@ns3/nx-playwright",
+    "description": "Nx plugin to run playwright e2e tests in an Nx workspace",
+    "url": "https://github.com/Bielik20/nx-plugins/tree/master/packages/nx-playwright"
+  },
+  {
+    "name": "@nx-plus/nuxt",
+    "description": "Nx plugin adding first class support for Nuxt in your Nx workspace.",
+    "url": "https://github.com/ZachJW34/nx-plus/tree/master/libs/nuxt"
+  },
+  {
+    "name": "@nx-plus/vue",
+    "description": "Nx plugin adding first class support for Vue in your Nx workspace.",
+    "url": "https://github.com/ZachJW34/nx-plus/tree/master/libs/vue"
+  },
+  {
+    "name": "@nx-plus/docusaurus",
+    "description": "Nx plugin adding first class support for Docusaurus in your Nx workspace.",
+    "url": "https://github.com/ZachJW34/nx-plus/tree/master/libs/docusaurus"
+  },
+  {
+    "name": "@twittwer/compodoc",
+    "description": "Nx Plugin to integrate the generation of documentation with Compodoc in the Nx workflow",
+    "url": "https://github.com/twittwer/nx-tools/tree/master/libs/compodoc#readme"
+  },
+  {
+    "name": "@enio.ai/nx-install",
+    "description": "nx-install is a plugin for Nx workspaces to quickly setup custom install commands via npm.",
+    "url": "https://github.com/enio-ireland/enio/tree/develop/packages/nx-install#readme"
+  },
+  {
+    "name": "@enio.ai/typedoc",
+    "description": "typedoc is a plugin for Nx workspaces to quickly setup documentation automation on your projects using typedoc.",
+    "url": "https://github.com/enio-ireland/enio/tree/develop/packages/typedoc#readme"
+  },
+  {
+    "name": "@nxext/svelte",
+    "description": "Nx plugin to use Svelte within nx workspaces",
+    "url": "https://github.com/nxext/nx-extensions/tree/master/packages/svelte"
+  },
+  {
+    "name": "@nxext/stencil",
+    "description": "Nx plugin to use StencilJs within nx workspaces",
+    "url": "https://github.com/nxext/nx-extensions/tree/master/packages/stencil"
+  },
+  {
+    "name": "@nxext/vue",
+    "description": "Nx plugin to use VueJS 3 within nx workspaces",
+    "url": "https://github.com/nxext/nx-extensions/tree/master/packages/vue"
+  },
+  {
+    "name": "@nxext/solid",
+    "description": "Nx plugin to use SolidJS within nx workspaces",
+    "url": "https://github.com/nxext/nx-extensions/tree/master/packages/solid"
+  },
+  {
+    "name": "@nx-go/nx-go",
+    "description": "Nx plugin to use Go in a Nx workspace",
+    "url": "https://github.com/nx-go/nx-go"
+  },
+  {
+    "name": "@nx-golang/gin",
+    "description": "Nx plugin to use Go-Gin in a Nx workspace",
+    "url": "https://github.com/nx-golang/nx-golang"
+  },
+  {
+    "name": "@angular-architects/module-federation",
+    "description": "Nx plugin to use webpack module federation",
+    "url": "https://github.com/angular-architects/module-federation-plugin"
+  },
+  {
+    "name": "@nxrocks/nx-spring-boot",
+    "description": "Nx plugin to generate, run, package, build (and more) Spring Boot projects inside your Nx workspace",
+    "url": "https://github.com/tinesoft/nxrocks/tree/master/packages/nx-spring-boot"
+  },
+  {
+    "name": "@trumbitta/nx-plugin-openapi",
+    "description": "OpenAPI Plugin for Nx. Keep your API spec files in libs, and auto-generate sources.",
+    "url": "https://github.com/trumbitta/nx-trumbitta/tree/main/packages/nx-plugin-openapi"
+  },
+  {
+    "name": "@trumbitta/nx-plugin-unused-deps",
+    "description": "Check the dependency graph of your monorepo, looking for unused NPM packages.",
+    "url": "https://github.com/trumbitta/nx-trumbitta/tree/main/packages/nx-plugin-unused-deps"
+  },
+  {
+    "name": "@nxrocks/nx-flutter",
+    "description": "Nx Plugin adding first class support for Flutter in your Nx workspace",
+    "url": "https://github.com/tinesoft/nxrocks/tree/master/packages/nx-flutter"
+  },
+  {
+    "name": "@srleecode/domain",
+    "description": "Nx Plugin for allowing operations to occur at the domain level instead of the default library level",
+    "url": "https://github.com/srlee309/domain"
+  },
+  {
+    "name": "@jscutlery/semver",
+    "description": "Nx plugin to automate semantic versioning and CHANGELOG generation.",
+    "url": "https://github.com/jscutlery/semver"
+  },
+  {
+    "name": "ngx-deploy-npm",
+    "description": "Publish your libraries to NPM with just one command.",
+    "url": "https://github.com/bikecoders/ngx-deploy-npm"
+  },
+  {
+    "name": "@nx-dotnet/core",
+    "description": "Nx plugin for developing and housing .NET projects within an Nx workspace.",
+    "url": "https://github.com/nx-dotnet/nx-dotnet"
+  },
+  {
+    "name": "@nxrocks/nx-quarkus",
+    "description": "Nx plugin to generate, run, package, build (and more) Quarkus projects inside your Nx workspace",
+    "url": "https://github.com/tinesoft/nxrocks/tree/master/packages/nx-quarkus"
+  },
+  {
+    "name": "@nx-extend/gcp-secrets",
+    "description": "Nx plugin to generate and securely deploy your Google Cloud Secrets",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/gcp-secrets"
+  },
+  {
+    "name": "@nx-extend/gcp-storage",
+    "description": "Nx plugin to upload to Google Cloud Storage",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/gcp-storage"
+  },
+  {
+    "name": "@nx-extend/gcp-functions",
+    "description": "Nx plugin to generate, run, build and deploy your Google Cloud Functions",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/gcp-functions"
+  },
+  {
+    "name": "@nx-extend/gcp-deployment-manager",
+    "description": "Nx plugin to deploy your Google Cloud Deployments",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/gcp-deployment-manager"
+  },
+  {
+    "name": "@nx-extend/gcp-cloud-run",
+    "description": "Nx plugin to build and deploy your docker container to Google Cloud Run",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/gcp-cloud-run"
+  },
+  {
+    "name": "@nx-extend/translations",
+    "description": "Nx plugin to extract, pull, push and translate your apps translations",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/translations"
+  },
+  {
+    "name": "@nx-extend/firebase-hosting",
+    "description": "Nx plugin to deploy your apps to Firebase hosting",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/firebase-hosting"
+  },
+  {
+    "name": "@nx-extend/e2e-runner",
+    "description": "Nx plugin that can start your API before running Cypress/Playwright",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/e2e-runner"
+  },
+  {
+    "name": "@nx-extend/vercel",
+    "description": "Nx plugin to deploy your apps to Vercel",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/vercel"
+  },
+  {
+    "name": "@nx-extend/strapi",
+    "description": "Nx plugin for developing Strapi applications",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/strapi"
+  },
+  {
+    "name": "@nx-extend/playwright",
+    "description": "Nx plugin to run playwright e2e tests in an Nx workspace",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/playwright"
+  },
+  {
+    "name": "@nx-extend/terraform",
+    "description": "Nx plugin for deploying your resources with Terraform",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/terraform"
+  },
+  {
+    "name": "@nx-extend/pulumi",
+    "description": "Nx plugin for deploying your resources with Pulumi",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/pulumi"
+  },
+  {
+    "name": "@nx-extend/react-email",
+    "description": "Nx plugin for developing email templates with react.email",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/react-email"
+  },
+  {
+    "name": "@nx-extend/shadcn-ui",
+    "description": "Nx plugin for working with shadcn/ui",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/shadcn-ui"
+  },
+  {
+    "name": "@nx-extend/docusaurus",
+    "description": "Nx plugin adding first class support for Docusaurus in your Nx workspace.",
+    "url": "https://github.com/tripss/nx-extend/tree/master/packages/docusaurus"
+  },
+  {
+    "name": "@nativescript/nx",
+    "description": "Nx Plugin adding first class support for NativeScript in your Nx workspace",
+    "url": "https://github.com/nativescript/nx"
+  },
+  {
+    "name": "@nxtensions/astro",
+    "description": "Nx plugin adding first class support for Astro (https://astro.build).",
+    "url": "https://github.com/nxtensions/nxtensions/tree/main/packages/astro"
+  },
+  {
+    "name": "@nxrs/cargo",
+    "description": "Nx plugin adding first-class support for Rust applications and libraries.",
+    "url": "https://github.com/nxrs/cargo/tree/main/packages/cargo"
+  },
+  {
+    "name": "nx-uvu",
+    "description": "An nx executor for the uvu test library",
+    "url": "https://github.com/jmcdo29/nx-uvu"
+  },
+  {
+    "name": "@ndrsg/nx-http",
+    "description": "Plugin with executors, which can perform http-stuff (e.g. requests, webhooks, file up/downloads, ...)",
+    "url": "https://github.com/ndrsg/nx-ext/tree/main/packages/nx-http"
+  },
+  {
+    "name": "@diogovcs/graphql-mesh",
+    "description": "Nx plugin to add GraphQL Mesh integration to Nx Workspace.",
+    "url": "https://github.com/DiogoVCS/nx-workspace-plugins"
+  },
+  {
+    "name": "@computas/nx-yarn",
+    "description": "A plugin to help make nx with yarn a pleasant experience.",
+    "url": "https://github.com/computas/nx-yarn"
+  },
+  {
+    "name": "@theunderscorer/nx-semantic-release",
+    "description": "Nx plugin for automated releases using semantic-release.",
+    "url": "https://github.com/TheUnderScorer/nx-semantic-release"
+  },
+  {
+    "name": "nx-pwm",
+    "description": "Nx plugin and CLI to help maintain packages, inspired by NX repo tooling",
+    "url": "https://github.com/gioragutt/nx-pwm"
+  },
+  {
+    "name": "@nxrocks/nx-micronaut",
+    "description": "Nx plugin to generate, run, package, build (and more) Micronaut projects inside your Nx workspace",
+    "url": "https://github.com/tinesoft/nxrocks/tree/master/packages/nx-micronaut"
+  },
+  {
+    "name": "@koliveira15/nx-sonarqube",
+    "description": "Nx plugin that scans projects using SonarQube / SonarCloud.",
+    "url": "https://github.com/koliveira15/nx-sonarqube"
+  },
+  {
+    "name": "@mands/nx-playwright",
+    "description": "The Playwright plugin allows your workspace to use the power of Playwright end-to-end testing using a native runner.",
+    "url": "https://github.com/marksandspencer/nx-plugins/tree/main/packages/nx-playwright"
+  },
+  {
+    "name": "@diogovcs/stryker-mutator",
+    "description": "Nx plugin to add Stryker Mutator mutation tests to the Nx Workspace.",
+    "url": "https://github.com/DiogoVCS/nx-workspace-plugins"
+  },
+  {
+    "name": "@spaceribs/nx-web-ext",
+    "description": "Nx plugin that allows you to build, test and deploy web extensions.",
+    "url": "https://github.com/spaceribs/spaceribs/tree/main/packages/nx-web-ext"
+  },
+  {
+    "name": "@spaceribs/nx-betterer",
+    "description": "Nx plugin that applies betterer standards on a per-project basis.",
+    "url": "https://github.com/spaceribs/spaceribs/tree/main/packages/nx-betterer"
+  },
+  {
+    "name": "@nx-extensions/helm",
+    "description": "Nx plugin providing comprehensive support for Helm charts, including generation, packaging, and publishing capabilities.",
+    "url": "https://github.com/marcolongol/nx-extensions/tree/main/packages/helm"
+  },
+  {
+    "name": "@nx-tools/nx-container",
+    "description": "Nx plugin to build OCI containers with Docker, Podman or Kaniko.",
+    "url": "https://github.com/gperdomor/nx-tools/tree/main/plugins/nx-container"
+  },
+  {
+    "name": "@nxrocks/nx-melos",
+    "description": "Nx plugin adding first class support for Melos in your Nx workspace",
+    "url": "https://github.com/tinesoft/nxrocks/tree/master/packages/nx-melos"
+  },
+  {
+    "name": "@monodon/rust",
+    "description": "Adds Cargo and Rust support",
+    "url": "https://github.com/cammisuli/monodon/tree/main/packages/rust"
+  },
+  {
+    "name": "nx-mesh",
+    "description": "GraphQL Mesh support for Nx",
+    "url": "https://github.com/domjtalbot/nx-mesh"
+  },
+  {
+    "name": "@nxazure/func",
+    "description": "Nx plugin to add Azure Functions support to Nx Workspace.",
+    "url": "https://github.com/AlexPshul/nxazure/tree/master/packages/func"
+  },
+  {
+    "name": "@rbnx/webdriverio",
+    "description": "A Nx plugin that adds the WebdriverIO testing framework to a NX workspace.",
+    "url": "https://github.com/Roozenboom/rbnx/tree/main/packages/webdriverio"
+  },
+  {
+    "name": "nx-ngrok",
+    "description": "Ngrok support for Nx",
+    "url": "https://github.com/domjtalbot/nx-ngrok"
+  },
+  {
+    "name": "@nxrocks/nx-ktor",
+    "description": "Nx plugin to generate, run, package, build (and more) Ktor projects inside your Nx workspace",
+    "url": "https://github.com/tinesoft/nxrocks/tree/master/packages/nx-ktor"
+  },
+  {
+    "name": "nx-size-limit",
+    "description": "Adds size-limit support for Nx (performance budget tool for JavaScript)",
+    "url": "https://github.com/LironHazan/nx-size-limit"
+  },
+  {
+    "name": "@loft-orbital/terraform",
+    "description": "Terraform executors and generators",
+    "url": "https://github.com/loft-orbital/nx-plugins/tree/main/packages/terraform"
+  },
+  {
+    "name": "@nxlv/python",
+    "description": "Nx plugin designed to extend the Nx features to work with Python projects based on Poetry.",
+    "url": "https://github.com/lucasvieirasilva/nx-plugins/tree/main/packages/nx-python"
+  },
+  {
+    "name": "nx-gcp-cache",
+    "description": "Nx plugin to use Google Cloud Storage as distributed remote cache",
+    "url": "https://github.com/davidgarciab/nx-gcp-cache"
+  },
+  {
+    "name": "@jnxplus/nx-gradle",
+    "description": "Nx plugin to add Gradle multi-project builds support to Nx workspace",
+    "url": "https://github.com/khalilou88/jnxplus/tree/main/packages/nx-gradle"
+  },
+  {
+    "name": "@jnxplus/nx-maven",
+    "description": "Nx plugin to add Maven multi-module project support to Nx workspace",
+    "url": "https://github.com/khalilou88/jnxplus/tree/main/packages/nx-maven"
+  },
+  {
+    "name": "@naxodev/nx-cloudflare",
+    "description": "Nx plugin for Cloudflare, in particular Cloudflare workers. It allows to generate build and run Cloudflare workers in your Nx workspace.",
+    "url": "https://github.com/naxodev/oss/tree/main/packages/nx-cloudflare"
+  },
+  {
+    "name": "@naxodev/gonx",
+    "description": "Modern Nx plugin to use Go in a Nx workspace. Forked from @nx-go/nx-go",
+    "url": "https://github.com/naxodev/oss/tree/main/packages/gonx"
+  },
+  {
+    "name": "@ziacik/azure-func",
+    "description": "Generating, serving and publishing Azure Functions 4 apps.",
+    "url": "https://github.com/ziacik/nx-tools/tree/master/packages/azure-func"
+  },
+  {
+    "name": "@simondotm/nx-firebase",
+    "description": "Nx plugin to support Firebase Apps and Cloud Functions in Nx workspaces",
+    "url": "https://github.com/simondotm/nx-firebase"
+  },
+  {
+    "name": "@dman926/nx-python-pdm",
+    "description": "Use Python in NX workspaces with PDM",
+    "url": "https://github.com/dman926/nx-python-pdm"
+  },
+  {
+    "name": "@gnuechtel/nx-cucumber",
+    "description": "Plugin to use Cucumber within Nx workspaces",
+    "url": "https://gitlab.com/gnuechtel/open-source/-/tree/main/libs/nx-cucumber"
+  },
+  {
+    "name": "@analogjs/platform",
+    "description": "Official plugin to add Analog to your Nx monorepo.",
+    "url": "https://analogjs.org/docs/integrations/nx"
+  },
+  {
+    "name": "@getlarge/nx-heroku",
+    "description": "Plugin to deploy and promote Nx apps on Heroku",
+    "url": "https://github.com/getlarge/nx-heroku"
+  },
+  {
+    "name": "@getlarge/nx-node-sea",
+    "description": "Plugin that provides integration with Node.js Single Executable Applications (SEA).",
+    "url": "https://github.com/getlarge/nx-node-sea"
+  },
+  {
+    "name": "@huge-nx/conventions",
+    "description": "Plugin to generate and manage Nx workspaces by adhering to established workspace conventions.",
+    "url": "https://github.com/jogelin/huge-nx"
+  },
+  {
+    "name": "nx-github-pages",
+    "description": "A small Nx plugin to make deploying static projects to GitHub Pages easy.",
+    "url": "https://github.com/agentender/nx-github-pages"
+  },
+  {
+    "name": "nx-solhint",
+    "description": "Solhint generators and inferred tasks for Nx",
+    "url": "https://github.com/juliangsibecas/nx-solhint"
+  },
+  {
+    "name": "nx-foundry",
+    "description": "Foundry generators and inferred tasks for Nx",
+    "url": "https://github.com/juliangsibecas/nx-foundry"
+  },
+  {
+    "name": "@robby-rabbitman/nx-plus-web-test-runner",
+    "description": "Web Test Runner plugin for Nx workspaces.",
+    "url": "https://github.com/RobbyRabbitman/nx-plus/tree/main/libs/web-test-runner"
+  },
+  {
+    "name": "@aws/nx-plugin",
+    "description": "Nx Plugin for AWS: Accelerate building cloud-native applications with AWS",
+    "url": "https://github.com/awslabs/nx-plugin-for-aws"
+  }
+]

astro-docs/src/content/docs/api/nx-cloud-cli.mdoc

@@ -0,0 +1,314 @@
+---
+title: Nx Cloud CLI
+description: Complete reference for all Nx Cloud CLI commands
+---
+
+The Nx Cloud command line interface provides various commands to connect and interact with Nx Cloud, manage distributed task execution, and handle authentication.
+Below is a complete reference for all available commands and their options.
+
+## Available Commands
+
+### `nx-cloud login`
+
+Provision a local personal access token to access Nx Cloud features. This will open your browser to the Nx Cloud application and after signing in will generate a personal access token and save it in a configuration file locally called `nxcloud.ini`.
+
+This command is the same as running `nx login`.
+
+**Usage:**
+
+```bash
+npx nx-cloud login [nxCloudUrl]
+```
+
+#### Options
+
+| Option       | Type   | Description                                    | Default                |
+| ------------ | ------ | ---------------------------------------------- | ---------------------- |
+| `nxCloudUrl` | string | The URL of the Nx Cloud instance to connect to | `https://cloud.nx.app` |
+
+#### Configuration File Location
+
+{% tabs %}
+{% tabitem label="macOS & Linux" %}
+
+We look for this file at the following locations:
+
+- `$XDG_CONFIG_HOME/nxcloud/nxcloud.ini`
+- `$HOME/config/nxcloud/nxcloud.ini`
+- `$HOME/.nxcloud.ini`
+
+If we don't find an existing config file, we create one at `$HOME/config/nxcloud/nxcloud.ini`
+
+{% /tabitem %}
+  {% tabitem label="Windows" %}
+
+We look for this file within the `%LOCALAPPDATA%/nxcloud` directory and if it does not exist, we will create a new `nxcloud.ini` file there.
+
+  {% /tabitem %}
+{% /tabs %}
+The format of this file is as follows:
+
+```ini
+[https://cloud\.nx\.app]
+personalAccessToken=SOME_ACCESS_TOKEN
+```
+
+If you have access to multiple instances of the Nx Cloud application (e.g. self-hosted Enterprise and our managed instance), each instance will be saved to this file under its URL.
+
+### `nx-cloud logout`
+
+Revoke a personal access token from your local environment. This will remove the personal access token from the locally initialized configuration file and also invalidate the token from the Nx Cloud application. You will be prompted to remove a single token or all tokens from your local environment.
+
+**Usage:**
+
+```bash
+npx nx-cloud logout
+```
+
+### `nx-cloud configure`
+
+To provision more than one personal access token for multiple contexts (e.g. home and work machines) you can use the personal access tokens page under your Nx Cloud profile. To save a personal access token to your local `nxcloud.ini` file without needing to edit the file yourself call `nx-cloud configure`.
+
+**Usage:**
+
+```bash
+npx nx-cloud configure
+```
+
+#### Options
+
+| Option                  | Type   | Description                            | Default                |
+| ----------------------- | ------ | -------------------------------------- | ---------------------- |
+| `--personalAccessToken` | string | The personal access token to configure |                        |
+| `--nx-cloud-url`        | string | The URL of the Nx Cloud instance       | `https://cloud.nx.app` |
+
+#### Examples
+
+```bash
+npx nx-cloud configure --personalAccessToken=SOME_ACCESS_TOKEN
+```
+
+To configure multiple tokens for different instances of the Nx Cloud app:
+
+```bash
+npx nx-cloud configure --personalAccessToken=SOME_ACCESS_TOKEN --nx-cloud-url=https://nx-cloud.my-domain.app
+```
+
+### `nx-cloud convert-to-nx-cloud-id`
+
+When logging into Nx Cloud with a [Personal Access Token](/ci/recipes/security/personal-access-tokens), your `nx.json` file needs to include the `nxCloudId` property, which acts as a unique identifier for your workspace. If you have been using the previous `nxCloudAccessToken` to connect, simply run `npx nx-cloud convert-to-nx-cloud-id` to automatically update your configuration to use `nxCloudId`.
+
+If you are connecting to Nx Cloud with a workspace that is version 19.6 or lower, this command will also install the latest version of the Nx Cloud npm package and add it into your `package.json`. Only Nx versions 19.7 and higher natively support the `nxCloudId` property in the `nx.json` file; for versions 19.6 and lower, the Nx Cloud npm package will be needed to use that property.
+
+**Usage:**
+
+```bash
+npx nx-cloud convert-to-nx-cloud-id
+```
+
+### `nx-cloud start-ci-run`
+
+At the beginning of your main job, invoke `npx nx-cloud start-ci-run`. This tells Nx Cloud that the following series of command correspond to the same CI run.
+
+**Usage:**
+
+```bash
+npx nx-cloud start-ci-run
+```
+
+:::warning[Do not run start-ci-run locally]
+`npx nx-cloud start-ci-run` generates a temporary marker file that can cause a local Nx repo to behave as if it is a part of a CI run. This can cause strange behavior like Nx commands timing out or throwing unexpected errors.
+To discourage this from happening, this command will run a check to see if it is running in a CI environment. You can bypass this check with `npx nx-cloud start-ci-run --force`.
+
+If you accidentally run this command locally, remove all generated marker files with `npx nx-cloud cleanup`.
+:::
+
+#### Options
+
+| Option                          | Type    | Description                                                                             | Default |
+| ------------------------------- | ------- | --------------------------------------------------------------------------------------- | ------- |
+| `--distribute-on`               | string  | Configure the number of agents and launch templates for distributed execution           |         |
+| `--require-explicit-completion` | boolean | Disable automatic completion monitoring and require explicit `nx-cloud complete-ci-run` | `false` |
+| `--stop-agents-after`           | string  | Comma-separated list of targets after which agents should terminate                     |         |
+| `--stop-agents-on-failure`      | boolean | Terminate all agents when a command fails                                               | `true`  |
+| `--use-dte-by-default`          | boolean | Configure Nx to distribute all commands by default                                      | `true`  |
+| `--with-env-vars`               | string  | Comma-separated list of environment variables to pass to Nx Agents                      |         |
+| `--force`                       | boolean | Bypass CI environment check                                                             |         |
+
+#### Detailed Option Usage
+
+##### --distribute-on
+
+By default, `npx nx-cloud start-ci-run` is intended for use with [Nx Agents](/ci/features/distribute-task-execution) and expects `--distribute-on` to be configured. It will output a warning if this flag is not set. If you are running a distributed execution with a legacy setup without Nx Agents, you can pass `--distribute-on=manual` to disable this warning.
+
+This command tells Nx Cloud how many agents to use (and what launch templates to use) to distribute tasks. E.g.,
+`npx nx-cloud start-ci-run --distribute-on="8 linux-medium-js"` will distribute CI using 8 agents that are initialized
+using the `linux-medium-js` launch template.
+
+You can also [define the configuration in a file](/ci/features/dynamic-agents) and reference it as follows:
+`npx nx-cloud start-ci-run --distribute-on=".nx/workflows/dynamic-changesets.yaml"`.
+
+```yaml 
+// .nx/workflows/dynamic-changesets.yaml
+distribute-on:
+  small-changeset: 3 linux-medium-js
+  medium-changeset: 6 linux-medium-js
+  large-changeset: 10 linux-medium-js
+```
+
+##### --stop-agents-after
+
+You can tell Nx Cloud to terminate agents after it sees a certain
+target or group of targets: `npx nx-cloud start-ci-run --stop-agents-after=build,test,e2e`.
+
+:::tip[Be as specific]
+For the best results, always tell Nx Cloud about all targets that should be expected during your pipeline. This will
+prevent your CI Pipeline Execution from ending prematurely, cutting off any unfinished work.
+:::
+
+Whether you are running commands serially or in parallel (through use of the `&` operand or discrete jobs), you should
+include one or more targets from each command.
+
+{% tabs %}
+{% tabitem label="Serial command execution" %}
+
+#### Incorrect example:
+
+```yaml
+- run: npx nx-cloud start-ci-run --stop-agents-after=build
+- run: nx affected -t build
+- run: nx affected -t lint
+- run: nx affected -t test
+```
+
+Nx Cloud will only look for the presence of a `build` target before determining your pipeline can be shut down. Since
+both `lint` and `test` will only run after `build` is complete, your pipeline would end before all intended work is
+executed.
+
+#### Corrected example:
+
+```yaml
+- run: npx nx-cloud start-ci-run --stop-agents-after=lint,test,build
+- run: nx affected -t lint
+- run: nx affected -t test
+- run: nx affected -t build
+```
+  {% /tabitem %}
+{% tabitem label="Parallel command execution" %}
+
+#### Incorrect example:
+
+```yaml
+- run: npx nx-cloud start-ci-run --stop-agents-after=test
+- run: nx affected -t build & nx affected -t lint & nx affected -t test
+```
+
+At first glance, this example may appear correct. However, since all the commands are executed in parallel, it could
+be possible that your `test` command results in full cache hits and finishes faster than the `build` and `lint` commands.
+In this case, Nx Cloud will stop your pipeline, leaving work incomplete for both the `build` and `lint` commands.
+
+#### Corrected example:
+
+```yaml
+- run: npx nx-cloud start-ci-run --stop-agents-after=lint,test,build
+- run: nx affected -t build & nx affected -t lint & nx affected -t test
+```
+
+{% /tabitem %}
+{% /tabs %}
+
+#### Advanced shutdown targeting
+
+In advanced pipeline setups, it is possible that you want to run multiple commands with the same target, but with
+distinct configurations. An example of this may be doing static translations for different locales during your builds.
+
+```yaml
+- run: npx nx-cloud start-ci-run --stop-agents-after=build
+- run: nx affected -t build --configuration=locale-en
+- run: nx affected -t build --configuration=locale-es
+```
+
+In this case, the `build` target will be executed twice, once with the `locale-en` configuration and once with the
+`locale-es` configuration. However, Nx Cloud is only looking for the `build` target to assess whether the CI Pipeline
+Execution can be marked complete.
+
+To address this, you can pass an optional `configuration` to make your `target`s more specific.
+
+```yaml
+- run: npx nx-cloud start-ci-run --stop-agents-after=build:locale-en,build:locale-es
+- run: nx affected -t build --configuration=locale-en
+- run: nx affected -t build --configuration=locale-es
+```
+
+##### --with-env-vars (Nx Agents Only)
+
+By default, invoking `npx nx-cloud start-ci-run` will take all environment variables prefixed with `NX_` and send them over to Nx Agents.
+This means that your access token, verbose logging configuration and other Nx-related environment variables will be the same on your
+main CI jobs and the Nx Agent machines.
+
+If you want to pass other environment variables from the main job to Nx Agents, you can do it as follows: `--with-env-vars="VAR1,VAR2"`.
+This will set `VAR1` and `VAR2` on Nx Agents to the same values set on the main job before any steps run.
+
+> Note: none of the values passed to Nx Agents are stored by Nx Cloud.
+
+#### Enabling/Disabling Distribution
+
+Invoking `npx nx-cloud start-ci-run` will tell Nx to distribute by default. You can enable/disable distribution for
+individual commands as follows:
+
+{% tabs %}
+{% tabitem  label="Nx >= 18" %}
+
+- `nx affected -t build --agents` (explicitly enable distribution)
+- `nx affected -t build --no-agents` (explicitly disable distribution)
+
+{% /tabitem %}
+{% tabitem  label="Nx >= 14.7" %}
+
+- `nx affected -t build --dte` (explicitly enable distribution)
+- `nx affected -t build --no-dte` (explicitly disable distribution)
+
+{% /tabitem %}
+{% /tabs %}
+
+### `nx-cloud stop-all-agents`
+
+Same as `npx nx-cloud complete-ci-run`.
+
+This command tells Nx Cloud to terminate all agents associated with this CI pipeline execution.
+Invoking this command is not needed anymore. New versions of Nx Cloud can track when the main job terminates
+and terminate associated agents automatically.
+
+**Usage:**
+
+```bash
+npx nx-cloud stop-all-agents
+```
+
+### `nx-cloud complete-ci-run`
+
+Explicitly complete a CI run when using `--require-explicit-completion` with `start-ci-run`.
+
+**Usage:**
+
+```bash
+npx nx-cloud complete-ci-run
+```
+
+### `nx-cloud cleanup`
+
+Remove temporary marker files created by `start-ci-run` if accidentally run locally.
+
+**Usage:**
+
+```bash
+npx nx-cloud cleanup
+```
+
+## Getting Help
+
+You can get help for any command by adding the `--help` flag:
+
+```bash
+npx nx-cloud <command> --help
+```

astro-docs/src/content/docs/api/plugins/angular/test-plugin.mdoc

@@ -0,0 +1,16 @@
+---
+title: Test Plugin
+description: A test plugin page
+---
+
+This is a test plugin page to demonstrate the dynamic sidebar functionality.
+
+## Plugin Features
+
+The sidebar should automatically switch to the "Plugins" tab when viewing this page.
+
+## Installation
+
+```bash
+npm install @nx/test-plugin
+```

astro-docs/src/content/docs/api/plugins/index.mdx

@@ -0,0 +1,31 @@
+---
+title: 'Nx Plugins'
+description: 'Complete reference for all Nx plugin commands'
+---
+
+# Nx Plugins
+
+Nx provides a rich ecosystem of plugins to help you build, test, and deploy your applications. Each plugin offers generators, executors, and migrations specific to its technology stack.
+
+## Available Plugins
+
+import { getCollection } from 'astro:content';
+
+export const pluginDocs = await getCollection('plugin-docs');
+export const pluginsByName = pluginDocs.reduce((acc, doc) => {
+  if (!acc[doc.data.pluginName]) {
+    acc[doc.data.pluginName] = [];
+  }
+  acc[doc.data.pluginName].push(doc);
+  return acc;
+}, {});
+
+export const sortedPluginNames = Object.keys(pluginsByName).sort();
+
+<ul>
+  {sortedPluginNames.map((pluginName) => (
+    <li key={pluginName}>
+      <a href={`/api/plugins/${pluginName}`}>@nx/{pluginName}</a>
+    </li>
+  ))}
+</ul>

astro-docs/src/content/docs/concepts/mental-model.mdoc

@@ -0,0 +1,219 @@
+---
+title: Mental Model
+description: Understand how Nx works with project graphs, task graphs, affected commands, and caching to efficiently manage your monorepo development workflow.
+---
+
+Nx is a VSCode of build tools, with a powerful core, driven by metadata, and extensible through [plugins](/concepts/nx-plugins). Nx works with a
+few concepts to drive your monorepo efficiently, and effectively. This guide covers the mental model around how Nx works
+with project graphs, task graphs, affected commands, computation hashing and caching.
+
+## The project graph
+
+A project graph is used to reflect the source code in your repository and all the external dependencies that aren't
+authored in your repository, such as Webpack, React, Angular, and so forth.
+
+![project-graph](/img/project-graph.svg)
+
+Nx analyzes your file system to detect projects. Projects are identified by the presence of a `package.json` file or `project.json` file. Projects identification can also be customized through plugins. You can manually define dependencies between
+the project nodes, but you don't have to do it very often. Nx analyzes files' source code, your installed dependencies, TypeScript
+files, and others figuring out these dependencies for you. Nx also stores the cached project graph, so it only
+reanalyzes the files you have changed.
+
+![project-graph-updated](/img/project-graph-updated.svg)
+
+Nx provides an updated graph after each analysis is done.
+
+## Metadata-driven
+
+Everything in Nx comes with metadata to enable toolability. Nx gathers information about your projects and tasks and then uses that information to help you understand and interact with your codebase. With the right plugins installed, most of the metadata can be [inferred directly from your existing configuration files](/concepts/inferred-tasks) so you don't have to define it manually.
+
+This metadata is used by Nx itself, by VSCode and WebStorm integrations, by GitHub integration, and by third-party
+tools.
+
+![metadata](/img/metadata.png)
+
+These tools are able to implement richer experiences with Nx using this metadata.
+
+## The task graph
+
+Nx uses the project graph to create a task graph. Any time you run anything, Nx creates a task graph from the project
+graph and then executes the tasks in that graph.
+
+For instance `nx test lib` creates a task graph with a single node:
+
+\{% graph height="100px" type="task" jsonFile="shared/mental-model/single-task.json" %}
+\{% /graph %}
+
+A task is an invocation of a target. If you invoke the same target twice, you create two tasks.
+
+Nx uses the [project graph](#the-project-graph), but the task graph and project graph aren't isomorphic, meaning they
+aren't directly connected. In the case above, `app1` and `app2` depend on `lib`, but
+running `nx run-many -t test -p app1 app2 lib`, the created task graph will look like this:
+\{% side-by-side %}
+
+**Project Graph**
+
+**Task Graph**
+
+\{% /side-by-side %}
+
+\{% side-by-side %}
+\{% graph height="200px" type="project" jsonFile="shared/mental-model/three-projects.json" %}
+\{% /graph %}
+
+\{% graph height="200px" type="task" jsonFile="shared/mental-model/disconnected-tasks.json"%}
+\{% /graph %}
+\{% /side-by-side %}
+
+Even though the apps depend on `lib`, testing `app1` doesn't depend on the testing `lib`. This means that the two tasks
+can
+run in parallel.
+
+Let's look at the test target relying on its dependencies.
+
+```json
+// project.json
+{
+  "test": {
+    "executor": "@nx/jest:jest",
+    "outputs": ["{workspaceRoot}/coverage/apps/app1"],
+    "dependsOn": ["^test"],
+    "options": {
+      "jestConfig": "apps/app1/jest.config.js",
+      "passWithNoTests": true
+    }
+  }
+}
+```
+
+With this, running the same test command creates the following task graph:
+
+\{% side-by-side %}
+
+**Project Graph**
+
+**Task Graph**
+
+\{% /side-by-side %}
+
+\{% side-by-side %}
+\{% graph height="200px" type="project" jsonFile="shared/mental-model/three-projects.json" %}
+\{% /graph %}
+
+\{% graph height="200px" type="task" jsonFile="shared/mental-model/connected-tasks.json" %}
+\{% /graph %}
+\{% /side-by-side %}
+
+This often makes more sense for builds, where to build `app1`, you want to build `lib` first. You can also define
+similar
+relationships between targets of the same project, including a test target that depends on the build.
+
+A task graph can contain different targets, and those can run in parallel. For instance, as Nx is building `app2`, it
+can be testing `app1` at the same time.
+
+![task-graph-execution](/img/task-graph-execution.svg)
+
+Nx also runs the tasks in the task graph in the right order. Nx executing tasks in parallel speeds up your overall
+execution time.
+
+## Affected commands
+
+When you run `nx test app1`, you are telling Nx to run the `app1:test` task plus all the tasks it depends on.
+
+When you run `nx run-many -t test -p app1 lib`, you are telling Nx to do the same for two
+tasks `app1:test`
+and `lib:test`.
+
+When you run `nx run-many -t test`, you are telling Nx to do this for all the projects.
+
+As your workspace grows, retesting all projects becomes too slow. To address this Nx implements code change analysis to
+get the min set of projects that need to be retested. How does it work?
+
+When you run `nx affected -t test`, Nx looks at the files you changed in your PR, it will look at the nature of
+change (what exactly did you update in those files), and it uses this to figure the list of projects in the workspace
+that can be affected by this change. It then runs the `run-many` command with that list.
+
+For instance, if my PR changes `lib`, and I then run `nx affected -t test`, Nx figures out that `app1` and `app2`
+depend on `lib`, so it will invoke `nx run-many -t test -p app1 app2 lib`.
+
+![affected](/img/affected.svg)
+
+Nx analyzes the nature of the changes. For example, if you change the version of Next.js in the package.json, Nx knows
+that `app2` cannot be affected by it, so it only retests `app1`.
+
+## Computation hashing and caching
+
+Nx runs the tasks in the task graph in the right order. Before running the task, Nx computes its computation hash. As
+long as the computation hash is the same, the output of running the task is the same.
+
+How does Nx do it?
+
+By default, the computation hash for say `nx test app1` includes:
+
+- All the source files of `app1` and `lib`
+- Relevant global configuration
+- Versions of external dependencies
+- [Runtime values provisioned by the user](/reference/inputs#runtime-inputs)
+- CLI Command flags
+
+![computation-hashing](/img/computation-hashing.svg)
+
+This behavior is customizable. For instance, lint checks may only depend on the source code of the project and global
+configs. Builds can depend on the `.d.ts` files of the compiled libs instead of their source.
+
+After Nx computes the hash for a task, it then checks if it ran this exact computation before. First, it checks locally,
+and then if it is missing, and if a remote cache is configured, it checks remotely.
+
+If Nx finds the computation, Nx retrieves it and replays it. Nx places the right files in the right folders and prints
+the terminal output. So from the user's point of view, the command ran the same, just a lot faster.
+
+![cache](/img/cache.svg)
+
+If Nx doesn't find this computation, Nx runs the task, and after it completes, it takes the outputs and the terminal
+output and stores it locally (and if configured remotely). All of this happens transparently, so you don't have to worry
+about it.
+
+Although conceptually this is fairly straightforward, Nx optimizes this to make this experience good for you. For
+instance, Nx:
+
+- Captures stdout and stderr to make sure the replayed output looks the same, including on Windows.
+- Minimizes the IO by remembering what files are replayed where.
+- Only shows relevant output when processing a large task graph.
+- Provides affordances for troubleshooting cache misses. And many other optimizations.
+
+As your workspace grows, the task graph looks more like this:
+
+\{% graph height="400px" type="task" jsonFile="shared/mental-model/large-tasks.json"%}
+\{% /graph %}
+
+All of these optimizations are crucial for making Nx usable for any non-trivial workspace. Only the minimum amount of
+work happens. The rest is either left as is or restored from the cache.
+
+## Distributed task execution
+
+Nx supports running commands across multiple machines. You can either set it up by hand or use Nx Cloud. [Read the comparison of the two approaches.](/blog/distributing-ci-binning-and-distributed-task-execution)
+
+When using the distributed task execution, Nx is able to run any task graph on many agents instead of locally.
+
+For instance, `nx affected --build` won't run the build locally (which can take hours for large workspaces). Instead,
+it will send the Task Graph to Nx Cloud. Nx Cloud Agents will then pick up the tasks they can run and execute them.
+
+Note that this happens transparently. If an agent builds `app1`, it will fetch the outputs for `lib` if it doesn't have
+them
+already.
+
+As agents complete tasks, the main job where you invoked `nx affected --build` will start receiving created files and
+terminal outputs.
+
+After `nx affected --build` completes, the machine will have the build files and all the terminal outputs as if it ran
+it locally.
+
+![Distribution](/img/dte.svg)
+
+## In summary
+
+- Nx is able to analyze your source code to create a Project Graph.
+- Nx can use the project graph and information about projects' targets to create a Task Graph.
+- Nx is able to perform code-change analysis to create the smallest task graph for your PR.
+- Nx supports computation caching to never execute the same computation twice. This computation cache is pluggable and
+  can be distributed.

astro-docs/src/content/docs/getting-started/ai-setup.mdoc

@@ -0,0 +1,50 @@
+---
+title: Integrate Nx with your Coding Assistant
+description: Set up Nx MCP server to give AI assistants deep workspace context, terminal integration, and enhanced development capabilities.
+sidebar:
+  order: 6
+  label: AI Integration
+---
+
+Nx provides deep integration with AI coding assistants through the **Nx Model Context Protocol (MCP) server**, giving your AI assistant comprehensive understanding of your monorepo structure, running processes, and development workflows.
+
+## Setup and Configuration
+
+### Automatic Setup with Nx Console
+
+Make sure you have **Nx Console** [installed in your editor](/getting-started/editor-setup), as it automatically exposes the Nx MCP server. Once Nx Console is installed and you open an Nx workspace, you'll receive a notification to **"Improve Copilot/AI agent with Nx-specific context"** - click **"Yes"** to automatically configure it.
+
+![VS Code showing the Nx MCP installation prompt](/img/copilot-mcp-install.avif)
+
+If you miss the notification, you can manually run the configuration by opening the command palette (`Ctrl/Cmd + Shift + P`) and running `nx.configureMcpServer`.
+
+### Manual Setup for Other AI Clients
+
+For MCP-compatible clients like **Claude Desktop**, **Cursor**, or other AI assistants, add the following configuration:
+
+```json
+// mcp.json
+{
+  "servers": {
+    "nx-mcp": {
+      "command": "npx",
+      "args": ["nx-mcp@latest", "/path/to/your/workspace"]
+    }
+  }
+}
+```
+
+Replace `/path/to/your/workspace` with your actual workspace path.
+
+## What This Integration Enables
+
+The Nx AI integration provides your coding assistant with powerful capabilities:
+
+- **[Workspace Structure Understanding](/blog/nx-mcp-vscode-copilot)** - Deep architectural awareness of your monorepo, project relationships, and dependencies
+- **[Real-time Terminal Integration](/blog/nx-terminal-integration-ai)** - AI can read your terminal output, running processes, and error messages without copy-pasting
+- **[CI Pipeline Context](/blog/nx-editor-ci-llm-integration)** - Access to build failures, test results, and deployment status from your CI/CD processes
+- **[Enhanced Code Generation](/blog/nx-generators-ai-integration)** - AI-powered generator suggestions and custom scaffolding with intelligent defaults
+- **Cross-project Impact Analysis** - Understanding the implications of changes across your entire monorepo
+- **Autonomous Error Debugging** - AI independently accesses context to help fix development issues
+
+Learn more about [why Nx and AI work so well together](/blog/nx-and-ai-why-they-work-together).

astro-docs/src/content/docs/getting-started/editor-setup.mdoc

@@ -0,0 +1,34 @@
+---
+title: Editor Integration
+description: Set up Nx Console in VSCode or JetBrains for visual UI, task management, code generation, and enhanced AI assistance in your Nx workspace.
+sidebar:
+  order: 5
+---
+
+Nx Console editor extensions make your developer experience richer. The extensions:
+
+- [enhance AI integrations](/features/enhance-AI) by providing workspace-level context and up-to-date docs
+- show [inferred tasks](/concepts/inferred-tasks) and help you invoke them via the Project Details View
+- provide a [visual UI for discovering and invoking generators](/recipes/nx-console/console-generate-command)
+- visualize dependencies between projects and tasks
+- and more!
+
+## Download
+
+### Official Integrations
+
+If you are using [VSCode](https://code.visualstudio.com/) or a [JetBrains IDE](https://www.jetbrains.com/) you can install Nx Console from their respective marketplaces. Nx Console for VSCode and JetBrains is **built and maintained by the Nx team**.
+
+\{ % install-nx-console /% }
+
+- [Install from the VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=nrwl.angular-console)
+- [Install from the JetBrains Marketplace](https://plugins.jetbrains.com/plugin/21060-nx-console)
+- [Contribute on GitHub](https://github.com/nrwl/nx-console)
+
+![Nx Console screenshot](/img/nx-console-screenshot.webp)
+
+### Neovim
+
+If you are using [Neovim](https://neovim.io/), you can install [Equilibris/nx.nvim](https://github.com/Equilibris/nx.nvim) with your favorite package manager.
+
+This plugin is **NOT** built or maintained by the Nx team. They are maintained by independent community contributors.

astro-docs/src/content/docs/getting-started/installation.mdoc

@@ -0,0 +1,131 @@
+---
+title: Installation
+description: Install Nx globally via npm, Homebrew, Chocolatey, or apt. Add Nx to existing repos with nx init and keep dependencies updated automatically.
+sidebar:
+    order: 2
+---
+
+To install Nx on your machine, choose one of the following methods based on your operating system and package manager. You can also use `npx` to run Nx without installing it globally.
+{% tabs %}
+{% tabitem label="npm" %}
+
+```shell
+npm add --global nx
+```
+
+**Note:** You can also use `yarn`, `pnpm`, or `bun`
+{% /tabitem %}
+
+{% tabitem label="Homebrew (macOS, Linux)" %}
+
+```shell
+brew install nx
+```
+
+{% /tabitem %}
+
+{% tabitem label="Chocolatey (Windows)" %}
+
+```shell
+choco install nx
+```
+
+{% /tabitem %}
+
+{% tabitem label="apt (Ubuntu)" %}
+
+```shell
+sudo add-apt-repository ppa:nrwl/nx
+sudo apt update
+sudo apt install nx
+```
+
+{% /tabitem %}
+{% /tabs %}
+{% tabs %}
+{% tabitem label="npm" %}
+
+```shell
+npm add --global nx
+```
+
+**Note:** You can also use `yarn`, `pnpm`, or `bun`
+{% /tabitem %}
+
+{% tabitem label="Homebrew (macOS, Linux)" %}
+
+```shell
+brew install nx
+```
+
+{% /tabitem %}
+
+{% tabitem label="Chocolatey (Windows)" %}
+
+```shell
+choco install nx
+```
+
+{% /tabitem %}
+
+{% tabitem label="apt (Ubuntu)" %}
+
+```shell
+sudo add-apt-repository ppa:nrwl/nx
+sudo apt update
+sudo apt install nx
+```
+
+{% /tabitem %}
+{% /tabs %}
+
+## Adding Nx to Your Repository
+
+To add Nx to an existing repository, run:
+
+```shell
+nx init
+```
+
+**Note:** You can also manually install the [`nx` NPM package](https://www.npmjs.com/package/nx) and create a [nx.json](/reference/nx-json) to configure it. Learn more about [adopting Nx in an existing project](/recipes/adopting-nx)
+
+### Starter Repository
+
+To create a starter repository, you can use the `create-nx-workspace` command. This will create a new Nx workspace with a default configuration and example applications.
+
+```shell
+npx create-nx-workspace@latest
+```
+
+## Update Nx
+
+When you update Nx, Nx will also [automatically update your dependencies](/features/automate-updating-dependencies) if you have an [Nx plugin](/concepts/nx-plugins) installed for that dependency. To update Nx, run:
+
+```shell
+nx migrate latest
+```
+
+This will create a `migrations.json` file with any update scripts that need to be run. Run them with:
+
+```shell
+nx migrate --run-migrations
+```
+
+{% aside type="tip" title="Update One Major Version at a Time" %}
+To avoid potential issues, it is [recommended to update one major version of Nx at a time](/recipes/tips-n-tricks/advanced-update#one-major-version-at-a-time-small-steps).
+{% /aside %}
+
+## Tutorials
+
+Try one of these tutorials for a full walkthrough of what to do after you install Nx:
+
+- [TypeScript Monorepo Tutorial](/getting-started/tutorials/typescript-packages-tutorial)
+- [React Monorepo Tutorial](/getting-started/tutorials/react-monorepo-tutorial)
+- [Angular Monorepo Tutorial](/getting-started/tutorials/angular-monorepo-tutorial)
+
+## More Documentation
+
+- [Add Nx to an Existing Repository](/recipes/adopting-nx)
+- [Update Nx](/features/automate-updating-dependencies)
+- [Update Your Global Nx Installation](/recipes/installation/update-global-installation)
+- [Install Nx in a Non-Javascript Repo](/recipes/installation/install-non-javascript)