id_doc_kit #

A lightweight, production-ready Flutter/Dart package for validating Indian ID documents used in KYC, onboarding, and fintech workflows.

Built with a strict core architecture, structured results, and UI-friendly helpers. #

🚀 Live Demo #

Try it out in your browser! 👉 View Live Demo

The demo showcases all supported document types with real-time validation feedback.

✨ Supported Documents #

✅ Aadhaar

✅ PAN

✅ GSTIN

✅ Driving License (strict + fallback)

✅ Voter ID (EPIC)

✅ Passport

✅ PIN Code (India)

✅ Phone Number (India)

✅ Email

This makes id_doc_kit one of the most complete, developer-friendly Indian document validation packages on pub.flutter-io.cn.

✨ Key Features #

• ✅ Structured Validation Results:

IdDocumentResult {
  type,
  rawValue,
  normalizedValue,
  isValid,
  errorCode,
  errorMessage,
  confidence,
  meta
}

🧠 Confidence Score (NEW) #

Each validation result includes a confidence score (0.0 → 1.0) indicating structural certainty.

⚠️ Important: #

Confidence represents structural validation only. This package does NOT verify documents against government databases.

🧩 Metadata (meta) for Advanced Use Cases #

Validators expose parsed data via the meta field.

Example (Driving License):

meta: {
  "stateCode": "KA",
  "stateName": "Karnataka",
  "rto": "01",
  "year": 2021,
  "serial": "0001234",
  "isLegacy": false,
  "isFallback": false
}

🪪 Driving License Validation (Important) #

Driving Licenses are validated in two stages:

1️⃣ Strict Validation (Preferred)

• Validates state/UT code
• RTO range
• Year bounds
• Legacy handling
• Returns confidence = 1.0

2️⃣ Fallback Validation

• Structural format match only
• Used when strict validation fails
• Returns confidence = 0.6
• Clearly marked via meta.isFallback = true

This ensures maximum compatibility with real-world data while maintaining transparency.

🧪 Example Usage #

final result = IdValidator.instance.validate(
  type: IdDocumentType.pan,
  value: 'ABCDE1234F',
);

if (result.isValid && result.confidence >= 0.9) {
  // Safe to proceed
}

🎨 UI-Friendly Widgets #

Quick integration:

IdTextField(
  type: IdDocumentType.pan,
  onValidationChanged: (isValid) {},
);

Full control:

IdField(
  type: IdDocumentType.aadhaar,
  builder: (context, controller, result) {
    return TextField(
      controller: controller,
      decoration: InputDecoration(
        errorText: result?.errorMessage,
      ),
    );
  },
);

🧠 Design Principles #

• No standalone functions
• Single validation entry point
• Strict base architecture
• No backend calls
• No UI assumptions
• Fully testable

📌 Use Cases #

• KYC onboarding
• Fintech apps
• Identity verification
• Form validation
• Government document input

🔐 Disclaimer #

This package performs format and structural validation only. It does not confirm document ownership or authenticity with issuing authorities.

☕ Support & Sponsorship #

If id_doc_kit saves you development time or helps in production, consider supporting its development.

Your support helps maintain accuracy, documentation, and long-term maintenance.