An open API service indexing awesome lists of open source software.

https://github.com/aliezzahn/iranian-nid-validator

An application that validates Iranian National Identification Numbers (کد ملی) for correctness, ensuring they follow the official algorithm and structure.
https://github.com/aliezzahn/iranian-nid-validator

bun nid react rsbuild rust shadcn tailwindcss

Last synced: 2 months ago
JSON representation

An application that validates Iranian National Identification Numbers (کد ملی) for correctness, ensuring they follow the official algorithm and structure.

Awesome Lists containing this project

README

        

# Iranian National ID Validator

## Overview

An application that validates Iranian National Identification Numbers (کد ملی) for correctness, ensuring they follow the official algorithm and structure.

## Features

- Validates Iranian National ID numbers in real-time
- Detects incorrect formats and invalid IDs
- User-friendly interface with instant feedback
- Lightweight and efficient validation process

## Usage

- Enter a 10-digit Iranian National ID.
- The app will validate the input and indicate whether it is valid or not.
- If invalid, it provides relevant error messages.

## Validation Logic

The validation follows these key steps:

1. Ensures the input consists of exactly 10 digits.
2. Applies the official checksum algorithm to verify authenticity.
3. Flags any invalid or incorrectly formatted IDs.

## Contributing

Contributions are welcome! Follow these steps to contribute:

1. Fork the repository.
2. Create a new branch: `git checkout -b feature-name`.
3. Commit your changes: `git commit -m "Add feature"`.
4. Push to the branch: `git push origin feature-name`.
5. Open a Pull Request.

## License

This project is licensed under the [MIT License](LICENSE).

## Contact

For any inquiries or support, please reach out via [[email protected]](mailto:[email protected]).