All Projects β†’ ngx-rocket β†’ Generator Ngx Rocket

ngx-rocket / Generator Ngx Rocket

Licence: mit
πŸš€ Extensible Angular 11+ enterprise-grade project generator

Programming Languages

typescript
32286 projects

Projects that are alternatives of or similar to Generator Ngx Rocket

Starter Kit
πŸ“¦ Angular 11+ starter kit for enterprise-grade projects
Stars: ✭ 1,102 (-17.08%)
Mutual labels:  starter-kit, seed, rocket, material, ionic, bootstrap, sass, angular-cli, ngx
Generator Jekyll Starter Kit
πŸš€ Jekyll Progressive Web App Generator.
Stars: ✭ 139 (-89.54%)
Mutual labels:  starter-kit, seed, generator, yeoman
Preact Cli
😺 Your next Preact PWA starts in 30 seconds.
Stars: ✭ 4,510 (+239.35%)
Mutual labels:  cli, hacktoberfest, starter-kit, pwa
Ajsf
Angular JSON Schema Form
Stars: ✭ 266 (-79.98%)
Mutual labels:  hacktoberfest, material, bootstrap, angular-cli
The forge
Our groundbreaking, lightning fast PWA CLI tool
Stars: ✭ 70 (-94.73%)
Mutual labels:  cli, generator, mobile, pwa
Backslide
πŸ’¦ CLI tool for making HTML presentations with Remark.js using Markdown
Stars: ✭ 679 (-48.91%)
Mutual labels:  cli, hacktoberfest, sass
Laravel Boilerplate
Laravel Boilerplate / Starter Kit with Gentelella Admin Theme
Stars: ✭ 704 (-47.03%)
Mutual labels:  hacktoberfest, starter-kit, bootstrap
Echoes Player
Echoes Player: the missing Media Player experience for Youtube - Built with Angular (9), ngrx (9), Angular CLI, Boostrap (SASS), Youtube api
Stars: ✭ 802 (-39.65%)
Mutual labels:  bootstrap, sass, angular-cli
Webxr Webpack Boilerplate
Starter Kit for building rich, immersive WebXR projects (featuring A-Frame) PWA with Webpack and SASS
Stars: ✭ 48 (-96.39%)
Mutual labels:  starter-kit, sass, pwa
Cordova Js
Apache Cordova JavaScript Bridge
Stars: ✭ 598 (-55%)
Mutual labels:  hacktoberfest, mobile, cordova
Ionic4
This repo contains example code for ionic4. Get Step by Step tutorial of this repo examples using https://ampersandacademy.com/tutorials/ionic-framework-4
Stars: ✭ 37 (-97.22%)
Mutual labels:  mobile, cordova, ionic
Reason App Shell Starter Kit
A simple App Shell starter kit that you can use to get started building your PWA with ReasonML & ReasonReact.
Stars: ✭ 49 (-96.31%)
Mutual labels:  starter-kit, sass, pwa
Generator M Ionic
Advanced workflows and setup for building rock-solid Ionic apps
Stars: ✭ 677 (-49.06%)
Mutual labels:  cordova, ionic, sass
Faker
Faker is a pure Elixir library for generating fake data.
Stars: ✭ 673 (-49.36%)
Mutual labels:  hacktoberfest, seed, generator
Ng Zorro Antd Mobile
A configurable Mobile UI components based on Ant Design Mobile and Angular. 🐜
Stars: ✭ 709 (-46.65%)
Mutual labels:  mobile, ionic, ngx
Capacitor
Build cross-platform Native Progressive Web Apps for iOS, Android, and the Web ⚑️
Stars: ✭ 6,598 (+396.46%)
Mutual labels:  cordova, ionic, pwa
Aurelia
Aurelia 2, a standards-based, front-end framework designed for high-performing, ambitious applications.
Stars: ✭ 995 (-25.13%)
Mutual labels:  mobile, cordova, pwa
Vue Storefront
The open-source frontend for any eCommerce. Built with a PWA and headless approach, using a modern JS stack. We have custom integrations with Magento, commercetools, Shopware and Shopify and total coverage is just a matter of time. The API approach also allows you to merge VSF with any third-party tool like CMS, payment gateways or analytics. Ne…
Stars: ✭ 9,111 (+585.55%)
Mutual labels:  hacktoberfest, mobile, pwa
Ng Dynamic Forms
Rapid form development library for Angular
Stars: ✭ 1,146 (-13.77%)
Mutual labels:  material, ionic, bootstrap
Onsenui
Mobile app development framework and SDK using HTML5 and JavaScript. Create beautiful and performant cross-platform mobile apps. Based on Web Components, and provides bindings for Angular 1, 2, React and Vue.js.
Stars: ✭ 8,518 (+540.93%)
Mutual labels:  material, cordova, pwa

