# ID Capture V1 vs V2 Comparison

<br />

In v1, the ID Capture experience begins with a simple tutorial slide followed by a native camera permission request. Once granted, the user enters the capture flow with minimal guidance. Instructions are limited to small tooltip-like titles inside a gray section box, with no dynamic feedback, onboarding messages, or additional support during document alignment.

In v2, the experience introduces a richer and more supportive flow. The tutorial screen includes an animated illustration that sets expectations for the capture process. Camera permission is handled through a dedicated bottom sheet that explains why access is needed before invoking the system dialog. Once in the capture experience, the user sees clear on-screen instructions, supported by a timed guided animation (shown after ~10 seconds, fully configurable) that demonstrates how to properly position their document. Live cues provide real-time textual feedback paired with small illustrations, ensuring users receive immediate guidance when alignment or capture conditions need correction.

<br />

<Image align="center" border={false} caption="In v1, the user moves through a simple two-screen tutorial, receives an immediate system permission pop-up, and enters a basic capture flow with minimal tooltip guidance and no dynamic feedback." src="https://files.readme.io/83e2bc1681a3e0ff63b402708debc167e7463dbc17c8f275d0757979fdeaa811-User_Flow_V1.1.jpg" />

<br />

<Image align="center" border={false} caption="In v2, the experience is more guided: the user sees an animated tutorial, a dedicated permission bottom sheet explaining why access is needed, a clearer capture screen with strong instructions, automatic capture with on-screen cues, an analyzing step, and a polished success screen confirming the document was processed." src="https://files.readme.io/766ebdfab75b42057c3ac689339bca9ecb9cff90a93c0a8d4edaed28f328b363-User_Flow_V2.1.jpg" />

<br />

***

<br />

## Feature Comparison

Functional capabilities of the module (objective features only; no UX or performance differences).

<br />

| **Capability**                   | **V1**                         | **V2**                              | **Notes**                                                                                         |
| -------------------------------- | ------------------------------ | ----------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Auto-capture**                 | ✔️                             | ✔️ (improved)                       | V2 introduces faster, more reliable detection for automatic capture.                              |
| **Supported document types**     | ID, DL, Passport, PoA          | Expanded (incl. barcode scanning)   | V2 adds barcode scanning capabilities.                                                            |
| **Guidance timer**               | ✖️                             | ✔️                                  | V2 supports configurable timed guidance (e.g., animation after 10s).                              |
| **Dynamic live cues**            | ✖️                             | ✔️                                  | V2 includes real-time textual + illustrated feedback; V1 shows static tooltips only.              |
| **Permission flow behavior**     | Direct native permission popup | Pre-permission logic + native popup | V2 introduces an intermediate step explaining why permission is required (behavioral difference). |
| **Customization options**        | Limited                        | Full customization                  | V2 allows full control over text, colors, buttons, illustrations, and behavior.                   |
| **Documentation completeness**   | Minimal (key screens only)     | Full module documentation           | V2 provides complete, standardized documentation coverage.                                        |
| **Error states**                 | Basic                          | Basic (no new logic)                | Error handling behavior remains the same between versions.                                        |
| **Developer events / callbacks** | Unchanged                      | Unchanged (no confirmed additions)  | No known new callbacks or event changes in V2.                                                    |

<br />

***

<br />

## Behavior Differences

How the module behaves during runtime.

| **Behavior**                     | **V1**                                                   | **V2**                                                      | **Notes**                                                                 |
| -------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------- |
| **Tutorial behavior**            | Static slides with minimal instruction                   | Animated tutorial explaining the process                    | V2 sets clearer expectations and prepares user for capture flow.          |
| **Permission flow logic**        | Immediate native popup is triggered                      | Pre-permission bottom sheet shown before native popup       | V2 introduces an explanatory step to reduce permission drop-off.          |
| **In-capture guidance**          | Only short static tooltips inside gray area              | Continuous, clear instructions displayed on screen          | V2 actively guides the user instead of relying on passive hints.          |
| **Timed guidance behavior**      | None                                                     | After ~10s (configurable), a guided animation appears       | Helps users correctly position their ID if they struggle initially.       |
| **Live feedback cues**           | None (no dynamic feedback)                               | Real-time textual messages paired with small illustrations  | V2 helps users correct issues such as misalignment or framing.            |
| **Behavior during auto-capture** | Basic auto-capture triggers with limited feedback        | Improved auto-capture with alignment detection and feedback | V2 provides more consistent capture results with clearer state awareness. |
| **Post-capture flow**            | Immediate capture with no intermediate processing screen | Shows “Taking photo…” → “Analyzing…” → success confirmation | V2 communicates system activity, reducing uncertainty.                    |
| **End-of-flow behavior**         | Camera simply closes or proceeds silently                | Explicit success screen with next-step guidance             | V2 provides clarity, especially for multi-step document capture.          |

<br />

***

<br />

<br />

## Performance Improvements

Differences in efficiency, speed, stability, and quality of output.

<br />

***

<br />

## **Customization Overview**

Customization in V2 is significantly simpler and more consistent across modules.

<Image align="center" border={false} caption="Incode Brand" src="https://files.readme.io/d0a34751e410f013a2792619050494f65e5bf843cb1cb421a773bd2e8c9a4da5-Customiation.jpg" />

<Image align="center" border={false} caption="Your Brand" src="https://files.readme.io/efed14b6ed0054f6bebb04cca1408991a389be645e2084f9e32cab609b1acde6-Customiation-1.jpg" />

<br />

Instead of having isolated configuration options per screen or component, V2 uses a unified token-based system that allows developers to control visuals, behaviors, and experience patterns with fewer parameters and predictable outcomes.

This means:

* Less engineering work to override UI elements
* Consistent branding across modules
* Predictable behavior when changing settings
* Reduced risk of breaking flows
* Clear separation between visual tokens and experience configuration

V2 also centralizes all customization options under a single structure, so developers always know where to look and what they can modify.

**For full details, visit the Customization tab of this module.**

<br />

<br />