Search packages, repositories and app categories

Package detailsv4.0.9

localregex

Collection of regex patterns commonly used in Zimbabwe. Regex patterns include mobile numbers, passports, vehicle license plates, driver's license, email addresses and passwords

AndroidiOSWebmacOSWindowsLinux
30-day downloads
192
Likes
22
Pub points
150

Install package

flutter pub add localregex

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

LocalRegex is a Flutter package providing pre-defined regular expressions tailored for common data validation in Zimbabwe. It includes patterns for mobile numbers, passports, vehicle license plates, driver's licenses, email addresses, and passwords. Designed for developers building apps targeting Zimbabwean users, it simplifies input validation with accurate, locally relevant regex rules. The package supports multiple platforms including Android, iOS, Web, macOS, Windows, and Linux, ensuring consistent validation across environments.

Use cases

  • Validating Zimbabwean mobile numbers
  • Verifying passport numbers
  • Checking vehicle license plate formats
  • Validating driver's license details
  • Email and password input validation
  • Form validation in local applications

Key features

  • Zimbabwe-specific regex patterns
  • Support for multiple input types
  • Cross-platform compatibility
  • Easy integration via pub
  • Pre-tested and reliable patterns
  • Lightweight and focused

Suitable for

  • Mobile and web apps for Zimbabwe
  • Government or ID verification systems
  • User registration forms
  • Data collection tools in local contexts
  • Apps requiring accurate local formatting

Considerations

  • Limited to Zimbabwean standards
  • Requires manual updates for new formats
  • Not suitable for international use
  • Depends on external source for maintenance
  • No built-in UI components
  • Validation logic must be implemented by the developer

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

LocalRegex

style: very good analysis License: MIT Coverage

This plugin allows developers to check if an input matches common regex patterns in Zimbabwe and other countries. This plugin works for all Flutter supported platforms i.e. Android, iOS, Web and Desktop (Linux, Windows & MacOS).

Developed by Ngonidzashe Mangudya. Special shoutout to Kudakwashe Kuzvindiwana & Donald Chinhuru for pushing this package the most.

Usage

Add dependency
dependencies:
  localregex: <version>
Or
flutter pub add localregex
Import package
  import 'package:localregex/localregex.dart';

Note that declaration and initialization is no longer necessary

Check if a mobile number matches patterns for Econet, Netone or Telecel numbers
LocalRegex.isNetone('mobile_number');
LocalRegex.isEconet('mobile_number');
LocalRegex.isTelecel('mobile_number');
Check if a mobile number matches any of the patterns for Econet, Netone or Telecel
LocalRegex.isZimMobile('mobile_number');
Check if mobile number is valid (recommended for numbers not from Zimbabwe)
LocalRegex.isValidMobile('mobile_number');
Check if Zimbabwean landline number is valid
LocalRegex.isZimLandline('landline_number');
Check if a supplied email matches proper email patterns
LocalRegex.isEmail('email_address');
Check if a supplied national id matches the pattern for Zimbabwean national id
LocalRegex.isZimID('national_id');
Check passport number
LocalRegex.isZimPassport('passport_number');
Check number plate
LocalRegex.isZimNumberPlate('number_plate');
Check driver's license
LocalRegex.isZimDriversLicence('drivers_license');
Check URL
LocalRegex.isUrl("https://www.google.com");
Check phone number and returns phone number in required format (for use with Zim numbers only)
String? number = '+263777213388'.formatNumber(formatType: FormatType.regular);
Check if password is valid (minimum of 8 characters, at least 1 special character, 1 capital letter, 1 numeric character)
LocalRegex.isPassword('your_password');

Mobile Number Format Types

Regular

This is the general format of mobile numbers e.g. 0777213388

FormatType.regular
Country Code

This is the mobile number format with country code but no + sign e.g. 263777213388

FormatType.countryCode
Country Code Plus

This is the mobile number format with country code and + sign e.g. +263777213388

FormatType.countryCodePlus

Format National ID

Here the output format to be used is 11-223344 K 55 as found on most national identity documents in Zimbabwe

'11223344K55'.formatID(formatType: IdFormatType.proper); // > 11-223344 K 55

School Student IDs

You can validate Student IDs for multiple tertiary institutions in Zimbabwe.

LocalSchools.hit.isStudent('studentID')

Contributors


Ngonidzashe Mangudya

Kudakwashe Kuzvindiwana

Donald Chinhuru
Add your contributions

Categories

Source repository

Projects using this package