Aadhaar-Verifier

A lightweight, dependency-free npm package to validate Indian Aadhaar numbers using the Verhoeff checksum algorithm.

This package checks:

Correct 12-digit numeric format

Valid checksum as per UIDAI specification

❗ This package does NOT verify Aadhaar ownership or check UIDAI databases. It only validates the number mathematically.

📦 Installation npm install aadhaar-validator

or with yarn:

yarn add aadhaar-validator

🚀 Usage ES Module (Recommended) import { isValidAadhaar } from "aadhaar-validator";

console.log(isValidAadhaar("123412341234")); // true or false console.log(isValidAadhaar("111122223333")); // false

CommonJS (if supported in your setup) const { isValidAadhaar } = require("aadhaar-validator");

console.log(isValidAadhaar("123412341234"));

✅ API Reference isValidAadhaar(aadhaar: string): boolean

Validates an Aadhaar number.

Parameters Name Type Description aadhaar string 12-digit Aadhaar number Returns

true → Valid Aadhaar number

false → Invalid Aadhaar number

🧠 How It Works

The Aadhaar number uses the Verhoeff algorithm, a checksum formula designed to detect:

Single-digit errors

Transposition errors

This package implements the official Verhoeff tables to ensure accurate validation.

✨ Features

✔️ Verhoeff checksum validation

✔️ No external dependencies

✔️ Fast & lightweight

✔️ Works in Node.js & modern browsers

✔️ ES Module support

⚠️ Disclaimer

This package only validates the Aadhaar number format and checksum.

It:

❌ Does NOT authenticate a person

❌ Does NOT verify Aadhaar with UIDAI

❌ Should NOT be used as legal proof

Use this package only for input validation purposes.

🛡️ Security & Privacy

No network calls

No data storage

No logging

No Aadhaar data is transmitted or saved

Safe to use in frontend and backend applications.

🧪 Example Use Cases

Form validation

User input verification

Pre-submission checks

Preventing invalid Aadhaar entries

📁 Package Size

Minimal footprint

Zero dependencies

🧩 Compatibility

Node.js 14+

Modern browsers

Works with frameworks like:

Express

NestJS

Next.js

React

Angular

🛠️ Contributing

Contributions are welcome!

Fork the repository

Create a feature branch

Commit your changes

Open a Pull Request

📄 License

MIT License

👨‍💻 Author

Neeraj Pandey

If you find this package helpful, please ⭐ it on GitHub and share it with others.