appwrite / appwrite/runtimes

🐛 Bug Report: Node.js runtime is not compatible with Angular 20+

Open
#89 0 comments 0 reactions 0 assignees View on GitHub
bug
Dominant language
PHP
Stars
48
Forks
29
Avg merge
4d 12h
Merged PRs (30d)
3

Description

### 👟 Reproduction steps

### Reproduction steps

1. Create a new Angular project using the Angular CLI: `ng new my-angular-app`
2. Configure the project for deployment on Appwrite.
3. Attempt to deploy the application.
4. The build process fails with the following error message.

#### Logs
```shell
2025-07-26T00:08:23.564572796Z [00:08:23] [open-runtimes] Environment preparation started.
2025-07-26T00:08:23.587172409Z [00:08:23] [open-runtimes] Environment preparation finished.
2025-07-26T00:08:23.588195054Z [00:08:23] [open-runtimes] Build command execution started.
2025-07-26T00:08:51.403599391Z > site-mvp@0.0.0 prepare
2025-07-26T00:08:51.770517503Z > site-mvp@0.0.0 build
2025-07-26T00:08:51.770528431Z > ng build
2025-07-26T00:08:51.836204338Z Node.js version v22.9.0 detected.
2025-07-26T00:08:51.836247217Z The Angular CLI requires a minimum Node.js version of v20.19 or v22.12.
2025-07-26T00:08:51.836256354Z Please update your Node.js version or visit https://nodejs.org/ for additional instructions.
2025-07-26T00:08:57.000000000Z Build archive was not created.
```

### 👍 Expected behavior

The Appwrite build and deployment process should succeed, as Angular 20 is the current stable version of the framework. The Node.js runtime should be updated to a version that meets the requirements for Angular 20, such as Node.js v22.12.0 or a later LTS version.

### 👎 Actual Behavior

The current Node.js runtime environment provided by Appwrite for deployments is using a version of Node.js that is not compatible with Angular 20 and later versions. This causes build process to fail when deploying a new Angular application.

According to the documentation (see [compatibility matrix](https://angular.dev/reference/versions#actively-supported-versions)), Angular 20 requires Node.js version `^20.19.0` or `^22.12.0`. The Appwrite runtime appears to be using an older version, which results in an error.

```shell
2025-07-26T00:08:51.836204338Z Node.js version v22.9.0 detected.
2025-07-26T00:08:51.836247217Z The Angular CLI requires a minimum Node.js version of v20.19 or v22.12.
2025-07-26T00:08:51.836256354Z Please update your Node.js version or visit https://nodejs.org/ for additional instructions.
2025-07-26T00:08:57.000000000Z Build archive was not created.
```

### 🎲 PHP Runtimes version

Different version (specify in environment)

### 💻 Operating system

Something else

### 🧱 Your Environment

* OS: Any
* Browser: Any
* Framework: Angular 20+

### 👀 Have you spent some time to check if this issue has been raised before?

- [x] I checked and didn't find similar issue

### 🏢 Have you read the Code of Conduct?

- [x] I have read the [Code of Conduct](https://github.com/appwrite/appwrite/blob/HEAD/CODE_OF_CONDUCT.md)

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the Angular 20 compatibility matrix and the deployment logs showing Node.js v22.9.0. Inspect the runtime configuration that selects the Node.js version and reproduce an Angular 20 deployment; done means the runtime meets Angular's required Node.js version and the build archive is created.

Written by the indexing model from the issue text.

Assessment

Tech stack
angular, node.js
Domain
build-system, devops
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.