Azure / Azure/static-web-apps-cli

Launch issues with Node 25.6

Open
#985 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
668
Forks
156
PR merge metrics
No merged PRs in 30d

Description

Before filing this issue, please ensure you're using the latest CLI by running `swa --version` and comparing to the latest version on [npm](https://www.npmjs.com/package/@azure/static-web-apps-cli).

**Are you accessing the CLI from the default port `:4280` ?**

- [ ] No, I am using a different port number (`--port`) and accessing the CLI from that port
- [X] Yes, I am accessing the CLI from port `:4280`

> Make sure you are accessing the URL printed in the console when running `swa start`!

**ℹ️ NOTE: Make sure to enable debug logs when running any `swa` commands using `--verbose=silly`**

**Describe the bug**
A clear and concise description of what the bug is.
`swa` fails to load under Node 25.6.0 due it compatibility issue with buffer-equa-constant-time and jwa package
```
yarn az:deploy
/Users//projects/myproject/node_modules/buffer-equal-constant-time/index.js:37
var origSlowBufEqual = SlowBuffer.prototype.equal;
^

TypeError: Cannot read properties of undefined (reading 'prototype')
at Object. (/Users//projects/myproject/node_modules/buffer-equal-constant-time/index.js:37:35)
at Module._compile (node:internal/modules/cjs/loader:1809:14)
at Object..js (node:internal/modules/cjs/loader:1940:10)
at Module.load (node:internal/modules/cjs/loader:1530:32)
at Module._load (node:internal/modules/cjs/loader:1332:12)
at wrapModuleLoad (node:internal/modules/cjs/loader:255:19)
at Module.require (node:internal/modules/cjs/loader:1553:12)
at require (node:internal/modules/helpers:152:16)
at Object. (/Users//projects/myproject/node_modules/jws/node_modules/jwa/index.js:1:19)
at Module._compile (node:internal/modules/cjs/loader:1809:14)
```
Note: `yarn az:deploy` is an alias for `swa build && swa deploy --env production`

Related: https://github.com/auth0/node-jsonwebtoken/issues/992

**To Reproduce**
Steps to reproduce the behavior:

1. Install Node 25.6.0 (I used mise)
2. `yarn swa -h`
3. Error thrown
4.
**Expected behavior**
`swa` tool does whatever you asked it to

**Screenshots**
If applicable, add screenshots to help explain your problem.
N/A

**Desktop (please complete the following information):**

- OS: [e.g. iOS] macOS 26.2
- Version [e.g. 22] Node 25.6.0, `"@azure/static-web-apps-cli": "^2.0.8"`

**Additional context**
Add any other context about the problem here.

Contributor guide

Open the contributing guide

Research direction

Start by reproducing the failure with Node 25.6.0 using `yarn swa -h`, after checking the CLI version with `swa --version`. Trace the dependency path through `buffer-equal-constant-time`, `jws`, and `jwa`; done means the CLI commands load successfully on Node 25.6.0 without the reported TypeError.

Written by the indexing model from the issue text.

Assessment

Tech stack
node.js
Domain
cli
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.