Frontend Guide

Frontend Developer Guide

The Wallet App is a Progressive Web Application (PWA) built using ReactJS. It can function both as a standalone application and as an embedded iframe inside a parent application.

Key Features:

  • React (JavaScript/TypeScript) based modular architecture

  • Designed to manage and display Verifiable Credentials (VCs)

  • Supports both QR-based credential uploads and sharing credentials with parent apps

  • PostMessage API is used for communication between the embedded iframe and parent

  • Responsive UI suitable for desktop and mobile devices

Embedded Mode:

  • To embed the wallet, set the query param ?embeddedMode=true

  • In embedded mode, the app works inside an iframe and disables navigation features

  • The authentication token (wallet-token) is stored in the local storage

Authentication:

  • Supports username/password login or pre-generated token login

Embed Usage (if applicable): To embed in another app:

<iframe src="https://wallet.yourdomain.com?embeddedMode=true" width="100%" height="600"></iframe>

For additional reference, visit the GitHub repository: https://github.com/PSMRI/ubi-wallet-ui

Last updated