Skip to content

Powerful Indian utility package for Flutter – validate & format PAN, Aadhaar, GSTIN, IFSC, mobile, vehicle numbers, currency, pincode, and more with zero dependencies. Built for Indian app localization, banking, and fintech projects.

License

Notifications You must be signed in to change notification settings

Mrhanji/flutter_indian_utils

Repository files navigation

flutter_indian_utils

pub package License: MIT

A comprehensive utility package for Indian developers. Includes validators, formatters, and converters specifically designed for Indian formats like PAN, Aadhaar, GSTIN, mobile numbers, currency, and more.

Features

✅ Validators

  • PAN - Permanent Account Number validation
  • Aadhaar - Aadhaar number validation
  • GSTIN - GST Identification Number validation
  • IFSC - Bank IFSC code validation
  • Mobile - Indian mobile number validation
  • Vehicle Number - Indian vehicle registration number validation
  • Pincode - 6-digit pincode validation
  • Landline - Indian landline number validation

🎨 Formatters

  • Currency - Indian currency formatting (₹1,50,000.00)
  • Mobile - Format mobile numbers (+91 98765 43210)
  • Date/Time - Indian date and time formats
  • Vehicle Number - Format vehicle registration (MH-12-AB-1234)
  • PAN/Aadhaar - Format documents with proper separators
  • Number to Words - Convert numbers to Indian numbering words (Lakh, Crore)
  • Amount to Words - Convert currency to words (Rupees and Paise)

📍 Constants

  • States - All Indian states and union territories
  • State Codes - Map between state codes and names

Installation

Add this to your package's pubspec.yaml file:

Supported Formats

Type Format Example
PAN 5 letters + 4 digits + 1 letter ABCDE1234F
Aadhaar 12 digits (with spaces) 1234 5678 9012
GSTIN 15 characters 22AAAAA0000A1Z5
IFSC 4 letters + 0 + 6 alphanumeric SBIN0001234
Mobile 10 digits starting with 6-9 9876543210
Vehicle State + District + Series + Number MH-12-AB-1234
Currency Indian numbering (Lakh, Crore) ₹1,50,000.00
Pincode 6 digits 400001

Why flutter_indian_utils?

  • 100% Test Coverage - All validators and formatters thoroughly tested
  • 🚀 Zero Dependencies - Lightweight with no external dependencies
  • 📱 Production Ready - Used in real-world applications
  • 🇮🇳 India-Specific - Built specifically for Indian formats and requirements
  • 📖 Well Documented - Clear examples and comprehensive documentation
  • 🔧 Easy to Use - Simple, intuitive API design

Contributing

Contributions are welcome! Here's how you can help:

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

Issues and Feedback

Found a bug or have a feature request? Please open an issue on GitHub.

License

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

Changelog

See CHANGELOG.md for a list of changes.


👤 About the Author

Sagar Sharma - Flutter Developer & Open Source Contributor

I'm a passionate Flutter developer specializing in cross-platform mobile development and Android device management. I love building tools that make developers' lives easier.

Connect with me:

If you found this package helpful, please consider:

  • ⭐ Starring the GitHub repository
  • 👍 Liking the package on pub.dev
  • 🤝 Connecting with me on LinkedIn
  • 📢 Sharing with other developers

Other Projects:

  • More Flutter packages coming soon!
  • Check out my GitHub for other interesting projects

Support

If you find this package useful, please give it a ⭐ on GitHub!

For questions or support, feel free to:

Made with ❤️ in India 🇮🇳

About

Powerful Indian utility package for Flutter – validate & format PAN, Aadhaar, GSTIN, IFSC, mobile, vehicle numbers, currency, pincode, and more with zero dependencies. Built for Indian app localization, banking, and fintech projects.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages