Skip to content

Unified framework for validating Egyptian National IDs with multiple language implementations (Python, Java, JavaScript, etc.)

Notifications You must be signed in to change notification settings

MohamedAAbdallah/Egyptian-ID-Validator

Repository files navigation

Egyptian ID Validator

A language-agnostic, open-source initiative for validating Egyptian National ID numbers across multiple programming environments.


πŸ” Purpose

This repository serves as the central hub for all platform-specific Egyptian ID validation libraries.
Each implementation adheres to a shared validation specification, enabling developers to integrate robust ID parsing and verification into web, mobile, backend, and embedded systems.


βœ… Implementations

Language Repository Status
Python Egyptian-ID-Validator-Py βœ… Complete
JavaScript Egyptian-ID-Validator-Npm βœ… Complete
Java Egyptian-ID-Validator-Java βœ… Complete
C# (.NET) Egyptian-ID-Validator-DotNet πŸ”„ Planned
PHP Egyptian-ID-Validator-PHP πŸ”„ Planned
Dart Egyptian-ID-Validator-Dart πŸ”„ Planned
Go Egyptian-ID-Validator-Go πŸ”„ Planned

πŸ“Œ Naming conventions follow the pattern Egyptian-ID-Validator-<Platform>


πŸ“¦ Shared Specification

Each implementation supports:

  • βœ… Format validation (14-digit structure)
  • βœ… Gender and birthdate parsing
  • βœ… Governorate code decoding
  • βœ… Official checksum verification

All logic follows the Egyptian Ministry of Interior standards.
The checksum mechanism is verified but not publicly disclosed.


🧭 Getting Started

Start with a complete implementation like:

Want to contribute to a new language? Check CONTRIBUTING.md (coming soon) or open an issue to get started.


πŸ‘€ Author

Created and maintained by Mohamed A. Abdallah

About

Unified framework for validating Egyptian National IDs with multiple language implementations (Python, Java, JavaScript, etc.)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published