ngx-pwd-strength/README.md

Angular Package, that measure password strength and indicate how secure is it

# NgxPwdStrength

Estimate the strength of the password using [zxcvbn](https://github.com/dropbox/zxcvbn), and display a visual password strength bar
and feedback with suggestions and warning messages to help choose better passwords.

[Live Demo](https://el-abdel.github.io/ngx-pwd-strength/)

## Installation

Install [zxcvbn](https://github.com/dropbox/zxcvbn) (as the lib depends on) and `NgxPwdStrength` via npm:

```sh
npm install zxcvbn3 ngx-pwd-strength --save
```

## Configuration

Import NgxPwdStrength Module into the app module

```ts
import {APP_INITIALIZER, NgModule} from '@angular/core';
import {NgxPwdStrengthModule, NgxPwdStrengthService} from "ngx-pwd-strength";

// By default feedback is enabled, use this config to disable it
function initializePwdStrength(pwdStrength: NgxPwdStrengthService) {
  return () =>
    pwdStrength.init({
      enableFeedback: false
    });
}

@NgModule({

    imports: [
      NgxPwdStrengthModule
    ],
       providers: [
         {
           provide: APP_INITIALIZER,
           useFactory: initializePwdStrength,
           multi: true,
           deps: [NgxPwdStrengthService]
         }
       ]

})
export class AppModule { }
```

## Usage

Add `ngxPwdStrength` directive to inputs of type = password

```html
<input type="password" ngxPwdStrength name="password" placeholder="Password">
```