@solidgiant/ngx-sg-ws
v1.0.3
Published
NPM package that splits a large angular.json into modular and smaller project-local files
Maintainers
Readme
ngx-sg-ws
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-sg-ws globally (using your preferred package manager):
npm install -g @solidgiant/ngx-sg-ws
# or
pnpm add -g @solidgiant/ngx-sg-ws
# or
yarn global add @solidgiant/ngx-sg-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-sg-ws --buildThis 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-sg-ws -vThis 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-sg-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-sg-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 |
