Code melli Generator

Codemelli Generator & Validator is a comprehensive React-based web application specifically designed for generating and validating fake Iranian National Codes (known as Code Melli or کد ملی). This tool addresses the need for creating valid 10-digit codes that mimic real Iranian national IDs while adhering to the official checksum algorithm used by Iranian authorities. It features a clean, intuitive user interface that allows users to select provinces and cities for more accurate code generation, ensuring the codes are contextually relevant. Beyond generation, the app includes robust validation capabilities to check the authenticity of any provided Code Melli. Additional utilities enhance usability, such as one-click copying to the clipboard and persistent history tracking via local storage, making it ideal for developers, testers, or anyone needing placeholder national codes in a non-production environment. The application emphasizes type safety, responsive design, and theme support (light/dark mode), providing a modern and accessible experience across devices. This project not only demonstrates proficiency in frontend development but also highlights practical problem-solving for region-specific data handling.

Technologies: React, TypeScript, Tailwind CSS, Vite, Lucide React icons, React Hooks for state management, Local Storage for data persistence, pnpm as package manager.

Key Features:

• Generate fake Code Melli based on selected Iranian provinces and cities.
• Validate Code Melli using the official Iranian checksum algorithm.
• One-click copy to clipboard for generated codes.
• History tracking of copied codes stored in local storage.
• Province and city selection dropdowns for precise code generation.
• Fully responsive design with light/dark mode support.
• Type-safe implementation with TypeScript for reliability.