Keen Yee Liau 07bf174759 docs(@angular-devkit/schematics-cli): Add README
This commit adds a README for the package.
2021-04-14 12:30:18 -04:00

50 lines
1.5 KiB
Markdown

# Schematics CLI
This package contains the executable for running a [Schematic](/packages/angular_devkit/schematics/README.md).
# Usage
```
$ schematics [CollectionName:]SchematicName [options, ...]
By default, if the collection name is not specified, use the internal collection provided
by the Schematics CLI.
Options:
--debug Debug mode. This is true by default if the collection is a relative
path (in that case, turn off with --debug=false).
--allow-private Allow private schematics to be run from the command line. Default to
false.
--dry-run Do not output anything, but instead just show what actions would be
performed. Default to true if debug is also true.
--force Force overwriting files that would otherwise be an error.
--list-schematics List all schematics from the collection, by name. A collection name
should be suffixed by a colon. Example: '@angular-devkit/schematics-cli:'.
--no-interactive Disables interactive input prompts.
--verbose Show more information.
--help Show this message.
Any additional option is passed to the Schematics depending on its schema.
```
# Examples
1. Create a new NPM package that contains a blank schematic.
```sh
$ schematics blank <name>
```
2. Walkthrough example that demonstrates how to build a schematic.
```sh
$ schematics schematic --name <name>
```