Have ideas to improve npm?Join in the discussion! »

    schematics-admin-test

    0.0.1 • Public • Published

    Angular Schematics for Productivity and Consistency

    Developing large-scale web-applications is hard, and without a lot of experience building large Angular applications, it's very easy to make an architectural or structural mistake that could cost your team a lot of money and time to fix down the road once that mistake is realized.

    The schematics in this library will help your team develop Angular applications that are consistent and have an architecture/folder structure that will scale for extremely large projects right from the get-go.

    The output of these schematics is based on many years of experience building large-scale projects in Angular, and have been used in applications that contain several hundred-thousand lines of code. Thus, the opinions and ideas behind these schematics have been battle-tested and proved to prevent and solve scalability problems many people run into when building large-scale Angular projects.

    Installation

    To add these schematics to your angular-cli project, type the following in the console at the root of your project:

    npm install @egervari/schematics-angular --save-dev

    To run schematics from your console, also add the following global npm library:

    npm install -g @angular-devkit/schematics-cli

    Using Schematics Via Console

    Adding prettier and overwriting TSLint and Prettier rules

    To add prettier (if you currently don't have it installed) and use Rangle's preferred starting point for TSLint and Prettier rules, run the following schematic from your console:

    schematics @egervari/schematics-angular:tslint-and-prettier

    Running this schematic will also create a bunch of scripts to conveniently check and fix your project so you don't have to add them yourself.

    You should see the following updates to your project:

        Added "prettier" into devDependencies
        Added "tslint-config-prettier" into devDependencies
    CREATE /prettier.config.js (173 bytes)
    UPDATE /tslint.json (869 bytes)
    UPDATE /package.json (2552 bytes)

    Creating Features

    To create a feature module containing components, routes, services, types and isolated ngrx infrastructure, you must specify the feature's name, path and optionally, you can specify your project's component prefix for its selector, but the schematic can often figure this out from your Angular project workspace.

    schematics @egervari/schematics-angular:feature --name=my-feature --path=src/app --prefix=rng

    If your project currently does not have a /features folder, the schematic will create one for you.

    You should see the following files be created/updated when running this schematic:

    CREATE /src/app/features/my-feature/my-feature-routing.module.ts (370 bytes)
    CREATE /src/app/features/my-feature/my-feature.module.ts (676 bytes)
    CREATE /src/app/features/my-feature/components/my-feature/my-feature.component.html (0 bytes)
    CREATE /src/app/features/my-feature/components/my-feature/my-feature.component.scss (12 bytes)
    CREATE /src/app/features/my-feature/components/my-feature/my-feature.component.ts (224 bytes)
    CREATE /src/app/features/my-feature/components/index.ts (52 bytes)
    CREATE /src/app/features/my-feature/services/my-feature.service.ts (200 bytes)
    CREATE /src/app/features/my-feature/store/my-feature.actions.ts (239 bytes)
    CREATE /src/app/features/my-feature/store/my-feature.effects.ts (453 bytes)
    CREATE /src/app/features/my-feature/store/my-feature.reducer.ts (560 bytes)
    CREATE /src/app/features/my-feature/store/my-feature.store.ts (305 bytes)
    CREATE /src/app/features/my-feature/types/my-feature-state/my-feature-state.functions.spec.ts (419 bytes)
    CREATE /src/app/features/my-feature/types/my-feature-state/my-feature-state.functions.ts (158 bytes)
    CREATE /src/app/features/my-feature/types/my-feature-state/my-feature-state.interface.ts (56 bytes)
    UPDATE /src/app/store/app.reducer.ts (543 bytes)
    UPDATE /src/app/types/app-state/app-state.interface.ts (175 bytes)
    UPDATE /src/app/types/app-state/app-state.functions.ts (273 bytes)
    UPDATE /src/app/app-routing.module.ts (355 bytes)

    Creating Modules

    Sometimes you wish to create modules outside of your routes. They are not really features, but reusable pieces of code the rest of the app can share. To create such a module, run the following schematic:

    schematics @egervari/schematics-angular:module --name=my-module --path=src/app

    If your project currently does not have a /modules folder, the schematic will create one for you.

    You should see the following files be created/updated when running this schematic:

    CREATE /src/app/modules/my-module/my-module.module.ts (559 bytes)
    CREATE /src/app/modules/my-module/services/my-module.service.ts (199 bytes)
    CREATE /src/app/modules/my-module/store/my-module.actions.ts (236 bytes)
    CREATE /src/app/modules/my-module/store/my-module.effects.ts (448 bytes)
    CREATE /src/app/modules/my-module/store/my-module.reducer.ts (547 bytes)
    CREATE /src/app/modules/my-module/store/my-module.store.ts (303 bytes)
    CREATE /src/app/modules/my-module/types/my-module-state/my-module-state.functions.spec.ts (410 bytes)
    CREATE /src/app/modules/my-module/types/my-module-state/my-module-state.functions.ts (154 bytes)
    CREATE /src/app/modules/my-module/types/my-module-state/my-module-state.interface.ts (55 bytes)
    UPDATE /src/app/store/app.reducer.ts (660 bytes)
    UPDATE /src/app/types/app-state/app-state.interface.ts (314 bytes)
    UPDATE /src/app/types/app-state/app-state.functions.ts (425 bytes)
    UPDATE /src/app/app.module.ts (768 bytes)

    Creating Components

    Creating components is equally easy - make sure to point the path to the module/feature folder you wish the component to be located:

    schematics @egervari/schematics-angular:component --name=my-form --path=src/app

    If your path currently does not have a /components folder, the schematic will create one for you.

    You should see the following files be created/updated when running this schematic:

    CREATE /src/app/components/my-form/my-form.component.html (0 bytes)
    CREATE /src/app/components/my-form/my-form.component.scss (12 bytes)
    CREATE /src/app/components/my-form/my-form.component.ts (214 bytes)
    UPDATE /src/app/components/index.ts (192 bytes)
    UPDATE /src/app/app.module.ts (2484 bytes)

    Creating Services

    Creates a service and updates the containing module file.

    schematics @egervari/schematics-angular:service --name=my-api --path=src/app

    If your path currently does not have a /services folder, the schematic will create one for you.

    You should see the following files be created/updated when running this schematic:

    CREATE /src/app/services/my-api.service.ts (200 bytes)
    UPDATE /src/app/app.module.ts (2561 bytes)

    Creating Types

    Creates a paired interface and functions file for a given model.

    schematics @egervari/schematics-angular:type --name=user-profile --path=src/app

    If your path currently does not have a /types folder, the schematic will create one for you.

    You should see the following files be created when running this schematic:

    CREATE /src/app/types/user-profile/user-profile.functions.spec.ts (390 bytes)
    CREATE /src/app/types/user-profile/user-profile.functions.ts (146 bytes)
    CREATE /src/app/types/user-profile/user-profile.interface.ts (55 bytes)

    Creating a new project

    The Angular CLI and the default @ngrx schematics do not create folders and files that help developers scale over the long term. Thus, we also provide a schematic to make some adjustments to a newly created Angular CLI project to help you get started on the right foot and to support the other schematics.

    To create a new Angular CLI Project, execute the following commands and you're good to go:

    npm install @angular/cli -g
     
    ng new my-project

    When asked:

    • Say (Y)es to add Angular Routing
    • Select SCSS for your stylesheet format
    cd my-project
     
    ng add @ngrx/store
    ng add @ngrx/effects
     
    npm install @egervari/schematics-angular --save-dev

    And then to correct the default structure, run the initialize schematic with no parameters:

    schematics @egervari/schematics-angular:initialize

    You should see the following changes:

                Added "prettier" into devDependencies
                Added "tslint-config-prettier" into devDependencies
    DELETE /src/app/app.component.html
    DELETE /src/app/app.component.scss
    DELETE /src/app/app.component.ts
    DELETE /src/app/reducers/index.ts
    DELETE /src/app/app.effects.ts
    DELETE /src/app/app.component.spec.ts
    DELETE /src/app/app.effects.spec.ts
    CREATE /prettier.config.js (163 bytes)
    CREATE /src/app/types/app-state/app-state.functions.ts (118 bytes)
    CREATE /src/app/types/app-state/app-state.interface.ts (33 bytes)
    CREATE /src/app/components/index.ts (35 bytes)
    CREATE /src/app/components/app/app.component.html (1173 bytes)
    CREATE /src/app/components/app/app.component.scss (0 bytes)
    CREATE /src/app/components/app/app.component.ts (215 bytes)
    CREATE /src/app/store/app.reducer.ts (403 bytes)
    CREATE /src/app/store/app.effects.ts (180 bytes)
    CREATE /src/app/store/app.store.ts (385 bytes)
    UPDATE /tslint.json (826 bytes)
    UPDATE /package.json (1784 bytes)
    UPDATE /src/app/app.module.ts (740 bytes)

    Where to go from here?

    From here, you can run schematics for creating features to get your project started. For example, to create a landing section for your application, run the following schematic:

    schematics @egervari/schematics-angular:feature --name=landing --path=src/app

    And to create the home, login and forgot-password sections within the landing module, run the following 3 schematics:

    schematics @egervari/schematics-angular:feature --name=home --path=src/app/features/landing
    schematics @egervari/schematics-angular:feature --name=login --path=src/app/features/landing
    schematics @egervari/schematics-angular:feature --name=forgot-password --path=src/app/features/landing

    At this point, take a quick look at your source code and you'll be astounded as to how much manual labour was saved as a result of using these schematics. Everything is modularized and chained together for you, such as your routes, lazy-loading, states, state default values and reducers. Your NgModule's are properly connected. You have clear separation of concerns everywhere.

    And if you're new to Angular and didn't know the right way to begin your first project architecturally, this will put you on the right path to having a great, scalable architecture over the long-term.

    Using Schematics Through WebStorm

    To use schematics in WebStorm, right-click on a folder, select 'New', then select 'Angular Schematic', and then select any schematic from the following list:

    alt text

    For the parameters input, WebStorm will pass many of the options - such as project name and path - on your behalf, so all you have to do is set the name parameter for most schematics and you're all set:

    alt text

    Building and testing

    To build the source code, run:

    npm run build

    After the schematics are built, to run them locally from the project root, run:

    cd dist
    schematics .:feature --name=app --path=src/app

    Linting and Prettier

    To clean up the source code, run:

    npm run fix

    Publishing

    To publish this to npm, run the following commands:

    npm version major/minor/patch
    npm run build
    npm run publish

    Quickly create a patch version

    To quickly create a patch version, instead of going through all of the build and publish commands manually, instead run:

    npm run release-patch

    Install

    npm i schematics-admin-test

    DownloadsWeekly Downloads

    2

    Version

    0.0.1

    License

    MIT

    Unpacked Size

    759 kB

    Total Files

    312

    Last publish

    Collaborators

    • avatar