chore: use tsx when execution nx to have local plugins working

[BioPhoton]

Problem
This repository uses local Nx plugins and async generators written in TypeScript that need to:

• Import files with .js extensions (ES modules convention)
• Resolve TypeScript path aliases (e.g., @code-pushup/models)

Without proper TypeScript execution setup, Nx commands fail when trying to execute these local plugins/generators.

Solution
Explicit environment variable configuration for both local development and CI:

• Local Development - Use .env.local (gitignored)
• Developers copy .env.local.example to .env.local
• Nx automatically loads .env.local files

Background

Why SWC is skipped when running Nx with NODE_OPTIONS="--import tsx"

Nx has hardcoded transpiler-selection logic for local TS/TSX execution (plugins, executors, generators).
When running with a Node loader like tsx, Nx does not register SWC, even if SWC is available.

Relevant source:
https://github.com/nrwl/nx/blob/81c157d0631927b3d1891453aa45652f3b5a7988/packages/nx/src/plugins/js/utils/register.ts

Key logic:

export function registerTranspiler(
  compilerOptions: CompilerOptions,
  tsConfigRaw?: unknown
): () => void {
  const transpiler = getTranspiler(compilerOptions, tsConfigRaw);

  if (!transpiler) {
    warnNoTranspiler();
    return () => {};
  }

  return transpiler();
}

If getTranspiler(...) returns undefined, Nx intentionally does not register SWC or ts-node.

getTranspiler(...) only detects:

• @swc-node/register
• ts-node

Node loaders like tsx are not detected, so:

• getTranspiler(...) === undefined
• registerTranspiler becomes a no-op
• SWC is effectively disabled by design for this execution path

This is not in @nx/js:swc, but in Nx’s runtime TS/TSX plugin execution pipeline.
Running with NODE_OPTIONS="--import tsx" therefore bypasses SWC via hardcoded logic.

Related:

• refactor: add sync generator for zod2md tooling setup #1188
• refactor: add sync generator for zod2md tooling setup #1188 (comment)

Closes #1238

[nx-cloud]

View your CI Pipeline Execution ↗ for commit d73b906

Command	Status	Duration	Result
nx run ci:code-pushup -- merge-diffs --files=/h...	✅ Succeeded	5s	View ↗
nx run-many --targets=code-pushup --parallel=fa...	✅ Succeeded	1m 31s	View ↗
nx run-many --targets=code-pushup --parallel=fa...	✅ Succeeded	14m 26s	View ↗
nx run-many -t unit-test,int-test	✅ Succeeded	1m 51s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-02-09 10:51:32 UTC

[pkg-pr-new]

Open in StackBlitz

@code-pushup/ci

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/ci@1242

@code-pushup/cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/cli@1242

@code-pushup/core

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/core@1242

@code-pushup/create-cli

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/create-cli@1242

@code-pushup/nx-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/nx-plugin@1242

@code-pushup/axe-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/axe-plugin@1242

@code-pushup/models

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/models@1242

@code-pushup/coverage-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/coverage-plugin@1242

@code-pushup/eslint-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/eslint-plugin@1242

@code-pushup/js-packages-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/js-packages-plugin@1242

@code-pushup/jsdocs-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/jsdocs-plugin@1242

@code-pushup/lighthouse-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/lighthouse-plugin@1242

@code-pushup/typescript-plugin

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/typescript-plugin@1242

@code-pushup/utils

npm i https://pkg.pr.new/code-pushup/cli/@code-pushup/utils@1242

commit: d73b906

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 6e8a766 with previous commit 3137af7.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Categories

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Performance	🔴 40	🔴 37
Code coverage	🟢 93	🟢 93
Bug prevention	🟡 75	🟡 75
Axe Accessibility	🟡 88	🟡 88
Code style	🟢 100	🟢 100	–
Security	🔴 47	🔴 47	–
Updates	🟡 75	🟡 75	–
Type Safety	🟡 67	🟡 67	–
Miscellaneous	🟡 67	🟡 67	–
Documentation	🟡 53	🟡 53	–
Accessibility	🟢 92	🟢 92	–
Best Practices	🟢 100	🟢 100	–
SEO	🟢 92	🟢 92	–

👎 2 groups regressed, 👍 3 audits improved, 👎 6 audits regressed, 21 audits changed without impacting score

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
Lighthouse	Performance	🔴 40	🔴 37
Code coverage	Code coverage metrics	🟢 93	🟢 93