πŸš€ generator-ngx-rocket

NPM version Build Status Node version XO code style Downloads

ngx-rocket logo

Extensible Angular 11+ enterprise-grade project generator based on angular-cli with best practices from the community. Includes PWA, Cordova & Electron support, coding guides and more!

See generated project example here.

Benefits versus bare angular-cli projects

  • A complete starter template: example app structure tailored for scalability, with examples and boilerplate code for every common thing needed in enterprise projects, such as unit tests, routing, authentication, HTTPS service extensions, i18n support with dynamic language change and automatic user language detection...

  • Improved tooling: SCSS & HTML linting, stricter TSLint rules, markdown-based local wiki server for documentation, automated localizable strings extraction, corporate proxy support, Cordova integration

  • Extensive base documentation: coding guides for TypeScript/SCSS/HTML, Angular onboarding guide, corporate proxy and other tools configuration and usage...

  • Ready-to-use UI components: focus on your app, not on the stack! Choose between a Bootstrap 4, Ionic or Angular Material based UI with nicely looking, responsive starter templates

  • Mobile/desktop hybrid app support: choose between a web app, a mobile app (using Cordova), a desktop app (using Electron) or all at the same time using the same code base

  • API proxy example setup: develop and debug faster using any remote server

  • Generator output customization: with the provided add-on support, start multiple projects even faster by plugging in additions that fit your needs, such as your enterprise theme, SSO authentication, services integrations...

And there's even more! See What's in the box for more details.

Getting started

Using ngX-Rocket CLI

  1. Install required tools:
npm install -g generator-ngx-rocket
  1. Create your application:
ngx new

πŸ’‘ Pro tip: the ngx CLI can do more that just bootstrapping new projects! You can use it to run your NPM scripts with fuzzy matching (try ngx ci for example) or help you maintaining your project up-to-date. Take a look at the full documentation!

Project structure

The structure follows Angular style guide.

dist/                        app production build
docs/                        project docs and coding guides
e2e/                         end-to-end tests
src/                         project source code
|- app/                      app components
|  |- @core/                 core module (singleton services and single-use components)
|  |- @shared/               shared module  (common components, directives and pipes)
|  |- app.component.*        app root component (shell)
|  |- app.module.ts          app root module definition
|  |- app-routing.module.ts  app routes
|  +- ...                    additional modules and components
|- assets/                   app assets (images, fonts, sounds...)
|- environments/             values for various build environments
|- theme/                    app global scss variables and theme
|- translations/             translations files
|- index.html                html entry point
|- main.scss                 global style entry point
|- main.ts                   app entry point
|- polyfills.ts              polyfills needed by Angular
+- test.ts                   unit tests entry point
reports/                     test and coverage reports
proxy.conf.js                backend proxy configuration

Main tasks

Task automation is based on NPM scripts.

Task Description
npm start Run development server on http://localhost:4200/
npm run serve:sw Run test server on http://localhost:4200/ with service worker enabled
npm run build [-- --configuration=production] Lint code and build web app for production (with AOT) in dist/
npm test Run unit tests via Karma or Jest in watch mode
npm run test:ci Lint code and run unit tests once for continuous integration
npm run e2e Run e2e tests using Protractor
npm run lint Lint code
npm run translations:extract Extract strings from code and templates to src/app/translations/template.json
npm run docs Display project documentation

