react-validations-kit

Common validation utilities for React apps. Configurable, lightweight, and supports international formats.

Install

npm install react-validations-kit

Usage

// Named imports
import { isValidEmail, isValidPassword, isValidPhoneNumber } from 'react-validations-kit';

isValidEmail('[email protected]');                          // true
isValidPassword('Passw0rd');                               // true
isValidPassword('mypass', { minLength: 6, requireUppercase: false, requireNumber: false }); // true
isValidPhoneNumber('+44 7911 123456');                     // true

// Default import
import validations from 'react-validations-kit';

validations.isValidName('José');                           // true
validations.isValidZipCode('SW1A 1AA', { country: 'UK' }); // true

API

isValidEmail(email)

Validates email format.

isValidPassword(password, options?)

Configurable password validation.

| Option | Type | Default | Description | |---|---|---|---| | minLength | number | 8 | Minimum length | | requireUppercase | boolean | true | Require uppercase letter | | requireLowercase | boolean | true | Require lowercase letter | | requireNumber | boolean | true | Require a digit | | requireSpecialChar | boolean | false | Require a special character |

isValidSimplePassword(password, minLength?)

Convenience wrapper — checks minimum length only (default: 6).

isValidResetPassword(password)

Convenience wrapper — 8+ chars, uppercase + lowercase required.

isValidPhoneNumber(phone, options?)

Validates phone number digit count.

| Option | Type | Default | Description | |---|---|---|---| | minDigits | number | 7 | Minimum digit count | | maxDigits | number | 15 | Maximum digit count (ITU E.164) |

isValidUsername(username, options?)

Alphanumeric, underscore, and hyphen.

| Option | Type | Default | Description | |---|---|---|---| | minLength | number | 3 | Minimum length | | maxLength | number | 20 | Maximum length |

isValidName(name, options?)

Supports Unicode (accents, diacritics, non-Latin scripts).

| Option | Type | Default | Description | |---|---|---|---| | minLength | number | 2 | Minimum length | | maxLength | number | 50 | Maximum length |

isValidZipCode(zipCode, options?)

Multi-country postal code validation.

| Option | Type | Default | Description | |---|---|---|---| | country | string | 'US' | Country code: US, UK, IN, CA, DE, FR, JP, AU, BR |

isValidURL(url)

Validates URL format.

isEmpty(str)

Checks if string is empty or whitespace only.

isValidAge(dateOfBirth, minAge?)

Checks if age meets minimum (default: 18).

License

MIT