Codemelli Generator & Validator 🚀

A React-based web application to generate and validate Fake Iranian National Codes (Code Melli). Create valid 10-digit کد ملی or verify their authenticity with a user-friendly interface. Built with TypeScript, Tailwind CSS, and Vite for a fast and type-safe experience.

🌐 Live Demo

Try the Fake Codemelli generator and validator online: https://codemelli.vercel.app/

📋 Features

• ✅ Generate Fake Code Melli: Create valid 10-digit کد ملی based on selected province and city codes.
• 🔍 Verify Codemelli: Validate a Code Melli using the official Iranian checksum algorithm.
• 📋 Copy to Clipboard: Easily copy generated Fake کد ملی to the clipboard with one click.
• 🕒 History of Copied Codes: Store and view a history of copied Codemelli in local storage.
• 📍 Province & City Selection: Choose from a list of Iranian provinces and cities to generate accurate Code Melli.
• 📱 Responsive Design: Modern and clean UI with light/dark mode support for all Code Melli tools.
• 🛡️ Type-Safe: Fully typed with TypeScript for robust کد ملی generation and validation.

🛠️ Tech Stack

• Frontend: React, TypeScript
• Styling: Tailwind CSS
• Build Tool: Vite
• Icons: Lucide React
• State Management: React Hooks
• Storage: 📦 Local Storage
• Package Manager: 📦 pnpm

🚀 Getting Started

Prerequisites

• Node.js (v16 or higher)
• pnpm (install globally with npm install -g pnpm)

Installation

1. Clone the repository:

   git clone https://github.com/your-username/codemelli.git
   cd codemelli

2. Install dependencies:

   pnpm install

3. Start the development server:

   pnpm dev

4. Open http://localhost:5173 in your browser.

📖 Usage

• Generate Fake کد ملی: Select a province and city, then click "تولید کد ملی" to create a new Code Melli.
• Verify Code Melli: Enter a 10-digit Codemelli in the "Check Code Melli" section to verify its validity.
• Copy Codemelli: Click "Copy to Clipboard" to copy Fake کد ملی for use elsewhere.
• View History: Click the "History" button to see previously copied Code Melli stored in local storage.

🤝 Contributing

Contributions to improve Fake Codemelli tools are welcome! 🙌 Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature).
3. Commit your changes (git commit -m 'Add your feature').
4. Push to the branch (git push origin feature/your-feature).
5. Open a Pull Request! 🌟

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.

🙏 Acknowledgements

• 🌍 Inspired by the need for a simple tool to generate and validate Fake Iranian Code Melli.
• 🙌 Thanks to the open-source community for libraries like React, Tailwind CSS, and Lucide React.