How to build successful Mini Dapp
Last updated
Last updated
The more the Mini Dapp meets the following requirements during onboarding, the more likely it will be featured in the Dapp Portal and attract more users. Please be sure to adhere to the requirements while developing the Mini Dapp.
Clients must build Mini Dapp wtih two types of LINE and Web version.
LINE version can be built via LIFF SDK. Users can easily access your Mini Dapp through LINE Messenger without install or download application. Also, Users could invite their friends and create wallet with LINE account logged in.
We strongly recommend providing Wallet Connect only when needed, rather than on the initial screen, to reduce the drop rate of users accessing the LINE version. However, since wallet integration may be essential when offering rewards, it would be advisable to place the wallet integration button where it can be easily found.
User Flow : Access Mini Dapp(LIFF) -> Consent Channel -> Add OA -> Play Mini Dapp -> Wallet Connect (at neccessary steop e.g. payment, reward)
Mini Dapp must be build in Web version to users who does not familiar with LINE Messenger. Mini Dapp SDK provides integration of web environment including wallet connection via various social account, Kaia Wallet(Mobile App/Extension) and OKX Wallet.
In the case of the web version, Wallet Connect must be provided on the initial screen for account creation. Wallet Connect does not refer to LINE Login; it refers to wallet integration provided through the Mini Dapp SDK.
User Flow : Access Mini Dapp(Web) -> Wallet Connect -> Play Mini Dapp
The account system of the two versions of the Mini Dapp should operate based on the Wallet Address to ensure account compatibility between the two versions.
When connecting a wallet in the LIFF and Web version, if connection proceeds with Mini Dapp Wallet(LINE) or OKX Wallet, the Wallet Address will be the same across both versions, ensuring account information compatibility. However, the Web version's Mini Dapp Wallet(Kaia Wallet App/Extension and Social logins excluding LINE) cannot be compatible with LIFF's.
For example, User A has created Mini Dapp Wallet via LINE Account 'a' from Web version, It is same with LIFF's if user logged in LINE Messenger with LINE Account 'a'.
Mini Dapp SDK provide payment solution both of Crypto($KAIA) and Fait(STRIPE). To create your revenue model, an in-app item store must be established.
Mini Dapp must provide English and Japanese for users. Other languages can be optional as your target country. Classification user country can be done in several ways. You can either follow the browser or system language settings set by the user or determine the country based on the accessed IP address, and based on this, you should provide the appropriate language.
Point rewards can enhance user loyalty. These points can be used as currency within the Mini Dapp and ultimately support exchanges with tokens issued by the Mini Dapp, providing a sense of economic benefit. This can lead to explosive growth for the Mini Dapp.
It is very important to make users aware of the information about the connected wallet on any screen of your Mini Dapp. Users may enjoy many Mini Dapps and want to connect different wallets for each. By providing intuitive information about which wallet is connected and what the balance is, you can enhance the convenience that leads to payments.
Wallet Type : getWalletType()
Wallet Address : kaia_accounts()
If it does not have connected wallet, use kaia_requestAccounts()
Wallet Balance : kaia_getBalance()
It is very important to inform users about the payment progress status. After starting the payment using the payment creation API, the payment is processed and completed through communication with the payment gateway (PG). If the payment completion and item distribution notifications are not appropriately provided on the user's screen, they may not be able to confirm whether the payment was completed. Once the payment starts, a UI that shows the payment status should be provided during the payment process, and upon receiving the payment completion webhook, the process of distributing the items should be displayed on the payment screen.
If your Mini Dapp is optimized for landscape mode, please ensure that it operates in landscape mode even when the user's device is set to portrait mode. It should also function in landscape mode when the auto-rotate feature is used.
The Dapp Portal provides users with a shortcut to easily access the Mini Dapp on their mobile home screen.
"Add to Home Screen" feature is provided in two ways:
Available on the Mini Dapp detail screen within the Dapp Portal.
Provided by the Mini Dapp (the shortcut URL is provided by the Dapp Portal, and the Mini Dapp will develop a UI to integrate this URL).
Shortcut URL : https://www.dappportal.io/shortcut.html?dappId=dappId®ister=1&&openExternalBrowser=1
*dappId: please find it on your bridge page urls or contact support channel if you don't have.
*register=1: required.
*openExternalBrowser=1: If opening urls from LIFF, it allow ot open in external browser.
