User Guides

Welcome to the VIO v4 user guides. These guides cover every page and feature across the three main applications in the VIO platform.

Available Guides

Member App Guide

The end-user guide for the VIO Member App. Covers:

Login and registration
Home dashboard and token balances
Exploring and claiming vouchers
Sending, receiving, and claiming tokens
Transaction history
Account settings, profile, security, and notifications

Admin Portal Guide

The administrator guide for managing a tenant. Covers:

Dashboard and key metrics
User management
Token management (types, holders, analytics)
Voucher creation and management
Campaign creation and management
Airdrops and token distribution
Transactions and settlement
Sub-companies, roles, staff, and stores
Branding, settings, and billing

Super Admin Portal Guide

The platform-level administration guide. Covers:

Platform-wide dashboard and statistics
Tenant management and configuration
Navbar and home page customization
Platform-wide user and voucher management
Brand tags and API key management
Settlement reports and tenant billing
Global platform settings

Token Visibility & Access Control

Comprehensive guide for understanding token visibility rules. Covers:

Token visibility types (Private, Shared, Public)
Who can receive tokens based on visibility
Minting and sending permission rules
Forwarding received tokens
Business scenarios and use cases
Complete permission matrix

Cross-Tenant SSO Guide

Technical guide for cross-tenant single sign-on. Covers:

SSO architecture and data models (GlobalIdentity, SSOSession)
User flow: auto-login, account linking, and profile creation
Data isolation guarantees
SSO API endpoints reference
Frontend components (SSOProvider, modals, interceptors)
Configuration (cookie domain, environment variables)
QA test cases (cross-tenant, sub-company vs parent, SSO/UI)

TIP

Each guide includes annotated screenshots for every page, so you can see exactly what to expect.