32 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Lighthouse	Initial server response time was short	🟥 Root document took 660 ms	🟩 Root document took 510 ms
Lighthouse	Properly size images	🟩 0	🟨 Potential savings of 5 KiB
Lighthouse	Total Blocking Time	🟥 1,040 ms	🟥 1,600 ms
Lighthouse	First Contentful Paint	🟥 3.3 s	🟥 3.1 s
Lighthouse	Max Potential First Input Delay	🟥 620 ms	🟥 1,010 ms
Lighthouse	Time to Interactive	🟥 13.1 s	🟥 13.4 s
Code coverage	Line coverage	🟩 92.8 %	🟩 92.7 %
Code coverage	Branch coverage	🟨 89.2 %	🟨 89.2 %
Code coverage	Function coverage	🟩 94.4 %	🟩 94.4 %
Lighthouse	Avoids enormous network payloads	🟩 Total size was 2,089 KiB	🟩 Total size was 2,108 KiB
Lighthouse	Uses efficient cache policy on static assets	🟨 31 resources found	🟨 32 resources found
Lighthouse	Minimizes main-thread work	🟥 8.1 s	🟥 9.8 s
Lighthouse	JavaScript execution time	🟥 2.1 s	🟥 3.3 s
Lighthouse	Server Backend Latencies	🟩 300 ms	🟩 1,000 ms
Lighthouse	Largest Contentful Paint	🟥 11.7 s	🟥 12.0 s
Lighthouse	Metrics	🟩 100%	🟩 100%
Lighthouse	Reduce unused JavaScript	🟥 Potential savings of 225 KiB	🟥 Potential savings of 191 KiB
Lighthouse	Remove duplicate modules in JavaScript bundles	🟥 Potential savings of 65 KiB	🟥 Potential savings of 89 KiB
Lighthouse	Network Round Trip Times	🟩 70 ms	🟩 20 ms
Lighthouse	Speed Index	🟥 6.8 s	🟥 6.8 s
Axe	Elements must only use supported ARIA attributes	🟩 103 elements	🟩 97 elements
Axe	ARIA attributes must be used as specified for the element's role	🟩 103 elements	🟩 97 elements
Axe	Elements must only use permitted ARIA attributes	🟩 103 elements	🟩 97 elements
Axe	ARIA attributes must conform to valid names	🟩 103 elements	🟩 97 elements
Axe	Inline text spacing must be adjustable with custom stylesheets	🟩 42 elements	🟩 45 elements
Axe	ARIA hidden element must not be focusable or contain focusable elements	🟩 202 elements	🟩 204 elements
Axe	Interactive controls must not be nested	🟩 60 elements	🟩 62 elements
Axe	Buttons must have discernible text	🟩 13 elements	🟩 14 elements
Axe	IDs used in ARIA and labels must be unique	🟩 28 elements	🟩 29 elements
Lighthouse	Cumulative Layout Shift	🟩 0.003	🟩 0

649 other audits are unchanged.

[github-actions]

Code PushUp

🤨 Code PushUp report has both improvements and regressions – compared current commit 6e8a766 with previous commit 3137af7.

💼 Project nx-plugin

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	🟢 91	🟢 92

5 other categories are unchanged.

👍 1 group improved, 👍 1 audit improved, 👎 2 audits regressed

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	Code coverage metrics	🟢 91	🟢 92

14 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Code coverage	Branch coverage	🟨 80.8 %	🟨 81.7 %
Code coverage	Line coverage	🟩 93.2 %	🟩 93 %
Code coverage	Function coverage	🟩 96.4 %	🟩 96.3 %

445 other audits are unchanged.

💼 Project utils

🥳 Code PushUp report has improved.

🕵️ See full comparison in Code PushUp portal 🔍

🏷️ Category	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	🟢 95	🟢 95
Documentation	🟡 61	🟡 61

4 other categories are unchanged.

👍 2 groups improved, 👍 1 audit improved

🗃️ Groups

🔌 Plugin	🗃️ Group	⭐ Previous score	⭐ Current score	🔄 Score change
Code coverage	Code coverage metrics	🟢 95	🟢 95
JSDocs coverage	Documentation coverage	🟡 61	🟡 61

13 other groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Code coverage	Branch coverage	🟩 91.9 %	🟩 91.9 %

443 other audits are unchanged.

💼 Project plugin-lighthouse

🤨 Code PushUp report has both improvements and regressions.

🕵️ See full comparison in Code PushUp portal 🔍

All of 6 categories are unchanged.

1 audit changed without impacting score

🗃️ Groups

All of 15 groups are unchanged.

🛡️ Audits

🔌 Plugin	🛡️ Audit	📏 Previous value	📏 Current value	🔄 Value change
Code coverage	Branch coverage	🟩 98.8 %	🟩 98.8 %

443 other audits are unchanged.

---

11 other projects are unchanged.