https://github.com/pooyasamimi/codemelli
Generate and validate fake Iranian National Codes (Code Melli, کد ملی,fakecodemelli, ساخت کد ملی فیک) with a React and TypeScript web app. Features include Codemelli generation, verification, clipboard copy, and history tracking.
https://github.com/pooyasamimi/codemelli
code-melli codemelli fake-national-code iranian-national-code pnpm react tailwindcss typescript vite
Last synced: 3 months ago
JSON representation
Generate and validate fake Iranian National Codes (Code Melli, کد ملی,fakecodemelli, ساخت کد ملی فیک) with a React and TypeScript web app. Features include Codemelli generation, verification, clipboard copy, and history tracking.
- Host: GitHub
- URL: https://github.com/pooyasamimi/codemelli
- Owner: pooyasamimi
- Created: 2025-06-03T19:46:53.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-06T14:08:53.000Z (about 1 year ago)
- Last Synced: 2025-07-04T14:11:32.935Z (about 1 year ago)
- Topics: code-melli, codemelli, fake-national-code, iranian-national-code, pnpm, react, tailwindcss, typescript, vite
- Language: JavaScript
- Homepage: https://codemelli.vercel.app
- Size: 8.61 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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/](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:
```bash
git clone https://github.com/your-username/codemelli.git
cd codemelli
```
2. Install dependencies:
```bash
pnpm install
```
3. Start the development server:
```bash
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](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.