> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frankieone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Why You Should Migrate from SmartUI to OneSDK

## SmartUI Has Reached End of Life

SmartUI was built on deprecated frontend technologies (Vue 2), which reached [official end-of-life <Icon icon="arrow-up-right-from-square" size={12} />](https://v2.vuejs.org/eol/). We’re officially discontinuing Smart UI support and updates effective **December 31, 2024**.

That means:

* No new feature requests will be accepted
* Risks to potential security or browser compatibility issues (no known issue at this point)
* Limited support for new FrankieOne or vendor features
* Gradually increasing maintenance requirements for your team

While FrankieOne will continue to honour existing SmartUI flows, **it will no longer be actively maintained or recommended**. All new features and improvements are released exclusively through OneSDK, ensuring you stay current with the latest capabilities and enhancements..

<Callout icon="bell" color="#FFCA16" iconType="regular">
  Using SmartUI post-EOL may result in browser breakage, degraded UX and pass rates, or failure to support future vendor SDKs.
</Callout>

## Upgrade to OneSDK: A Better, More Flexible Experience

OneSDK is our modern SDK platform that supports both hosted and embedded options. It unlocks features, flexibility, and improved reliability.

| Feature                                                                                                       | SmartUI | OneSDK |
| :------------------------------------------------------------------------------------------------------------ | :------ | :----- |
| Modular Flows                                                                                                 | ❌       | ✅      |
| FrankieOne Hosted Options (No Dev Effort)                                                                     | ❌       | ✅      |
| Link Generation via Portal                                                                                    | ❌       | ✅      |
| Multi-vendor Support                                                                                          | ❌       | ✅      |
| Additional Regional Support                                                                                   | ❌       | ✅      |
| Fraud Detection & Device Risk                                                                                 | ❌       | ✅      |
| Enhanced Branding Options                                                                                     | ❌       | ✅      |
| OCR Autofill Forms                                                                                            | ❌       | ✅      |
| API v2 Compatibility                                                                                          | ❌       | ✅      |
| Upcoming Features, e.g. <br /> Document Upload Module, <br />Risk Assessment Onboarding, <br />KYB Onboarding | ❌       | ✅      |

<Callout icon="thumbtack" color="#1A6CFF" iconType="regular">
  Customers switching to OneSDK typically see **pass rate improvements of \~5%** and a significant reduction in support issues.
</Callout>

## Risks of Staying on SmartUI

While Vue 2 has had few minor known vulnerabilities, **running unsupported frameworks is increasingly seen as a risk by compliance and security teams**, especially if:

* You're shipping with SLAs or under audit
* Your browser support matrix is wide
* You require vendor SDK updates or fraud modules

<Callout icon="thumbtack" color="#1A6CFF" iconType="regular">
   Browsers can break legacy frontend libraries without warning (for example, Shadow DOM changes, deprecated API handling).
</Callout>

## Your Migration Options

### Hosted OneSDK

* FrankieOne builds and hosts the UI with your branding & regional customisation
* Receive a code snippet to drop into your app or redirect to
* Fastest implementation (1–2 weeks to UAT)

### Embedded OneSDK

* Full control over UI and customer experience
* Requires engineering effort (\~4-8 weeks)
* Best for bespoke workflows or native app flows

## Migration is Easier Than You Think

For Hosted Flows:

1. **Select a standard flow** (e.g. IDV only, eKYC+Review)
2. **Branding and configuration** via customisation form or Studio
3. **Receive preview link + UAT access**
4. **Sign off and go live**

<Callout icon="thumbtack" color="#1A6CFF" iconType="regular">
  Migration can be completed in **2-4 weeks** with minimal dev effort.
</Callout>

## FAQs

**Can I keep my current vendor?**
Yes — OneSDK supports both Incode and Onfido (and more). You can even switch between vendors per flow easily.

**Will my config carry over?**
Yes — our team maps your current settings during migration and recreates the required JSON + UI setup. The functionality, look and feel of your implementation will be retained, however, we cannot promise a 1:1 match on UI elements.

**Can I fully customise branding in hosted implementation?**
Yes — logos, colours, messages, and result screens are all customisable in Hosted mode. We will continue to release updates to allow more bespoke experience in our hosted flows.

**How do I decide between hosted vs embedded?**

* Hosted = faster setup, low effort, FrankieOne managed
* Embedded = full control, longer dev time, requires resources
* See hosted vs embedded decision tree below

<img src="https://mintcdn.com/frankieone-f5583b1b/MpEYW70dy4W-choU/images/docs/hosted-vs-embedded-decision-tree.png?fit=max&auto=format&n=MpEYW70dy4W-choU&q=85&s=40ef5de145ccf16f9399511d73e13630" width="4176" height="3642" data-path="images/docs/hosted-vs-embedded-decision-tree.png" />

## What’s Next

* ✅ Book your migration kickoff call
* ✅ Browse sample [OneSDK flows](/docs/hosted-common-use-cases) and decide what suits your users best

## Timeline Overview

| Phase       | Duration                                    |
| :---------- | :------------------------------------------ |
| UAT Setup   | 1–2 weeks                                   |
| UAT Testing | 1-2 weeks for hosted; 4 weeks+ for embedded |
| Go Live     | 1-2 weeks                                   |

Still have questions? Reach out to your CSM or contact us via [support@frankieone.com <Icon icon="arrow-up-right-from-square" size={12} />](mailto:support@frankieone.com)