Additional tasks for Cordova-based projects:

Task Description
npm run cordova:prepare Prepare for building mobile app (restore Cordova platforms and plugins)
npm run cordova:run <ios/android> [--device] Run app on target platform device or simulator
npm run cordova:build [-- --configuration=production] Build mobile app for production in dist/ folder
npm run cordova:clean Removes www/, platforms/ and plugins/ folders

Additional tasks for Electron-based projects:

Task Description
npm run electron:build Build desktop app
npm run electron:run Run app on electron
npm run electron:package Package app for all supported platforms

When building the application, you can specify the target configuration using the additional flag --configuration <name> (do not forget to prepend -- to pass arguments to npm scripts).

The default build configuration is production.

Development server

Run npm start for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files. You should not use ng serve directly, as it does not use the backend proxy configuration by default.

Code scaffolding

Run npm run generate -- component <name> to generate a new component. You can also use npm run generate -- directive|pipe|service|class|module.

If you have installed angular-cli globally with npm install -g @angular/cli, you can also use the command ng generate directly.

What's in the box

starter kit

The app template is based on HTML5, TypeScript and Sass. The translation files use the common JSON format.

Tools

Development, build and quality processes are based on angular-cli and NPM scripts, which includes:

Progressive Web App (PWA) support provided by @angular/service-worker.

Native mobile application bundling is based on Cordova. Ionic WKWebView is used for iOS for better performance.

Libraries

Coding guides

Other documentation

Generator options

  • --packageManager [npm|yarn]: specify whether to use Yarn or NPM as your package manager (default is NPM). You can also use the environment variable NGX_PACKAGE_MANAGER to set this option globally.
  • --automate <json_file>: automate prompt answers using specified JSON file (see here for examples).
  • --addons <addon_name> [<addon_name>] ...: space-separated list of add-ons to use.
  • --no-update: do no update existing project (see also updating generated projects).
  • --no-analytics: do not report anonymous usage analytics. You can also use the environment variable NGX_DISABLE_ANALYTICS to set this option globally.
  • --raw: do not use any UI library for templates.
  • --tools: generate only the toolchain, without application template.
  • --location-strategy [hash|path]: location strategy to use in Angular router (default is path).
  • --no-git: do not initialize git repository.
  • --strict: enable all TypeScript strict type checking options.
  • --skip-quickstart: disable quick start message after project generation.
  • --no-prefix: do not add @ prefix to core/shared folders.
  • --deploy <option>: choose automatic deployment option. Use ngx n --deploy to see possible values.

When generating a fullstack project (with both client and server code), you can use the environment variables NGX_CLIENT_PATH and NGX_SERVER_PATH to customize the paths for client and server code. Be aware though that some add-ons may force specific paths that will preempt your changes.

Updating generated projects

As new features and newer libraries and tools are added to the generator, you may want to update your project at some point. Here is how we suggest you to do it:

  1. Make sure your working directory is clean (no pending / uncommited changes).
  2. Run ngx update using the CLI inside your project folder.
  3. The generator will then run again using the same options you used initially, prompting you for each file change. From there the recommended approach is simply to overwrite everything.
  4. Finally, use your source control to see the diff for each file and merge the changes manually.

Note: you can use the --tools option to generate only the toolchain and not application templates, thus reducing the number of changes to merge.

Customize project generation

You can customize the generator output to change or enhance it to better suit your needs using add-ons.

To create a new add-on, you can use the addon sub-generator of the CLI:

ngx new --addon

See the add-on generator documentation for more information about add-on creation.

Contributing

First time contributors are welcome in this project! πŸŽ‰

To get started, take a look at the contributing guide. If you want to help and don't know what you can do, look for good first contribution issues, or if you're a seasoned OSS contributor look for PR welcome tags.

Thanks for helping ❀️

License

MIT

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].