@ebdev/ngx-smart-validators

Comprehensive, tree-shakeable validation for Angular 17–22. It supports reactive forms and template-driven forms, ships readable error messages, and has no setup requirement for the free validator set.

Install

npm install @ebdev/ngx-smart-validators

Reactive forms

import { FormControl, FormGroup } from '@angular/forms';
import {
  matchFields,
  password,
  phone,
  requiredTrimmed,
  strictEmail,
} from '@ebdev/ngx-smart-validators';

readonly form = new FormGroup(
  {
    email: new FormControl('', [requiredTrimmed(), strictEmail()]),
    phone: new FormControl('', [phone('IL')]),
    password: new FormControl('', [password({ minLength: 10, special: true })]),
    confirmPassword: new FormControl(''),
  },
  { validators: matchFields('password', 'confirmPassword') },
);

Validators intentionally ignore empty values unless they enforce requiredness, so they compose cleanly with Angular's Validators.required.

Template-driven forms

Import individual standalone directives, or NGV_DIRECTIVES:

@Component({
  standalone: true,
  imports: [FormsModule, NGV_DIRECTIVES, NgvMessagePipe],
})
export class ProfileComponent {}

<input name="email" [(ngModel)]="email" ngvRequiredTrimmed ngvStrictEmail
       #emailModel="ngModel">
<small>{{ emailModel.errors | ngvMessage }}</small>

Configure messages and a Pro license

import { ApplicationConfig } from '@angular/core';
import { provideSmartValidators } from '@ebdev/ngx-smart-validators';

export const appConfig: ApplicationConfig = {
  providers: [
    provideSmartValidators({
      licenseKey: environment.smartValidatorsLicense,
      messages: { strictEmail: 'Enter a work email address.' },
    }),
  ],
};

License verification is offline. Signed keys may be restricted by hostname and expiry date; local development hosts always work. An invalid or expired key falls back to the free tier without breaking the form.

Validator catalog

Free

• Basics: requiredTrimmed, range, number, integer, decimal, greaterThan, lessThan, alpha, alphanumeric, noWhitespace
• Strings: regex, startsWith, endsWith, includes, url, strictEmail
• Dates: validDate, minDate, maxDate, pastDate, futureDate
• Formats: phone, uuid, json, base64, hexColor, ipAddress, latitude, longitude
• Groups and utilities: matchFields, withMessage

Pro

• Configurable password rule engine
• creditCard with Luhn checking and card-brand detection, and iban
• minAge and maxAge
• dateRange, requiredIf, atLeastOne, and allOrNone
• Accurate international phoneNumber from @ebdev/ngx-smart-validators/phone

Install libphonenumber-js when using the optional phone entry point:

npm install libphonenumber-js

import { phoneNumber } from '@ebdev/ngx-smart-validators/phone';

Error shape

Every validator returns Angular ValidationErrors using a predictable object:

{
  minDate: {
    actual: '2025-01-01',
    min: '2026-01-01',
    message: 'Date must be on or after 2026-01-01.'
  }
}

Use withMessage(validator, 'Custom message') for one control, or configure global messages with provideSmartValidators.

Compatibility

| Package | Supported Angular | | --- | --- | | @ebdev/ngx-smart-validators 0.x | 17, 18, 19, 20, 21, 22 |

The package is published in Angular partial-Ivy format.

License

The free tier may be used in commercial applications. Pro validators require a purchased signed key. See the bundled license agreement for complete terms.