{"id":13406344,"url":"https://github.com/ngx-rocket/generator-ngx-rocket","last_synced_at":"2025-05-15T01:04:22.144Z","repository":{"id":38361575,"uuid":"57239556","full_name":"ngx-rocket/generator-ngx-rocket","owner":"ngx-rocket","description":":rocket: Extensible Angular 14+ enterprise-grade project generator","archived":false,"fork":false,"pushed_at":"2023-08-28T14:52:52.000Z","size":3695,"stargazers_count":1526,"open_issues_count":40,"forks_count":215,"subscribers_count":65,"default_branch":"main","last_synced_at":"2025-04-06T17:11:18.578Z","etag":null,"topics":["angular","angular-cli","bootstrap","cli","cordova","electron","generator","hacktoberfest","ionic","material","mobile","ngx","ngx-rocket","pwa","rocket","sass","seed","starter-kit","typescript","yeoman"],"latest_commit_sha":null,"homepage":"https://ngx-rocket.github.io/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ngx-rocket.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-04-27T19:11:10.000Z","updated_at":"2025-03-21T17:59:26.000Z","dependencies_parsed_at":"2022-08-09T03:15:29.227Z","dependency_job_id":null,"html_url":"https://github.com/ngx-rocket/generator-ngx-rocket","commit_stats":{"total_commits":1166,"total_committers":45,"mean_commits":25.91111111111111,"dds":0.5454545454545454,"last_synced_commit":"8e12c613076cae05dbff6ce6dbbdacce7847eb5d"},"previous_names":[],"tags_count":65,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngx-rocket%2Fgenerator-ngx-rocket","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngx-rocket%2Fgenerator-ngx-rocket/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngx-rocket%2Fgenerator-ngx-rocket/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ngx-rocket%2Fgenerator-ngx-rocket/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ngx-rocket","download_url":"https://codeload.github.com/ngx-rocket/generator-ngx-rocket/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248784775,"owners_count":21161177,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","angular-cli","bootstrap","cli","cordova","electron","generator","hacktoberfest","ionic","material","mobile","ngx","ngx-rocket","pwa","rocket","sass","seed","starter-kit","typescript","yeoman"],"created_at":"2024-07-30T19:02:27.754Z","updated_at":"2025-04-13T21:28:32.161Z","avatar_url":"https://github.com/ngx-rocket.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","cli","typescript","Awesome Angular [![Awesome TipeIO](https://img.shields.io/badge/Awesome%20Angular-@TipeIO-6C6AE7.svg)](https://github.com/gdi2290/awesome-angular) [![Awesome devarchy.com](https://img.shields.io/badge/Awesome%20Angular-@devarchy.com-86BDC1.svg)](https://github.com/brillout/awesome-angular-components)","angular"],"sub_categories":["Angular \u003ca id=\"angular\"\u003e\u003c/a\u003e"],"readme":"# :rocket: generator-ngx-rocket\n\n[![NPM version](https://img.shields.io/npm/v/generator-ngx-rocket.svg)](https://www.npmjs.com/package/generator-ngx-rocket)\n[![Build Status](https://sinedied.visualstudio.com/oss-pipelines/_apis/build/status/ngx-rocket.generator-ngx-rocket?branchName=main)](https://sinedied.visualstudio.com/oss-pipelines/_build?definitionId=2\u0026_a=summary\u0026repositoryFilter=2\u0026branchFilter=7\u0026WT.mc_id=generatorngxrocket-github-yolasors)\n![Node version](https://img.shields.io/node/v/generator-ngx-rocket.svg)\n[![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg)](https://github.com/sindresorhus/xo)\n[![Downloads](https://img.shields.io/npm/dm/generator-ngx-rocket.svg)](https://npmjs.org/package/generator-ngx-rocket)\n\n![ngx-rocket logo](https://user-images.githubusercontent.com/593151/28924751-08023b32-7863-11e7-9186-c17d4647d861.png)\n\n\u003e Extensible Angular 14+ enterprise-grade project generator based on\n\u003e [angular-cli](https://github.com/angular/angular-cli) with best practices from the community.\n\u003e Includes PWA, Cordova \u0026 Electron support, coding guides and more!\n\nSee generated project example [here](https://github.com/ngx-rocket/starter-kit).\n\n### Benefits versus bare `angular-cli` projects\n\n- **A complete starter template:** example app structure tailored for scalability, with examples and boilerplate code\n  for every common thing needed in enterprise projects, such as unit tests, routing, authentication, HTTPS service\n  extensions, i18n support with dynamic language change and automatic user language detection...\n\n- **Improved tooling:** SCSS \u0026 HTML linting, stricter TSLint rules, markdown-based local wiki server for documentation,\n  automated localizable strings extraction, corporate proxy support, [Cordova](https://cordova.apache.org) integration\n\n- **Extensive base documentation:** [coding guides](#coding-guides) for TypeScript/SCSS/HTML, Angular onboarding guide,\n  corporate proxy and other tools [configuration and usage](#other-documentation)...\n\n- **Ready-to-use UI components:** focus on your app, not on the stack! [Choose](#libraries) between a\n  [Bootstrap 5](https://getbootstrap.com/), [Ionic](http://ionicframework.com) or\n  [Angular Material](https://material.angular.io) based UI with nicely looking, responsive starter templates\n\n- **Mobile/desktop hybrid app support:** choose between a web app, a mobile app (using [Cordova](https://cordova.apache.org)),\n  a desktop app (using [Electron](https://electronjs.org)) or all at the same time using the same code base\n\n- **API proxy example setup:** develop and debug faster using any remote server\n\n- **Generator output customization:** with the provided\n  [add-on support](https://github.com/ngx-rocket/generator-ngx-rocket/tree/main/generators/addon), start multiple\n  projects even faster by plugging in additions that fit your needs, such as your enterprise theme, SSO authentication,\n  services integrations...\n\nAnd there's even more! See [What's in the box](#whats-in-the-box) for more details.\n\n# Getting started\n\n## Using [ngX-Rocket CLI](https://github.com/ngx-rocket/generator-ngx-rocket/tree/main/cli)\n\n1. Install required tools:\n ```sh\n npm install -g generator-ngx-rocket\n ```\n\n2. Create your application:\n ```sh\n ngx new\n ```\n \n\u003e :bulb: Pro tip: the `ngx` CLI can do more that just bootstrapping new projects! You can use it to run your\n\u003e NPM scripts with fuzzy matching (try `ngx ci` for example) or help you maintaining your project up-to-date.\n\u003e Take a look at the [full documentation](https://github.com/ngx-rocket/generator-ngx-rocket/tree/main/cli)!\n\n# Project structure\n\nThe structure follows [Angular style guide](https://angular.io/guide/styleguide).\n\n```\ndist/                        app production build\ndocs/                        project docs and coding guides\ncypress/                     end-to-end tests\nsrc/                         project source code\n|- app/                      app components\n|  |- @shared/               shared module  (common components, directives, pipes and services)\n|  |- app.component.*        app root component (shell)\n|  |- app.module.ts          app root module definition\n|  |- app-routing.module.ts  app routes\n|  +- ...                    additional modules and components\n|- assets/                   app assets (images, fonts, sounds...)\n|- environments/             values for various build environments\n|- theme/                    app global scss variables and theme\n|- translations/             translations files\n|- index.html                html entry point\n|- main.scss                 global style entry point\n|- main.ts                   app entry point\n|- polyfills.ts              polyfills needed by Angular\n+- test.ts                   unit tests entry point\nreports/                     test and coverage reports\nproxy.conf.js                backend proxy configuration\n```\n\n# Main tasks\n\nTask automation is based on [NPM scripts](https://docs.npmjs.com/misc/scripts).\n\nTask                            | Description\n--------------------------------|---------------------------------------------------------------------------------------\n`npm start`                     | Run development server on `http://localhost:4200/`\n`npm run serve:sw`              | Run test server on `http://localhost:4200/` with service worker enabled\n`npm run build [-- --configuration=production]` | Lint code and build web app for production (with [AOT](https://angular.io/guide/aot-compiler)) in `dist/`\n`npm test`                      | Run unit tests via [Karma](https://karma-runner.github.io) or [Jest](https://jestjs.io/) in watch mode\n`npm run test:ci`               | Lint code and run unit tests once for continuous integration\n`npm run e2e`                   | Run e2e tests using [Cypress](https://cypress.io)\n`npm run lint`                  | Lint code\n`npm run translations:extract`  | Extract strings from code and templates to `src/app/translations/template.json`\n`npm run docs`                  | Display project documentation\n\nAdditional tasks for Cordova-based projects:\n\nTask                            | Description\n--------------------------------|---------------------------------------------------------------------------------------\n`npm run cordova:prepare`       | Prepare for building mobile app (restore Cordova platforms and plugins)\n`npm run cordova:run \u003cios/android\u003e [--device]`          | Run app on target platform device or simulator\n`npm run cordova:build [-- --configuration=production]` | Build mobile app for production in `dist/` folder\n`npm run cordova:clean`         | Removes `www/`, `platforms/` and `plugins/` folders\n\nAdditional tasks for Electron-based projects:\n\nTask                            | Description\n--------------------------------|---------------------------------------------------------------------------------------\n`npm run electron:build`        | Build desktop app\n`npm run electron:run`          | Run app on electron\n`npm run electron:package`      | Package app for all supported platforms\n\nWhen building the application, you can specify the target configuration using the additional flag\n`--configuration \u003cname\u003e` (do not forget to prepend `--` to pass arguments to npm scripts).\n\nThe default build configuration is `production`.\n\n## Development server\n\nRun `npm start` for a dev server. Navigate to `http://localhost:4200/`. The app will automatically reload if you change\nany of the source files.\nYou should not use `ng serve` directly, as it does not use the backend proxy configuration by default.\n\n## Code scaffolding\n\nRun `npm run generate -- component \u003cname\u003e` to generate a new component. You can also use\n`npm run generate -- directive|pipe|service|class|module`.\n\nIf you have installed [angular-cli](https://github.com/angular/angular-cli) globally with `npm install -g @angular/cli`,\nyou can also use the command `ng generate` directly.\n\n# What's in the box\n\n![starter kit](https://cloud.githubusercontent.com/assets/593151/23604024/a9729c78-0257-11e7-8c60-0882a98bad41.png)\n\nThe app template is based on [HTML5](http://whatwg.org/html), [TypeScript](http://www.typescriptlang.org) and\n[Sass](http://sass-lang.com). The translation files use the common [JSON](http://www.json.org) format.\n\n#### Tools\n\nDevelopment, build and quality processes are based on [angular-cli](https://github.com/angular/angular-cli) and\n[NPM scripts](https://docs.npmjs.com/misc/scripts), which includes:\n\n- Optimized build and bundling process with [Webpack](https://webpack.js.org/)\n- [Development server](https://webpack.js.org/configuration/dev-server/) with backend proxy and live reload\n- Cross-browser CSS with [autoprefixer](https://github.com/postcss/autoprefixer) and\n  [browserslist](https://github.com/ai/browserslist)\n- Asset revisioning for [better cache management](https://webpack.js.org/guides/caching/)\n- Unit tests using [Jasmine](http://jasmine.github.io), [Karma](https://karma-runner.github.io) and\n  [headless Chrome](https://github.com/GoogleChrome/puppeteer)\n- End-to-end tests using [Cypress](https://cypress.io) or [Protractor](https://github.com/angular/protractor)\n- Static code analysis: [TSLint](https://github.com/palantir/tslint), [Codelyzer](https://github.com/mgechev/codelyzer),\n  [Stylelint](http://stylelint.io) and [HTMLHint](http://htmlhint.com/)\n- Local knowledgebase server using [Hads](https://github.com/sinedied/hads)\n- Automatic code formatting with [Prettier](https://prettier.io)\n- Deployment with the CLI using [ng deploy](https://angular.io/guide/deployment)\n\n[Progressive Web App (PWA)](https://developers.google.com/web/progressive-web-apps/) support provided by\n[@angular/service-worker](https://docs.google.com/document/d/1F0e0ROaZUnTFftmC0XovpREHWHjcXa4CggiFlmifjhw/).\n\nNative mobile application bundling is based on [Cordova](https://cordova.apache.org).\n[Ionic WKWebView](https://github.com/ionic-team/cordova-plugin-ionic-webview) is used for iOS for better performance.\n\n#### Libraries\n\n- [Angular](https://angular.io)\n- [RxJS](http://reactivex.io/rxjs)\n- [ngx-translate](https://github.com/ngx-translate/core)\n- UI based on:\n  * Bootstrap\n    - [Bootstrap 4](https://getbootstrap.com)\n    - [ng-bootstrap](https://ng-bootstrap.github.io/)\n    - [Font Awesome](http://fontawesome.io)\n  * Ionic:\n    - [Ionic](http://ionicframework.com)\n    - [Ionic Native](https://ionicframework.com/docs/native/)\n  * Angular Material\n    - [Angular Material](https://material.angular.io)\n    - [Angular Flex Layout](https://github.com/angular/flex-layout)\n    - [Material Icons](https://material.io/icons/)\n- Optional utility libraries:\n  * [Lodash](https://lodash.com)\n  * [Ramda](https://ramdajs.com)\n  * [Moment.js](https://momentjs.com)\n  * [Date-fns](https://date-fns.org)\n  * [Jest](https://jestjs.io/)\n\n\n#### Coding guides\n\n- [Angular](https://github.com/ngx-rocket/starter-kit/blob/main/docs/coding-guides/angular.md)\n- [Ionic](https://github.com/ngx-rocket/starter-kit/blob/cordova/ionic/docs/coding-guides/ionic.md)\n- [TypeScript](https://github.com/ngx-rocket/starter-kit/blob/main/docs/coding-guides/typescript.md)\n- [Sass](https://github.com/ngx-rocket/starter-kit/blob/main/docs/coding-guides/sass.md)\n- [HTML](https://github.com/ngx-rocket/starter-kit/blob/main/docs/coding-guides/html.md)\n- [Unit tests](https://github.com/ngx-rocket/starter-kit/blob/main/docs/coding-guides/unit-tests.md)\n- [End-to-end tests](https://github.com/ngx-rocket/starter-kit/blob/main/docs/coding-guides/e2e-tests.md)\n\n#### Other documentation\n\n- [I18n guide](https://github.com/ngx-rocket/starter-kit/blob/main/docs/i18n.md)\n- [Working behind a corporate proxy](https://github.com/ngx-rocket/starter-kit/blob/main/docs/corporate-proxy.md)\n- [Updating dependencies and tools](https://github.com/ngx-rocket/starter-kit/blob/main/docs/updating.md)\n- [Using a backend proxy for development](https://github.com/ngx-rocket/starter-kit/blob/main/docs/backend-proxy.md)\n- [Browser routing](https://github.com/ngx-rocket/starter-kit/blob/main/docs/routing.md)\n- [Cordova](https://github.com/ngx-rocket/starter-kit/blob/cordova/ionic/docs/cordova.md)\n- [Electron](https://github.com/ngx-rocket/starter-kit/blob/electron/ionic/docs/electron.md)\n\n## Generator options\n\n- `--packageManager [npm|yarn]`: specify whether to use [Yarn](https://yarnpkg.com) or NPM as your package manager\n (default is NPM).\n You can also use the environment variable `NGX_PACKAGE_MANAGER` to set this option globally.\n- `--automate \u003cjson_file\u003e`: automate prompt answers using specified JSON file (see\n  [here](https://github.com/ngx-rocket/generator-ngx-rocket/tree/main/scripts/tests) for examples).\n- `--addons \u003caddon_name\u003e [\u003caddon_name\u003e] ...`: space-separated list of add-ons to use.\n- `--no-update`: do no update existing project (see also [updating generated projects](#updating-generated-projects)).\n- `--no-analytics`: do not report anonymous usage analytics.\n  You can also use the environment variable `NGX_DISABLE_ANALYTICS` to set this option globally.\n- `--raw`: do not use any UI library for templates.\n- `--tools`: generate only the toolchain, without application template.\n- `--location-strategy [hash|path]`: [location strategy](https://angular.io/api/common/LocationStrategy) to use in\n  Angular router (default is `path`).\n- `--no-git`: do not initialize git repository.\n- `--no-strict`: disable TypeScript strict type checking options.\n- `--skip-quickstart`: disable quick start message after project generation.\n- `--no-prefix`: do not add `@` prefix to `core`/`shared` folders.\n- `--deploy \u003coption\u003e`: choose automatic deployment option. Use `ngx n --deploy` to see possible values.\n  \nWhen generating a *fullstack* project (with both client and server code), you can use the environment variables\n`NGX_CLIENT_PATH` and `NGX_SERVER_PATH` to customize the paths for client and server code. Be aware though that some\nadd-ons may force specific paths that will preempt your changes.\n\n## Updating generated projects\n\nAs new features and newer libraries and tools are added to the generator, you may want to update your project at some\npoint. Here is how we suggest you to do it:\n\n1. Make sure your working directory is clean (no pending / uncommited changes).\n2. Run `ngx update` using the [CLI](cli/README) inside your project folder.\n3. The generator will then run again using the same options you used initially, prompting you for each file change.\n   From there the recommended approach is simply to overwrite everything.\n4. Finally, use your source control to see the diff for each file and merge the changes manually.\n\n\u003e Note: you can use the `--tools` option to generate only the toolchain and not application templates, thus reducing\n\u003e the number of changes to merge.\n\n## Customize project generation\n\nYou can customize the generator output to change or enhance it to better suit your needs using\n[add-ons](https://www.npmjs.com/search?q=ngx-rocket-addon).\n\nTo create a new add-on, you can use the `addon` sub-generator of the [CLI](https://github.com/ngx-rocket/generator-ngx-rocket/tree/main/cli):\n```sh\nngx new --addon\n```\n\nSee the [add-on generator documentation](https://github.com/ngx-rocket/generator-ngx-rocket/tree/main/generators/addon)\nfor more information about add-on creation.\n\n# Contributing\n\nFirst time contributors are welcome in this project! 🎉\n\nTo get started, take a look at the [contributing guide](CONTRIBUTING.md).\nIf you want to help and don't know what you can do, look for [good first contribution issues](https://github.com/ngx-rocket/generator-ngx-rocket/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+contribution%22), or if you're a seasoned OSS contributor look for [PR welcome tags](https://github.com/ngx-rocket/generator-ngx-rocket/issues?q=is%3Aopen+is%3Aissue+label%3A%22PR+welcome%22).\n\nThanks for helping ❤️\n\n# License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngx-rocket%2Fgenerator-ngx-rocket","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fngx-rocket%2Fgenerator-ngx-rocket","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fngx-rocket%2Fgenerator-ngx-rocket/lists"}