🚀 ngx-ws

Security notice

Versions 1.1.5 and 1.1.6 of this package were published with malicious code on 15 September 2025, when the npm account that publishes it was compromised in the Shai-Hulud supply-chain campaign. The registry removed them from npm; they cannot be installed.

Full write-up of the incident — every affected package and version, the timeline, and how to check your own project: https://art-ws.org/security/2025-09-shai-hulud/

Generate angular.json from modular, human-friendly definitions.

Easily split a large angular.json into modular, project-local files using the power of JSON References, with the convenience of YAML and JSON5 formats.

🛠️ How It Works

1. Install ngx-ws globally (using your preferred package manager):

npm install -g ngx-ws
# or
pnpm add -g ngx-ws
# or
yarn global add ngx-ws

2. Navigate to your Angular project directory (where angular.json is located):

cd your-angular-project

3. Initialize modular configuration files from your existing angular.json:

ngx-ws --build

This generates angular-workspace.yaml and angular-project.yaml files.

4. Edit your configuration in the new YAML files.
   You can now manage your workspace and project settings in a modular, human-friendly format.

5. Regenerate angular.json after making changes:

ngx-ws -v

This will update angular.json based on your YAML definitions.

Tip:
Once set up, you can focus on editing angular-workspace.yaml and angular-project.yaml.
Let ngx-ws handle the generation of angular.json for you!

✨ Features

• 📝 Supports YAML and JSON5 formats
• 🔗 Handles JSON References for modular configuration
• 🔄 Recursive variable interpolation for flexible templating
• 🛠️ Simplifies configuration of scripts, styles, and assets

🧩 Example

See the ngx-ws-example repository.
Pay special attention to angular-workspace.yaml and angular-project.yaml.

⚙️ Options

| Option | Alias | Description | | -------------- | ----- | ------------------------------------------------------------------ | | --build | | Build files from angular.json | | --deps | | Update package.json with project-specific dependencies | | --debug | | Enable debug mode (retain temporary files) | | --dry-run | | Preview changes without writing files | | --verbose |-v | Enable verbose output | | --version | | Print version |