🚀 ngx-ws
June 14, 2025 · View on GitHub
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
- 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
- Navigate to your Angular project directory (where
angular.jsonis located):
cd your-angular-project
- Initialize modular configuration files from your existing
angular.json:
ngx-ws --build
This generates angular-workspace.yaml and angular-project.yaml files.
-
Edit your configuration in the new YAML files.
You can now manage your workspace and project settings in a modular, human-friendly format. -
Regenerate
angular.jsonafter 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 |