@angular/cli
Advanced tools
Package description
The @angular/cli package is a command-line interface tool that you can use to initialize, develop, scaffold, and maintain Angular applications directly from a command shell. It provides commands for creating new projects, generating application and library code, performing a variety of ongoing development tasks such as testing, bundling, and deployment.
Project Scaffolding
Creates a new Angular application with a default structure by running the 'ng new' command followed by the project name.
ng new my-angular-appGenerating Components, Services, and other features
Generates a new component and its associated files by using the 'ng generate' command followed by the feature type and name.
ng generate component my-componentBuilding and Serving the Application
Compiles the application and starts a web server, making the app accessible in a browser. The 'ng serve' command is used for this purpose.
ng serveRunning Unit Tests
Executes the unit tests defined in the application using the 'ng test' command.
ng testBuilding for Production
Compiles the application for production deployment, optimizing the build for performance and size using the 'ng build' command with the '--prod' flag.
ng build --prodSimilar to @angular/cli, create-react-app is a command-line interface for setting up new React applications. It abstracts away build configuration to a pre-configured setup, allowing developers to focus on writing code. Unlike @angular/cli, it is tailored specifically for React and does not provide an extensive set of generation commands.
Vue CLI is a full system for rapid Vue.js development, similar to @angular/cli for Angular. It provides project scaffolding, a development server, build tools, and a set of plugins for common tasks. Vue CLI is designed for Vue.js and offers a similar level of functionality for Vue developers.
Ember CLI is a command-line utility for creating, developing, and building Ember.js applications. It provides a standardized development structure and build pipeline, much like @angular/cli does for Angular. Ember CLI focuses on Ember.js and has a strong emphasis on convention over configuration.
Changelog
18.0.0 (2024-05-22)
ng doc command has been removed without a replacement. To perform searches, please visit www.angular.devBy default, the index.html file is no longer emitted in the browser directory when using the application builder with SSR. Instead, an index.csr.html file is emitted. This change is implemented because in many cases server and cloud providers incorrectly treat the index.html file as a statically generated page. If you still require the old behavior, you can use the index option to specify the output file name.
"architect": {
"build": {
"builder": "@angular-devkit/build-angular:application",
"options": {
"outputPath": "dist/my-app",
"index": {
"input": "src/index.html",
"output": "index.html"
}
}
}
}
The support for the legacy Sass build pipeline, previously accessible via NG_BUILD_LEGACY_SASS when utilizing webpack-based builders, has been removed.
NodePackageLinkTask in @angular-devkit/schematics. A custom task should be created instead.| Commit | Type | Description |
| --------------------------------------------------------------------------------------------------- | -------- | --------------------------------------------------------- |
| ac3019570 | feat | add ng dev alias to ng serve |
| 4087728c3 | feat | support for Node.js v22 |
| 41ab6c8c3 | fix | add --version option |
| df4dde95d | fix | add @angular/build package to update group list |
| 1039f6d79 | fix | change update guide link to angular.dev |
| f4670fcb1 | fix | eliminate prompts during ng version command |
| a99ec6a54 | fix | keep cli package first in update package group metadata |
| dd786d495 | fix | only add --version option on default command |
| 03eee0545 | refactor | remove ng doc command |
| c7b208555 | refactor | remove support for Node.js versions <18.19.1 and <20.11.1 |
| Commit | Type | Description |
| --------------------------------------------------------------------------------------------------- | ---- | ------------------------------------------------------------------------------- |
| b2ac5fac7 | feat | allow application migration to use new build package in projects where possible |
| 6530aa11b | feat | replace assets with public directory |
| 725883713 | feat | use eventCoalescing option by default (standalone bootstrap) |
| 508d97da7 | feat | use ngZoneEventCoalescing option by default (module bootstrap) |
| f452589e2 | feat | use TypeScript bundler module resolution for new projects |
| 95a4d6ee5 | fix | add less dependency in application migration if needed |
| c46aa084f | fix | add postcss dependency in application migration if needed |
| 157329384 | fix | add spaces around eventCoalescing option |
| 23cc337aa | fix | keep deployUrl option when migrating to application builder |
| Commit | Type | Description | | --------------------------------------------------------------------------------------------------- | ---- | ----------------------------------------------- | | ddd08efef | fix | resolve builder aliases from containing package |
| Commit | Type | Description |
| --------------------------------------------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------- |
| 53c319aaa | feat | add support for the poll option in the library builder |
| 83d1d233a | feat | enhance Sass rebasing importer for resources URL defined in variables and handling of external paths |
| d51cb598a | feat | inject event-dispatch in SSR HTML page |
| 0b03829bc | feat | move i18n extraction for application builder to new build system package |
| 4ffe07aa2 | feat | move Vite-based dev-server for application builder to new build system package |
| d1c632af9 | feat | support native async/await when app is zoneless |
| 37fc7f0cc | fix | disable Vite prebundling when script optimizations are enabled |
| 2acf95a94 | fix | do not generate an index.html file in the browser directory when using SSR. |
| 8a54875cb | fix | handle wrapping of class expressions emitted by esbuild |
| 97973059e | refactor | remove Sass legacy implementation |
| Commit | Type | Description |
| --------------------------------------------------------------------------------------------------- | -------- | ------------------------------- |
| 797584583 | refactor | deprecate NodePackageLinkTask |
| Commit | Type | Description |
| --------------------------------------------------------------------------------------------------- | ---- | ------------------------------------------------------------------------------------ |
| 810d213e1 | feat | introduce new official build system package |
| b7a0792b3 | fix | add a maximum rendering timeout for SSG |
| 411115303 | fix | add console note about development server raw file size |
| 921fa7cf4 | fix | add missing ansi-colors and picomatch dependencies |
| 791cf75af | fix | check both potential build packages in Angular version check |
| 4d7cd5e3e | fix | correctly wrap class expressions with static properties or blocks emitted by esbuild |
| 57f448a0f | fix | decode URL pathname decoding during SSG fetch |
| 940e382db | fix | disable Vite prebundling when script optimizations are enabled |
| 70dbc7a6e | fix | emit error for invalid self-closing element in index HTML |
| 44b401747 | fix | ensure input index HTML file triggers rebuilds when changed |
| dff4deaeb | fix | ensure recreated files are watched |
| 17931166d | fix | format sizes using decimal byte units consistently |
| 2085365e0 | fix | only generate shallow preload links for initial files |
| 33cd47c85 | fix | properly configure headers for media resources and HTML page |
| d10fece2c | fix | properly rebase Sass url() values with leading interpolations |
| 3f2963835 | perf | add persistent caching of JavaScript transformations |
| a15eb7d1c | perf | improve rebuild time for file loader usage with prebundling |
<a name="17.3.8"></a>
Readme
The sources for this package are in the Angular CLI repository. Please file issues and pull requests against that repository.
Usage information and reference details can be found in repository README file.
FAQs
CLI tool for Angular
The npm package @angular/cli receives a total of 2,516,193 weekly downloads. As such, @angular/cli popularity was classified as popular.
We found that @angular/cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.
Security News
A JavaScript library maintainer is under fire after merging a controversial PR to support legacy versions of Node.js.
Security News
Results from the 2023 State of JavaScript Survey highlight key trends, including Vite's dominance, rising TypeScript adoption, and the enduring popularity of React. Discover more insights on developer preferences and technology usage.